changeset 39:f17a3dc38f2a

New documentation.
author Matti Hamalainen <ccr@tnsp.org>
date Mon, 24 May 2010 02:41:36 +0300
parents 678924af9149
children 32559c69f6e5
files COMPILING README
diffstat 2 files changed, 78 insertions(+), 11 deletions(-) [+]
line wrap: on
line diff
--- a/COMPILING	Mon May 24 02:19:13 2010 +0300
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,11 +0,0 @@
-Requirements
-============
-
-* A working C compiler (preferably GCC3 or later)
-* Make (GNU Make 3.81 or later works at least)
-* POSIX-ish platform for building (Windows targets
-  can be built via cross-compilation.)
-
-Quick and dirty guide to make it:
-
-Just type make and follow the instructions
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README	Mon May 24 02:41:36 2010 +0300
@@ -0,0 +1,78 @@
+
+   MMmmmmmmMM
+       MM
+    xxxxxxxxxxxx
+    xxxxxxxxxxxxxxxxxxx
+   xxxxxxxxx
+   ZZZZZ....        %%%%%%%%%  %%%        %%%  %%%%%%%%%
+  @@@@......        %%%%%%%%%. %%%....... %%%. %%%%%%%%%....
+  @@@@....o.   .....%%%   %%%  %%%   %%%  %%%  %%%   %%%
+ @@@@@@@....        %%%   %%%  %%%   %%%  %%%  %%%   %%%
+ @@@@@@@@@@@        %%%%  %%%  %%%   %%%  %%%  %%%%  %%%
+ @@@@@@@@@@@@@      %%%%  %%%  %%%   %%%  %%%  %%%%  %%%
+ @@@@@@@@@@@@@@@    %%%%%%%%%  %%%   %%%  %%%  %%%%%%%%%
+  @@@@              %%%%%%%%%  %%%   %%%  %%%  %%%%%%%%%
+  @@@@@@            %%%        %%%%% %%%  %%%  %%%
+  @@@@@@@@@@  xx    %%%        %%%%% %%%  %%%  %%%
+  @@@@@@@@@@@@@@    %%%        %%%%% %%%% %%%  %%%
+   @@@@@@@@@@@      %%%        %%%%% %%%% %%%  %%%
+   @@@@@@@@@   .....%%%....... %%%%%%%%%%%%%%. %%%..........
+     @@@@@          %%%        %%%%%%%%%%%%%%  %%%
+     @@@@
+
+                     libSDL-enhanced pwplib
+
+
+Original pwplib 1.90 and everything else by viznut/pwp
+
+SDL-support, cleanups, bugfixes and new buildsystem by ccr/TNSP^pwp
+
+
+About
+=====
+The product at your fingertips is a cleaned up, slightly fixed
+version of pwplib and everything else that came in pwpunix-1.90
+package. It has been enhanced with libSDL support for video and
+audio.
+
+Why, some may ask -- the reason is simple: most of terminal-based
+output methods provided by original pwplib do not work very well
+in current UNIX systems, and adding support for graphical output
+via libSDL seemed to be the easiest way to fix this.
+
+Additionally sound support via SDL was introduced, and it is
+possible to cross-compile the whole thing for Win32 via MinGW
+hosted on Linux or other UNIX-ish platform.
+
+
+Notice
+======
+By default the SDL target runs in a window of 640x480, but this
+can be changed via commandline parameters. For example:
+
+> peluce xres 1024 yres 768
+
+Or run in full screen:
+
+> peluce xres 1024 yres 768 fs
+
+
+Requirements
+============
+
+* libSDL for the SDL version.
+
+* A working C compiler (preferably GCC3 or later)
+
+* Make (GNU Make 3.81 or later works at least)
+
+* POSIX-ish platform for building. Windows targets
+  can be built via cross-compilation.
+
+Quick and dirty guide to make it:  Just type 'make'
+and follow the instructions.
+
+The Windows cross-compilation targets most likely require
+manual intervention, e.g. editing of the Makefile as this
+has only been tested on one system.
+