READINIT.TXT                         1                         Mar 10, 2001

The READINIT.EXE program creates and maintains a file called READ.INI.  The
READ.INI file is used to override certain defaults used by READ.EXE as well
as any self-viewing file created by READMAKE.EXE.

The specific defaults that can be changed:

*  Printer port:  Typically defaults to LPT1:   but  can  be  redefined  to
   another port or even a file name.
*  Printer string for regular text:  Allows you to specify the string  that
   will be sent to the printer port if text is printed and all lines in the
   document are 80 characters or less in length.
*  Printer string for wide text:  Allows you to  specify  the  string  that
   will be sent to the printer if text is printed  and  any  lines  in  the
   document are over 80 characters in length.
*  String after partial document  printed:   Allows  you  to  specify  what
   string should be printed after a full document  is  printed.   This  can
   include a page eject character and/or printer reset information.
*  String after full document printed:  Allows you to specify  what  string
   should be printed after a full document is printed.  This can include  a
   page eject character and/or printer reset information.  Defaults to /012
   which is a page eject.
*  Color settings:  You can change the five color sets used  while  viewing
   documents within the program.  (READ and READMAKE-produced files use the
   first four color sets while READY uses them all.)

The routine maintains a (short) list of printer brands and some of the more
useful reset strings used for different modes.  (Ask for the HPLJ  settings
to get an idea.) This table can be expanded if people ask.   Contact  Wayne
Software at the address below; provide a list of  required  codes  for  all
desirable choices.  Be reasonable with the number of choices.  In any case,
you can always fill in any non-predefined codes that you want to.

READINIT (and READ) look  for  the  initialization  file  in  your  default
subdirectory first.  It then searches for it in the subdirectory where  the
executable was and then goes through your DOS path.

The READ.INI file is further described in READ.TXT.  *.INI files in general
are discussed in BRUCEINI.TXT.


READINIT.TXT                         2                         Mar 10, 2001

Syntax:

    READINIT [ /PORT=port ] [ /PTYPE=name ] [ /INITT=string ]
      [ /INITW=string ] [ /AFTERP=string ] [ /AFTERF=string ]
      [ /COLOR=nnn nnn nnn nnn nnn ] [ /MONO ]
      [ /Iinitfile | /-I ] [ /-ENV ] [ /? ] [ /?HEX ]

where:

"/PORT=port" sets the default for READ, READY, and READMAKE-produced files.
It specifies the printer to use for printing.  This typically  defaults  to
/PORT=LPT1:  although this can be overridden by the READ.INI file.

"/PTYPE=name" sets the  default  for  READ,  READY,  and  READMAKE-produced
files.  It specifies the name of the printer to use.  This  allows  you  to
hook into some pre-defined printer settings (contact  Wayne  Software  with
some more initialization strings if you want some added).   Currently,  the
only accepted printers are HPLJ, EPSON, and OTHER.

"/INITT=string" ("initialize thin") sets the default for READ,  READY,  and
READMAKE-produced files.  It provides the string that will be sent  to  the
printer before printing if all lines in the document are 80  characters  or
less in length.   The  string  can  include  regular  characters.   Special
characters are  entered  by  using  either  their  decimal  or  hexadecimal
representation (see BRUCEHEX.TXT file).  "\027" is the code for the special
character Escape.  You can specify /INITT=NULL  if  desired.   Defaults  to
"/INITT=NULL".

"/INITW=string" ("initialize wide") sets the default for READ,  READY,  and
READMAKE-produced files.  It provides the string that will be sent  to  the
printer before printing if any lines in the document (not just the  section
printed) exceed 80 characters in length.  See "/INITT=string"  description.
Defaults to "/INITW=NULL".

