$TITLE=A Test "Enhanced" Text File
$AUTHOR=Paul Chattaway
$DATE=May 11th, 1995
$LINES=0
$INDENT=0
$JUSTIFY=0
                    A Test "Enhanced" Text File
                 (Also documentation for TEXTVIEW)

                         by Paul Chattaway

                    |15--= |31NOT FOR DISTRIBUTION |15=--|07

Hello.  This is a test text file for use with my text file viewer.
If you aren't a member of Concrete and you're reading this, you
shouldn't be...  This is a programmer's alpha-test copy only.

                      --- Viewer Commands ---

Being a viewer, and not an editor, TEXTVIEW has only a few simple
easy-to-remember commands:

                      Up Arrow - Go up 1 line
                    Down Arrow - Go down 1 line
                      Page Up - Go up 17 lines
                    Page Down - Go down 17 lines
                    Home - Go to the first line
                     End - Go to the last line
                        Escape - Exit to DOS

                      --- Text File Format ---

Colours may be used by placing a "pipe" symbol (SHIFT-\) followed by
a two digit number in front of the text you want to colour. If the
number of the colour is less than 10, use a zero as the first digit.
Valid numbers are:

   00 - |00Black|07                     08 - |08Dark Grey|07
   01 - |01Blue|07                      09 - |09Bright Blue|07
   02 - |02Green|07                     10 - |10Bright Green|07
   03 - |03Cyan|07                      11 - |11Bright Cyan|07
   04 - |04Red|07                       12 - |12Bright Red|07
   05 - |05Magenta|07                   13 - |13Bright Magenta|07
   06 - |06Brown|07                     14 - |14Yellow|07
   07 - |07Grey|07                      15 - |15White|07

Add 16 to the colour number to make it flash (ex: |28Bright Red|07).

A line may be no longer than 68 characters long (not including
colour control codes).  Lines longer than 68 characters will be
clipped.

As a general rule, text files should be no longer than 468 lines.
However, if you need to load a text file longer than 468 lines, it
can be done (if there is enough memory).  Enter the number of lines
to be loaded (minus the file header) in the $LINES statement in the
header.  The rule-of-thumb to remember here is 140 bytes of memory
per line.  Depending on how much conventional memory is available,
you could load text files up to 3744 lines long (maybe longer...).

Anyway, feel free to play around with the settings, colours, etc.
However, be careful with large text files.  Due to my dynamic array
creation routines, TEXTVIEW gets a little nervous about loading
large files (bigger than 468 lines).  It's only ever frozen on me
once, and that was under Windoze.  But you should still keep an eye
on it...

                     --- File Header Format ---

All text files should have a file header.  If the file doesn't have
a file header, things will still work, but the text viewer may get a
little confused as to what to do in certain areas. Generally, if the
file has a header, it should take the same format as the one found
here:

$TITLE=A Test Text File
$AUTHOR=Paul Chattaway
$DATE=May 11th, 1995
$LINES=0
$INDENT=0
$JUSTIFY=0

The viewer will only scan the first six lines of the text file for
this header.  You don't have to have the entries in that order. You
do have to have all the entries, however.  Here's an explanation of
what each does:

$TITLE - The title of this text file.  It may be up to 48 characters
long (not including colour codes).  And yes, you can put colour
codes in it.

$AUTHOR - The author of this text file.  It may be up to 33
characters long (not including colour codes), and you may put colour
codes in it.

$DATE - The date this text file was written.  It may be up to 20
characters long (not including colour codes), and you may put colour
codes in it.

$LINES - How long this text file is (in lines, minus the lines taken
up by the file header).  If 0, the viewer will automatically
determine the length of the text file, and will load up to 468 lines
of it.  If the file is longer than 468 lines, you must specify how
many lines there are.  If you want to save memory when loading a
smaller text file (less than 468 lines), you may specify the number
of lines here (you save [(468 - lines) X 4]  bytes of memory, or 4
bytes per line not used).  You can also save loading time on large
files by specifying the number of lines in the file.

$INDENT - How many characters the indent should be. WARNING: If the
indent causes a line to exceed 68 characters, that line will be
clipped!

$JUSTIFY - How to justify lines:
  0 = Left justified
  1 = Right justified
  2 = Centered
Keep in mind that the $INDENT value affects all but centered
justification.

And that's it!