+------------+
| User howto |
+------------+

This software is a Turbo-Pascal like system, with DLL support (.PAK
files). The language is the S language. All the source code is
provided. This software is a freeware, distributed under the
terms of the GNU General Library Public License.

1) SE.EXE

The command-line options into SE.EXE are available with ALT-LETTER.
For example :

- ALT-E goes into the editor ;
- ALT-M changes the compilation mode (memory or disk) ;
- ALT-C to compile the current file ;
- ALT-R to run it ;
- ALT-Q to exit ;
- ENTER for help.

Otherwise, if you enter commands, they are processed as DOS shell
commands. You must have a C:\COMMAND.COM in your filesystem.

You can run SE.EXE with DEBUG (i.e. DEBUG SE.EXE), an put a breakpoint
in your .S source code ("Inline &HCC"). When your .S program reaches
the breakpoint, you get the DEBUG prompt. By removing the breakpoint
and using the "G" DEBUG command, you can restart your program.


2) SED.EXE

SED.EXE is the separate text editor, also included in SE.EXE. Certain
WordStar commands are available, for example block commands. The search
commands are not available.


3) S0.EXE

S0 is the command-line compiler. With S0, you can get .COM DOS files,
and .POS files, which are boot-sector contained executables (very short
executables...).

There are three options :

- C : to get a COM file. E.g. : 's0 hello_c /c', which makes the file
      'hello_c.com' from 'hello_c.s'. It works if the source file is
      --not-- a package. This is the default option ;

- O : To make .PAK files (DLLs). E.g. : 's0 hello /o' makes the object
      file 'hello.pak' ;

- P : To make .POS files.


4) SRUN.EXE

SRUN is the MS-DOS command-line S loader. For example, if you have the
file 'hello.pak', 'srun hello', loads and starts the executable file
'hello.pak'.


5) DIRECTORIES

-      BIN : The executable files ;
- COMPILER : The turbo-pascal source-code of the compiler ;
- EXAMPLES : Some examples.


6) RUNNING THE EXAMPLES

The examples are pre-compiled. To re-compile them, you should enter the
directory "EXAMPLES", then compile the libraries :

C:\EXAMPLES>..\BIN\S0 IO /O
C:\EXAMPLES>..\BIN\S0 ERROR /O
C:\EXAMPLES>..\BIN\S0 KBDCRT /O
C:\EXAMPLES>..\BIN\S0 RUNTIME /O
C:\EXAMPLES>..\BIN\S0 PARTITIO /O
C:\EXAMPLES>..\BIN\S0 DIR /O
C:\EXAMPLES>..\BIN\S0 FILES /O
C:\EXAMPLES>..\BIN\S0 TIMER /O

Then :

C:\EXAMPLES>..\BIN\S0 HELLO /O
C:\EXAMPLES>..\BIN\S0 ASCII3 /O
C:\EXAMPLES>..\BIN\S0 QSORT /O
C:\EXAMPLES>..\BIN\S0 TPAS /O
C:\EXAMPLES>..\BIN\S0 TIMTST1 /O
C:\EXAMPLES>..\BIN\S0 TIMTST2 /O
C:\EXAMPLES>..\BIN\S0 FORM /O
C:\EXAMPLES>..\BIN\S0 PCTOOLS /O
C:\EXAMPLES>..\BIN\S0 PACLIB /O
C:\EXAMPLES>..\BIN\S0 PACMAN /O

To run the HELLO example with SRUN :

C:\EXAMPLES>..\BIN\SRUN HELLO

You can also run the examples directly under SE.EXE. The two examples FORM
and PCTOOLS require a floppy disk previously inserted in the drive A (these
are some kinds of disk explorers).


7) AUTHOR INFORMATION

 Henri LESOURD
180, rue de Rome
13006 MARSEILLE
   FRANCE

e-mail : poff@free.fr