For a Hewlett-Packard LaserJet, the  following  codes  would  typically  be
used:

        /INITT=\027E             (portrait mode, 80 column)
        /INITW=\027E\027(s16.66H (portrait mode, 132 column)

"/AFTERP=string" sets the default for READ,  READY,  and  READMAKE-produced
files.  It specifies the string  to  print  after  a  partial  document  is
printed.  This string can include a page eject character  ("\012")  or  any
printer  reset  codes  ("\012\027E")  you  want.   Initially  defaults   to
"/AFTERP=\012".

"/AFTERF=string" sets the default for READ,  READY,  and  READMAKE-produced
files.  It specifies the string to print after a full document is  printed.
See "/AFTERP=string" description.  Defaults to "/AFTERF=\012".


READINIT.TXT                         3                         Mar 10, 2001

"/COLOR=nnn nnn nnn  nnn  nnn"  sets  the  default  for  READ,  READY,  and
READMAKE-produced files.  It specifies the color settings to  use  for  (in
order) (1) regular text, (2) the status line, (3) marked  text,  (4)  found
text, and (5) highlighted text.  (Highlighting is supported  in  the  READY
program and the parameter is ignored in the other routines.)  Each  setting
must consist of three digits, the first two being the foreground color  and
the last being the background color.  The foreground color should be padded
on the left with a 0 if it is only one digit in length.

  For /COLOR, default is /COLOR=150 151 157 143 127
  For /MONO, default is  /COLOR=150 007 157 087 080

Foreground colors:

        Low intensity           High intensity

        0 = black                8 = dark grey
        1 = blue                 9 = light blue
        2 = green               10 = light green
        3 = cyan                11 = light cyan
        4 = red                 12 = light red
        5 = magenta             13 = light magenta
        6 = brown (or yellow)   14 = light yellow
        7 = white               15 = bright white

Adding 16 to any foreground color will make  the  text  blink.   Note  that
blinking text under Windows only works if your DOS window is  full  screen.
This can be set in the DOS properties or else just say Alt-Enter to make it
full screen.

Background colors can consist of 0 to 7 above.  Bright white on  blue,  for
example, would be "151".

"/MONO" (or "/-COLOR") sets READINIT  to  use  standard  monochrome  black,
white, and grey screen colors.  If a /COLOR=nnn  nnn  nnn  nnn  setting  is
found in the INI file, /MONO will not affect the  default  colors  used  by
READ, READMAKE-produced files, or READY although, obviously,  changing  the
colors used will be  more  limited  if  /MONO  is  used.   However,  if  no
/COLOR=nnn nnn nnn nnn setting is found or /-I is passed in, /MONO will set
the screen color defaults as /COLOR=150 007 157 087.  Initially defaults to
"/COLOR".

"/COLOR" (or "/-MONO") sets READINIT to use screen colors.  If a /COLOR=nnn
nnn nnn nnn setting is found in the INI file, /COLOR will  not  affect  the
default colors used by READ, READMAKE-produced files, or  READY.   However,
if no /COLOR=nnn nnn nnn nnn setting is found or /-I is passed  in,  /COLOR
will set the screen color defaults as /COLOR=150 151 157 This is  initially
the default.

"/Iinitfile" says to  read  an  initialization  file  with  the  file  name
"initfile".  The file specification *must* contain a period.  Initfiles are
described in the BRUCEINI.TXT file.  Initially defaults to "/IREAD.INI".

"/-I" (or "/INULL") says to skip loading the initialization file.


READINIT.TXT                         4                         Mar 10, 2001

"/ENV" says to look for %var% occurrences in the command line  and  try  to
resolve any apparent environmental variable references.   See  BRUCEINI.TXT
for more information.  This is initially the default.

"/-ENV" says to skip resolving apparent %var% occurrences  in  the  command
line.  Initially defaults to "/ENV".

"/?" or "/HELP" or "HELP" shows you the syntax for the command.

"/?HEX" gives you a hexadecimal and decimal conversion table.


Author:

This program was written by Bruce Guthrie of Wayne Software.   It  is  free
for use and redistribution provided relevant documentation is kept with the
program, no changes are made to the program or documentation, and it is not
bundled with commercial programs or charged  for  separately.   People  who
need to bundle it in for-sale packages must pay a $50 registration  fee  to
"Bruce Guthrie" at the following address.

Additional information about this and other Wayne Software programs can  be
found in the file BRUCE.TXT which should be included in  the  original  ZIP
file.  The recent change  history  for  this  and  the  other  programs  is
provided in the HISTORY.ymm file which should be in the same ZIP file where
"y" is replaced by the last digit of the year and "mm"  is  the  two  digit
month of the release; HISTORY.611 came out in November 1996.

The ZIP file that contained this program and its  associated  documentation
files is named with a two-digit year followed by  a  two-digit  month.   So
READ0001.ZIP came out in January 2000.

Comments and suggestions can be sent to the  following.   Realistically,  I
will not be revising this DOS-based program  much  in  the  future  but  it
doesn't hurt to suggest things anyway.

                Bruce Guthrie
                Wayne Software
                113 Sheffield St.
                Silver Spring, MD 20910

                e-mail: WayneSof@erols.com   fax: (301) 588-8986
                http://www.erols.com/waynesof

Please provide an Internet e-mail address on all correspondence.


