home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR16 / DPS10.ZIP / DPS.DOC next >
Text File  |  1993-10-05  |  84KB  |  1,825 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                      D P S
  8.  
  9.                            Document Processing System
  10.  
  11.  
  12.  
  13.                               A Shareware Program
  14.  
  15.  
  16.  
  17.  
  18.                                Phillip H. Sherrod
  19.  
  20.                                       and
  21.  
  22.                               Daniel J. Cappannari
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.            DPS reads a document source  file  which  includes  style,
  30.            spacing,   and   formatting   commands,  and  generates  a
  31.            formatted ASCII output file suitable for printing  on  any
  32.            type   of  computer  printer.   DPS  is  well  suited  for
  33.            preparing documentation for programs  or  other  technical
  34.            projects.   DPS  provides  table  of  contents  and  index
  35.            generation  and  cross  references  by  section  and  page
  36.            numbers.   DPS  also  provides automatic section numbering
  37.            and a variety of list types.
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                                Table of Contents
  44.  
  45.  
  46.  
  47.       1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  1
  48.         1.1 Installing DPS  . . . . . . . . . . . . . . . . . . . . . .  1
  49.         1.2 Using DPS . . . . . . . . . . . . . . . . . . . . . . . . .  2
  50.  
  51.       2. DPS Operation  . . . . . . . . . . . . . . . . . . . . . . . .  3
  52.         2.1 Text, Figures, and Verbatim . . . . . . . . . . . . . . . .  4
  53.         2.2 Page Dimensions . . . . . . . . . . . . . . . . . . . . . .  6
  54.         2.3 Chapters and Sections . . . . . . . . . . . . . . . . . . .  6
  55.         2.4 Styles  . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  56.         2.5 Centering Text  . . . . . . . . . . . . . . . . . . . . . . 11
  57.         2.6 Indentation . . . . . . . . . . . . . . . . . . . . . . . . 12
  58.         2.7 Double Sided Printing . . . . . . . . . . . . . . . . . . . 13
  59.         2.8 Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  60.         2.9 Blank Lines and Page Ejects . . . . . . . . . . . . . . . . 15
  61.         2.10 Page and Section References  . . . . . . . . . . . . . . . 17
  62.         2.11 Table of Contents  . . . . . . . . . . . . . . . . . . . . 17
  63.         2.12 Index Entries  . . . . . . . . . . . . . . . . . . . . . . 18
  64.  
  65.       3. Command Reference  . . . . . . . . . . . . . . . . . . . . . . 19
  66.         3.1 Between Line Commands . . . . . . . . . . . . . . . . . . . 19
  67.         3.2 Within Line Commands  . . . . . . . . . . . . . . . . . . . 22
  68.         3.3 Style Parameter Commands  . . . . . . . . . . . . . . . . . 22
  69.  
  70.       4. Use And Distribution of DPS  . . . . . . . . . . . . . . . . . 26
  71.         4.1 Disclaimer  . . . . . . . . . . . . . . . . . . . . . . . . 27
  72.  
  73.       5. Other Software . . . . . . . . . . . . . . . . . . . . . . . . 28
  74.         5.1 Mathplot -- Mathematical Function Plotting Program  . . . . 28
  75.         5.2 Nonlin -- Linear & Nonlinear Statistical Regression . . . . 28
  76.         5.3 TSX-32 -- Multi-User Operating System . . . . . . . . . . . 29
  77.  
  78.       6. Software Order Form  . . . . . . . . . . . . . . . . . . . . . 31
  79.  
  80.       Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.                                        i
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.                                    Chapter 1
  104.  
  105.                                   Introduction
  106.  
  107.  
  108.  
  109.  
  110.       DPS (Document Processing System) is a  program  which  formats  text
  111.       files  for  printing  on  any  type  of printer.  DPS can be used to
  112.       format  letters,  articles,  books,  and   documentation.    It   is
  113.       particularly  well  suited  for preparing documentation for programs
  114.       and  other  technical  projects  because  it  has  cross   reference
  115.       facilities  that  automatically fill in section and page numbers for
  116.       referenced items, and it has built in facilities  for  producing  an
  117.       index.   This  document  was  prepared using DPS; the source file is
  118.       provided for your examination in a file named DPS.DPS.
  119.  
  120.       By design, DPS does not utilize any printer control functions  other
  121.       than  carriage-return,  line-feed,  and  form-feed.  This allows the
  122.       output of DPS to be printed on a wide variety  of  printers  ranging
  123.       from inexpensive dot matrix devices through fancy laser printers.
  124.  
  125.       DPS  is  similar to word processing programs in that it helps you to
  126.       produce a  formatted  document.   However,  DPS  is  different  from
  127.       programs  like  WordPerfect  and  Microsoft Word in the way that you
  128.       specify formatting  commands.   With  the  typical  word  processing
  129.       program  you  use  function  keys  to specify formatting actions and
  130.       with most of these  programs  you  see  the  result  on  the  screen
  131.       immediately.   With  DPS you use an editor such as DOS EDIT or EDLIN
  132.       to create a "source" document file that contains both  the  text  of
  133.       the   document   and   embedded  DPS  commands  that  describe  what
  134.       formatting is to be done for each part of the  document.   You  then
  135.       use  DPS  to process this source file and produce a formatted output
  136.       file.
  137.  
  138.  
  139.       1.1 Installing DPS
  140.  
  141.       The installation of DPS is very simple.  Create a directory for  the
  142.       DPS  files  and use PKUNZIP to unpack the compressed file or copy in
  143.       all of the files from your distribution disk.  You  should  add  the
  144.       DPS  directory to your PATH command so that DOS can find the DPS.EXE
  145.       file if some other directory is your current directory.
  146.  
  147.       The DPS distribution includes the following files:
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.                                        1
  156.  
  157.       Chapter 1. Introduction                                            2
  158.  
  159.  
  160.            DPS.EXE      -- Executable program.
  161.            DPS.DOC      -- Documentation file.
  162.            DPS.DPS      -- Source file for DPS.DOC to use as an example.
  163.            REGISTER.DOC -- Software registration form.
  164.            VENDOR.DOC   -- Information for shareware vendors.
  165.            README.DOC   -- Introduction file.
  166.            FILE_ID.DIZ  -- Information for bulletin boards.
  167.  
  168.  
  169.       1.2 Using DPS
  170.  
  171.       The first step in using DPS is to create a  "source"  document  file
  172.       containing  your  text  and  DPS  commands.  It is best to give this
  173.       file the extension ".DPS".
  174.  
  175.       The source file should be in "flat ASCII format",  meaning  that  it
  176.       simply  consists of ASCII characters with carriage-return, line-feed
  177.       sequences  separating  the  records.   This  is  the  type  of  file
  178.       produced  by  various  text  editors  such  as  the  EDIT  and EDLIN
  179.       programs available with DOS.  You may use a word processor  such  as
  180.       WordPerfect  to  produce  the  file, but you should be sure that the
  181.       output is in "DOS text" format with no extra data inserted  for  the
  182.       benefit of the word processor.
  183.  
  184.       Once  you  have  created a source file you can use DPS to format it.
  185.       The form of the DPS command is:
  186.  
  187.            DPS source_file [output_file]
  188.  
  189.       Where "source_file" is the name of your  source  document  file  and
  190.       "output_file"  is the name of the file to which the formatted output
  191.       is to be written.  The default extension  for  the  source  file  is
  192.       ".DPS".   The  default  extension for the output file is ".DOC".  If
  193.       no output file is specified DPS creates  an  output  file  with  the
  194.       same name as the source file but with the extension ".DOC".
  195.  
  196.       For  example,  the  following command would read a source file named
  197.       MATHPLOT.DPS  and  produce   a   formatted   document   file   named
  198.       MATHPLOT.DOC:
  199.  
  200.            DPS MATHPLOT
  201.  
  202.       The  following command would read a source file named NONLIN.DPS and
  203.       produce a formatted output file named REGRESS.LST:
  204.  
  205.            DPS NONLIN REGRESS.LST
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.                                    Chapter 2
  213.  
  214.                                  DPS Operation
  215.  
  216.  
  217.  
  218.  
  219.       In addition to your text, the input file may contain  two  types  of
  220.       DPS  commands:  "between  line" and "within line".  The between line
  221.       type of commands are the most common.  These commands begin  with  a
  222.       period  as the first character of the line and are terminated by the
  223.       end of the line.  For example,
  224.  
  225.            .CHAPTER Introduction
  226.  
  227.       marks the beginning of a new chapter named "Introduction".
  228.  
  229.       If you have text lines that begin with a period, or you  would  just
  230.       prefer  some introducer character other than period, you can use the
  231.       .BLCMD command to specify another introducer  character.   The  form
  232.       of this command is:
  233.  
  234.             .BLCMD character
  235.  
  236.       where  'character'  is  the  character  to  be  used  as the command
  237.       introducer.  For example, the following command causes comma  to  be
  238.       set as the introducer character:
  239.  
  240.             .BLCMD ,
  241.  
  242.       After  this  command  you would type comma as the first character of
  243.       each between line command.
  244.  
  245.       Within line commands can occur in the middle  of  a  line  of  text.
  246.       These  commands  are  denoted  with an introducer character which is
  247.       normally backslash (\).  An example of  a  within  line  command  is
  248.       "\PAGEREF{name}"  which  might  be  used  in  a line of text such as
  249.       follows:
  250.  
  251.            For a description of the process, see page \pageref{mrdesc}.
  252.  
  253.       This command tells DPS to insert  the  page  number  for  a  section
  254.       labeled "mrdesc".
  255.  
  256.       If  you  need  to  use  the  '\'  character  within the text of your
  257.       document specify two '\' characters in  a  row.   For  example,  you
  258.       would  type  the  string  "C:\\DPS\\DPS.EXE"  to  produce the string
  259.       "C:\DPS\DPS.EXE".
  260.  
  261.  
  262.  
  263.  
  264.                                        3
  265.  
  266.       Chapter 2. DPS Operation                                           4
  267.  
  268.  
  269.       To change the within line introducter character  from  backslash  to
  270.       something else, use the .WLCMD command whose syntax is
  271.  
  272.            .WLCMD character
  273.  
  274.       DPS  commands  are  case  insensitive so you can use either upper or
  275.       lower case letters.
  276.  
  277.       Chapter 3, starting on page 19, provides a  complete  reference  for
  278.       the  DPS  commands.   The  remainder  of  this chapter discusses the
  279.       commands from an operational point of view.
  280.  
  281.  
  282.       2.1 Text, Figures, and Verbatim
  283.  
  284.       The bulk of your source document will consist of the text  that  DPS
  285.       is  to  format.   During  its normal operation, DPS reads this text,
  286.       combines words into lines and paragraphs,  and  outputs  pages  with
  287.       headers  and  numbers  if  requested.   While  it is performing this
  288.       formatting DPS is said to be in "text mode".
  289.  
  290.       Two additional modes are used to temporarily disable  formatting  of
  291.       input text.  These are "figure mode" and "verbatim mode".
  292.  
  293.       A  figure  is a series of records in the input document which should
  294.       not be formatted, and which  should  be  kept  together  (not  split
  295.       across  pages).   While  in figure mode DPS does not rearrange words
  296.       on lines.  It maintains the same spacing as in the source  file  but
  297.       may  indent  all of the lines a fixed amount which can be controlled
  298.       by the .FINDENT command (by  default,  figures  are  not  indented).
  299.       You  cannot  use  within  line  commands  within figures because all
  300.       characters are taken "literally".  This means it  is  not  necessary
  301.       to  specify  "\\"  to  produce  a  single  "\" within a figure.  Use
  302.       figure mode for figures, diagrams, and so forth.   Place  a  .FIGURE
  303.       command  at  the  front  of a figure and .ENDFIGURE at the end.  The
  304.       following example demonstrates how to use figure mode:
  305.  
  306.       Chapter 2. DPS Operation                                           5
  307.  
  308.  
  309.            .figure
  310.            +-------+   +----------+   +--------+
  311.            | TRAIN |-->| Conveyor |-->| Sorter |
  312.            +-------+   +----------+   +--------+
  313.                                         |    |
  314.                                         V    V
  315.                                +---------+  +---------+
  316.                                | Cracker |  | Grinder |
  317.                                +---------+  +---------+
  318.                                    |              |
  319.                                    V              V
  320.                                +---------+  +---------+
  321.                                | Packer  |  | Packer  |
  322.                                +---------+  +---------+
  323.                                    |              |
  324.                                    V              V
  325.                               +----------+  +-----------+
  326.                               |Whole nuts|  |Ground nuts|
  327.                               +----------+  +-----------+
  328.            .endfigure
  329.  
  330.       Verbatim mode is very similar to figure  mode.   Like  figure  mode,
  331.       verbatim  mode preserves the source format of each line and does not
  332.       move words from one line to another  or  adjust  spacing.   However,
  333.       verbatim  mode does not guarantee that all of the lines in the group
  334.       will fit on a single page.   Use  the  .VERBATIM  command  to  begin
  335.       verbatim  mode and the .ENDVERBATIM command to return to normal text
  336.       mode.  The following example demonstrates the use of verbatim text:
  337.  
  338.            .verbatim
  339.            /*-----------------------------------------------------------
  340.             * Function
  341.             *    Convert a year/month/day date into the corrsponding
  342.             *    day of the week.
  343.             */
  344.            int dtu_weekday(int year,int month,int date)
  345.            {
  346.            /*
  347.             * Declarations
  348.             */
  349.                  int j10,j14,value,w0to7;
  350.            /*
  351.             * Code
  352.             */
  353.                  j10 = month + 10;
  354.                  j14 = year + (month-14)/12;
  355.                  value = (13*(j10-j10/13*12)-1)/5+date+77
  356.                             +5*(j14-j14/100*100)/4
  357.                             +j14/400-j14/100*2;
  358.                  w0to7 = value%7;
  359.                  return w0to7+1;
  360.            }
  361.            .endverbatim
  362.  
  363.       Chapter 2. DPS Operation                                           6
  364.  
  365.  
  366.       2.2 Page Dimensions
  367.  
  368.       To properly format output text, DPS must know certain  things  about
  369.       the  capabilities  of your printer.  These are the maximum number of
  370.       lines which can be printed on the page, the maximum  width  of  each
  371.       line,  and  the  margins to leave on the left and right edges of the
  372.       paper.
  373.  
  374.       The default page length is 58 lines, the default page  width  is  80
  375.       characters,   and   the   default  left  and  right  margins  are  6
  376.       characters.  You can use the  following  commands  to  change  these
  377.       values:
  378.  
  379.            .LENGTH value    -- Specify number of lines per page.
  380.            .WIDTH value     -- Specify number of characters per line.
  381.            .LMARGIN value   -- Specify left margin spaces.
  382.            .RMARGIN value   -- Specify right margin spaces.
  383.  
  384.       If  you  want  to  adjust these parameters it is best to place these
  385.       commands at the front of your source document file before any text.
  386.  
  387.  
  388.       2.3 Chapters and Sections
  389.  
  390.       A simple document such as a letter does not need to be divided  into
  391.       sections.   An article may be divided into a number of sections such
  392.       as the introduction, main body, and conclusions.  Longer  documents,
  393.       such as this one, are divided into chapters and sections.
  394.  
  395.       DPS  allows  you to divide a document in a heirarchical manner, with
  396.       chapters,    main    sections,    sub-sections,    sub-sub-sections,
  397.       sub-sub-sub-sections,  and  so  forth.   This allows you to organize
  398.       your material using as much detail  as  it  requires.   Up  to  nine
  399.       levels  of  sections  can  be  used.   DPS automatically numbers the
  400.       chapters and sections and uses this  information  in  the  table  of
  401.       contents.
  402.  
  403.       Chapters,  when  used,  are introduced with the .CHAPTER command, as
  404.       with:
  405.  
  406.            .CHAPTER Technical Specification
  407.  
  408.       Sections are introduced with .HLn commands, where  "n"  denotes  the
  409.       depth  of  the  section  level.   .HL1  introduces the highest level
  410.       section (within a chapter), HL2  introduces  a  sub-section,  HL3  a
  411.       sub-sub-section, etc.  Take the following example:
  412.  
  413.            .CHAPTER Technical Specification
  414.            .HL1 Scope of this document
  415.            This document describes the use of the butterfly clamp.
  416.            .HL1 Intended audience
  417.            .HL2 Doctors
  418.            Doctors need to know whether it works.
  419.            .HL2 Nurses
  420.            Nurses need to know how to use it.
  421.  
  422.       Chapter 2. DPS Operation                                           7
  423.  
  424.  
  425.       The output would appear as follows:
  426.  
  427.  
  428.                                    Chapter 1
  429.  
  430.                             Technical Specification
  431.  
  432.  
  433.       1.1 Scope of this document
  434.  
  435.       This document describes the use of the butterfly clamp.
  436.  
  437.       1.2 Intended audience
  438.  
  439.       1.2.1 Doctors
  440.  
  441.       Doctors need to know whether it works.
  442.  
  443.       1.2.2 Nurses
  444.  
  445.       Nurses need to know how to use it.
  446.  
  447.       Each  .CHAPTER or .HL directive in the file produces an entry in the
  448.       table of contents.  DPS always begins chapters on a  new  page.   If
  449.       the  .DSIDE (double side printing) command is in effect, blank pages
  450.       are inserted if necessary to force chapters to begin  on  odd  pages
  451.       (which are printed on the right side).
  452.  
  453.       The  .NLAHL  command  is used to set the number of blank lines to be
  454.       left above a section header.  The .SLMLOP command  sets  the  number
  455.       of  lines  that must remain on a page for DPS to begin a new section
  456.       on the current page.
  457.  
  458.  
  459.       2.4 Styles
  460.  
  461.       People have individual tastes and needs for the style  of  formatted
  462.       text.   Furthermore,  a single document may need some text formatted
  463.       in one style and other text in a different style.
  464.  
  465.       To deal with this situation DPS comes preloaded  with  a  number  of
  466.       different  styles  and  allows  you  to  create additional styles as
  467.       needed.  This section  describes  styles,  documents  the  preloaded
  468.       styles, and shows you how to create and use custom styles.
  469.  
  470.       DPS  comes  preloaded with styles named STANDARD, PLAIN, REPORT, and
  471.       LETTER.  The STANDARD style is the default that is used  unless  you
  472.       select a different style using the .STYLE command.
  473.  
  474.       A  new style can be selected or created at any point in the document
  475.       by using the .STYLE command, as shown in the following examples:
  476.  
  477.       Chapter 2. DPS Operation                                           8
  478.  
  479.  
  480.            .STYLE STANDARD
  481.            This text will be formatted according to the standard style.
  482.            .STYLE CUSTOM
  483.            This text is formatted according to the style CUSTOM.
  484.  
  485.       If the style you list in a .STYLE command does not exist it will  be
  486.       created  for  you.   New  styles  start  out being the same as style
  487.       STANDARD.
  488.  
  489.       The current style can be  customized  at  any  point  by  the  style
  490.       commands  listed  in  Section 3.3 beginning on page 22.  Since style
  491.       commands always modify the  current  style,  you  can  use  them  to
  492.       modify  built  in  styles  or  to  create a new style.  For example,
  493.       simply stating
  494.  
  495.            .NOJUSTIFY
  496.            .LMEXTRA 5
  497.  
  498.       at  the  top  of  your  document  modifies   the   standard   style,
  499.       deactivating  text  justification and specifying that all lines of a
  500.       paragraph  except  the  first   should   be   indented   5   spaces.
  501.       Alternatively you could specify
  502.  
  503.            .STYLE DESCRIPTION
  504.            .NOJUSTIFY
  505.            .LMEXTRA 5
  506.  
  507.       to  create  a new style called DESCRIPTION with these modifications.
  508.       The new style would remain in effect until  DPS  encounters  another
  509.       style command such as
  510.  
  511.            .STYLE STANDARD
  512.  
  513.       to return to the standard style.
  514.  
  515.       You  can  switch between styles as often as you like.  If you modify
  516.       attributes for a style the modifications remain in effect  when  you
  517.       switch back to the style.
  518.  
  519.       Chapter 2. DPS Operation                                           9
  520.  
  521.  
  522.            The following table documents parameters for the four
  523.            built-in styles.
  524.  
  525.             Parameter     STANDARD      REPORT      LETTER        PLAIN
  526.            -----------  -----------  -----------  -----------  -----------
  527.            BLBP               1           1            1            1
  528.            MLOP               2           2            2            2
  529.            LMFIRST            0           0            0            0
  530.            LMEXTRA            0           0            0            0
  531.            NLAH               0           0            0            0
  532.            NLBH               2           2            2            2
  533.            NLAF               2           2            2            2
  534.            H1TEXT             0           0            0            0
  535.            HXTEXT             2           0            0            0
  536.            H1PN               0           0            0            0
  537.            HXPN               1           0            0            0
  538.            F1TEXT             0           0            0            0
  539.            FXTEXT             0           0            0            0
  540.            F1PN               2           2            0            0
  541.            FXPN               0           2            0            0
  542.            FINDENT            0           0            0            0
  543.            CHAPHEAD           1           0            0            0
  544.            JUSTIFY            1           1            0            1
  545.            NLAHL        5,2,1,1,1,   5,2,1,1,1,   5,2,1,1,1,   5,2,1,1,1,
  546.                           1,1,1,1      1,1,1,1      1,1,1,1     1,1,1,1
  547.            INDENT       0,0,0,0,0,   0,0,0,0,0,   0,0,0,0,0,   0,0,0,0,0,
  548.                           0,0,0,0      0,0,0,0      0,0,0,0     0,0,0,0
  549.            LIST_IN1     4,8,12,16,   4,8,12,16,   4,8,12,16,   4,8,12,16,
  550.                         20,24,28,32  20,24,28,32  20,24,28,32  20,24,28,32
  551.            LIST_INX     4,8,12,16,   4,8,12,16,   4,8,12,16,   4,8,12,16,
  552.                         20,24,28,32  20,24,28,32  20,24,28,32  20,24,28,32
  553.            LIST_BULCHR     period      period       period       period
  554.            LIST_BULPOS  2,6,10,14,   2,6,10,14,   2,6,10,14,   2,6,10,14,
  555.                         18,22,26,30  18,22,26,30  18,22,26,30  18,22,26,30
  556.            SLMLOP        5,5,5,5,5    5,5,5,5,5    5,5,5,5,5    5,5,5,5,5
  557.                           5,5,5,5      5,5,5,5      5,5,5,5      5,5,5,5
  558.  
  559.       Some  style  parameters  are defined as lists of values instead of a
  560.       single value.  Some, such as .NLAHL (Number of  Lines  Above  Header
  561.       at  each Level) define a separate value for every chapter or section
  562.       level.  Others, such as .LIST_IN1 (LIST INdentation  for  the  first
  563.       line  of  a list at each list nesting level) define a separate value
  564.       for each depth to which lists can be nested.
  565.  
  566.       To modify these parameters you must first specify the  name  of  the
  567.       parameter,   then  the  section  or  nesting  level  which  you  are
  568.       modifying, then finally the value you wish to specify.
  569.  
  570.       Take .NLAHL as an example.  This parameter specifies the  number  of
  571.       blank  lines  to  leave above the header line for a specific section
  572.       level.  The level 1 value specifies what is used for .HL1,  level  2
  573.       for .HL2, and so forth.  Hence the style modification command
  574.  
  575.            .NLAHL 1 4
  576.  
  577.       Chapter 2. DPS Operation                                          10
  578.  
  579.  
  580.       means  that  you  want 4 lines above the heading generated by a .HL1
  581.       command.
  582.  
  583.       For the STANDARD style DPS  places  a  page  number  at  the  bottom
  584.       center  of  the  first  page  of a chapter and places a page heading
  585.       with a page  number  at  the  margin  of  subsequent  pages  of  the
  586.       chapter.   The  .H1TEXT  and  .HXTEXT style parameters determine the
  587.       type of header printed.  The .H1PN and  .HXPN  parameters  determine
  588.       the  type  of  page number for the heading.  The .F1TEXT and .FXTEXT
  589.       parameters  control  the  footer  style  and  the  .F1PN  and  .FXPN
  590.       parameters  control  the  style  of  page number in the footer.  The
  591.       .NLAH, .NLAF and .NLBH parameters  control  the  spacing  above  and
  592.       below the header and footer.
  593.  
  594.       The  following  numeric  codes  are used to define header and footer
  595.       styles: Headers are printed at the top of  each  page;  footers  are
  596.       printed at the bottom.
  597.  
  598.       0 -- No text at all in the header or footer.
  599.  
  600.       1  --  Standard  style,  showing  current  chapter and section.  The
  601.           contents of the header or footer will vary depending on  whether
  602.           single  or  double page mode is being used.  In single page mode
  603.           (the  default),  the  current  chapter  name  is   always   left
  604.           justified  in  the  header  or footer.  In double page mode, the
  605.           chapter name goes on the right end of the  even  pages  and  the
  606.           section  name  goes  on  the  left end of the odd pages.  Double
  607.           sided mode is described in Section 2.7.
  608.  
  609.       2 -- Restrict text to name of  the  current  chapter,  omitting  the
  610.           section  name.   In  single  sided  mode this places the chapter
  611.           name on the left end.  In double sided mode the chapter name  is
  612.           on the right end of even pages and the left end of odd pages.
  613.  
  614.       The  following  numeric  codes  are  used  to  define page numbering
  615.       styles:
  616.  
  617.       0 -- No page number at all.
  618.  
  619.       1 -- Decimal value at end of line.  For single  side  mode  this  is
  620.           always  the  left  end.   For  double  sided  mode it alternates
  621.           sides.
  622.  
  623.       2 -- Decimal value in the center of the line.
  624.  
  625.       3 -- Roman numeric at end of line.  For single  side  mode  this  is
  626.           always  the  left  end.   For  double  sided  mode it alternates
  627.           sides.
  628.  
  629.       4 -- Roman numeral in the center of the line.
  630.  
  631.       Chapter 2. DPS Operation                                          11
  632.  
  633.  
  634.       2.5 Centering Text
  635.  
  636.       Often you will want to center a single line of text in the midst  of
  637.       normally  formatted  text.   The  .SCENTER command is used for this.
  638.       DPS will center the line which follows it,  then  return  to  normal
  639.       processing of input.  For example, the input text file:
  640.  
  641.            He wandered on through the forest, checking his compass
  642.            regularly to be sure that he was still heading toward
  643.            the general's house.  About an hour after he stopped to
  644.            eat his sack lunch, he encountered a tree into which
  645.            a message had been carved:
  646.            .SCENTER
  647.            "The great man retains the childs mind"
  648.            He wondered, as he neared the house of the fierce military
  649.            leader, if the general had ever been exposed to Taoist
  650.            principles.
  651.  
  652.       produces the output text:
  653.  
  654.            He  wandered  on  through the forest, checking his compass
  655.            regularly to be sure that he was still heading toward  the
  656.            general's  house.   About  an hour after he stopped to eat
  657.            his sack  lunch,  he  encountered  a  tree  into  which  a
  658.            message had been carved:
  659.  
  660.                     "The great man retains the childs mind"
  661.  
  662.            He  wondered,  as  he  neared  the  house  of  the  fierce
  663.            military leader, if the general had ever been  exposed  to
  664.            Taoist principles.
  665.  
  666.       Sections  of  centered  text can be begun with a .CENTER command and
  667.       finished with a .ENDCENTER command.  Note that  DPS  does  not  fill
  668.       paragraphs  while  in  center mode.  Each line of the source file is
  669.       taken as a single line figure which is centered.   Hence  the  input
  670.       file:
  671.  
  672.            .CENTER
  673.            He wandered on through the forest, checking his compass
  674.            regularly to be sure that he was still heading toward
  675.            the general's house.  About an hour after he stopped to
  676.            eat his sack lunch, he encountered a tree into which
  677.            a message had been carved:
  678.            "The great man retains the childs mind"
  679.            He wondered, as he neared the house of the fierce military
  680.            leader, if the general had ever been exposed to
  681.            Taoist principles.
  682.            .ENDCENTER
  683.  
  684.       produces the following output file:
  685.  
  686.       Chapter 2. DPS Operation                                          12
  687.  
  688.  
  689.             He wandered on through the forest, checking his compass
  690.              regularly to be sure that he was still heading toward
  691.             the general's house.  About an hour after he stopped to
  692.               eat his sack lunch, he encountered a tree into which
  693.                            a message had been carved:
  694.                     "The great man retains the childs mind"
  695.            He wondered, as he neared the house of the fierce military
  696.                 leader, if the general had ever been exposed to
  697.                                Taoist principles.
  698.  
  699.  
  700.       2.6 Indentation
  701.  
  702.       The  margins imposed by the printer's ability to print on a piece of
  703.       paper has already been discussed.  This is covered  by  the  .WIDTH,
  704.       .LMARGIN,  and  .RMARGIN  commands.   All  text, including formatted
  705.       text and figures, is placed within these  boundaries.   The  default
  706.       width  is 80 characters.  The default margins are 6 characters each.
  707.       Thus the default area in which text can be printed is 68 columns.
  708.  
  709.       The length of the paper can be specified using the  .LENGTH  command
  710.       whose default value is 58 lines.
  711.  
  712.       Formatted  text has left margins imposed by the style.  The .LMFIRST
  713.       and .LMEXTRA commands specify the left  margin  for  the  first  and
  714.       each  subsequent line of a paragraph.  Lists, which are described in
  715.       chapter 2.8, are  given  separate  margins  by  the  style  commands
  716.       .LIST_IN1 and .LIST_INX.
  717.  
  718.       The  .HANG  command  can  be  used to create paragraphs with hanging
  719.       indentation.  When a non-zero value is  specified  for  the  hanging
  720.       indentation  DPS indents all lines of subsequents paragraphs by this
  721.       amount but leaves the first line of each paragraph unindented so  it
  722.       is flush with the left margin.  For example, the command
  723.  
  724.            .HANG 5
  725.  
  726.       causes  all  lines  other  than  the  first  line of each subsequent
  727.       paragraph to be indented 5 spaces.  Specify "HANG  0"  to  turn  off
  728.       hanging  indentation.   See also the .DESCRIPTION command on page 14
  729.       for  a  similar  facility  for   formatting   lists   with   hanging
  730.       indentation.
  731.  
  732.       A  command  which  is  similar  to  .HANG  is .SQUEEZE.  This causes
  733.       formatted text to be "squeezed" by the specified number of  columns.
  734.       In other words, the command
  735.  
  736.            .SQUEEZE 5
  737.  
  738.       adds  5  to  the  left margin and subtracts 5 from the right margin.
  739.       This is useful for quotations and  other  material  that  should  be
  740.       indented  on both sides.  Put the command ".SQUEEZE 0" at the end of
  741.       the material to terminate the squeeze condition.
  742.  
  743.       Chapter 2. DPS Operation                                          13
  744.  
  745.  
  746.       2.7 Double Sided Printing
  747.  
  748.       DPS has the ability to print double  sided  text.   This  format  is
  749.       used  when producing output which is to be bound.  Double sided mode
  750.       has the following effects on the formatted document:
  751.  
  752.         . The left and right margin values  (.LMARGIN  and  .RMARGIN)  are
  753.           reversed  for  even pages which normally appear on the left side
  754.           of a bound document.  This means that the left margin  value  is
  755.           always  used  on  the  side  of the page nearest to the binding.
  756.           For a bound document you may want to use a larger value for  the
  757.           left margin to allow room for the space used by the binding.
  758.  
  759.         . Blank  pages  are  inserted  as  necessary  to force chapters to
  760.           start on odd numbered pages.
  761.  
  762.         . The standard heading is changed so that  the  the  chapter  name
  763.           goes  on  the  right  end of the even pages and the section name
  764.           goes on the left end of the odd pages.
  765.  
  766.       Double sided  printing  mode  is  specified  with  either  of  these
  767.       commands:
  768.  
  769.            .DSIDED
  770.            .DOUBLESIDED
  771.  
  772.       If  you  wish  to  use double sided mode you should put one of these
  773.       commands at the front of your source document.
  774.  
  775.  
  776.       2.8 Lists
  777.  
  778.       Lists are a special paragraph style used when describing  a  set  of
  779.       things.   Lists  can  contain sublists, and so forth, nested up to 9
  780.       levels deep.  The current style determines the  indentation  of  the
  781.       first  and  subsequent line of each list item, and also provides for
  782.       a "bullet" character at a given position to visually mark the  start
  783.       of the next item.
  784.  
  785.       There  are  three  types  of  lists  in DPS: regular lists, numbered
  786.       lists, and description lists.  When you nest lists you can  intermix
  787.       these  types  but  each list, regardless of its type, counts against
  788.       the nesting limit of 9.
  789.  
  790.       A regular list begins with the  .LIST  command  and  ends  with  the
  791.       .ENDLIST  command.   Each  new element of the list is denoted with a
  792.       line that starts out with a .ITEM (or .LE) command, followed by  the
  793.       text  of the item.  The text may be continued to subsequent lines if
  794.       it does not fit on a single line.  (The .LE  command  is  equivalent
  795.       to  .ITEM).   DPS  performs formatting and justification of the text
  796.       of each list item.  The following is an example of a list:
  797.  
  798.       Chapter 2. DPS Operation                                          14
  799.  
  800.  
  801.            .LIST
  802.            .ITEM Shareware programs are an excellent value because you can
  803.            try a program to see if it suitable for your needs before you
  804.            buy it.
  805.            .ITEM Many shareware programs work as well as expensive
  806.            commercial products but cost much less to register.
  807.            .ITEM Shareware is very convenient because you can find
  808.            programs of interest on many bulletin boards and
  809.            download them without leaving your home.
  810.            .ENDLIST
  811.  
  812.       This produces the following output:
  813.  
  814.         . Shareware programs are an excellent value because you can try  a
  815.           program to see if it suitable for your needs before you buy it.
  816.  
  817.         . Many  shareware  programs  work  as well as expensive commercial
  818.           products but cost much less to register.
  819.  
  820.         . Shareware is very convenient because you can  find  programs  of
  821.           interest  on  many  bulletin  boards  and  download them without
  822.           leaving your home.
  823.  
  824.       Each element of a regular list begins with  a  line  containing  the
  825.       "bullet"  character.   The  default bullet character is a period but
  826.       you can use the .LIST_BULCHR command to set  any  desired  character
  827.       as  the  bullet  for  any  level  of  list  nesting.  Style elements
  828.       .LIST_IN1, .LIST_INX, and .LIST_BULPOS control  the  indentation  of
  829.       the   first  line,  indentation  of  subsequent  lines,  and  bullet
  830.       position at each list nesting level.
  831.  
  832.       Numbered lists are like regular lists except that the  elements  are
  833.       numbered  instead  of being marked with bullet characters.  The same
  834.       style parameters, .LIST_IN1 and .LIST_INX  control  the  indentation
  835.       for  NLISTS  but a separate style attribute, .NLIST_NUMPOS, controls
  836.       the column used for  formatted  the  numbers.   Numbered  lists  are
  837.       begun  with  the  .NLIST  command  and  ended  with  .ENDLIST.  Each
  838.       element in the  list  is  introduced  with  a  .ITEM  command.   The
  839.       following is an example of a numeric list specification:
  840.  
  841.            .NLIST
  842.            .ITEM Insert the disk in either drive A or B.
  843.            .ITEM Type "MD \DPS"
  844.            .ITEM Type "CD \DPS"
  845.            .ITEM TYPE "COPY *.*"
  846.            .ENDLIST
  847.  
  848.       Description  lists  are  used  when  you want the indentation, not a
  849.       bullet or number, to mark the beginning of the list  element.   With
  850.       a  description  list the first line of each item is not indented but
  851.       subsequent lines are.  This causes  the  first  line  of  each  item
  852.       stand  out.   Description  lists  are  begun  with  the .DESCRIPTION
  853.       command and ended with .ENDLIST.   The  indentation  for  the  first
  854.       line  of  a  description  list  element  is  controlled by the style
  855.  
  856.       Chapter 2. DPS Operation                                          15
  857.  
  858.  
  859.       attribute .DESC_IN1, which is  specified  for  each  nesting  level.
  860.       Indentation of subsequent lines is controlled by .DESC_INX.
  861.  
  862.       List  items  may  have  multiple paragraphs.  Only the first line of
  863.       each item is marked or numbered.
  864.  
  865.       The following is an example of a description list definiton:
  866.  
  867.            .DESCRIPTION
  868.            .ITEM TSX-32 -- Multi-user operating system that is very
  869.            powerful and runs on 386 and 486 computers. Some TSX
  870.            sites support over 150 terminals on a single computer.
  871.            .ITEM Mathplot -- Mathematical function plotting program.
  872.            Excellent program for visualizing mathematical
  873.            functions. Enter a function using normal algebraic
  874.            notation and it is immediately graphed.
  875.            .ITEM Nonlin -- Linear and nonlinear statistical
  876.            regression analysis and curve fitting. Nonlin determines
  877.            the values of parameters for a function that cause the
  878.            function to best fit a set of data values.
  879.            .ENDLIST
  880.  
  881.       The output produced by these commands is shown below:
  882.  
  883.       TSX-32 -- Multi-user operating system  that  is  very  powerful  and
  884.           runs  on 386 and 486 computers.  Some TSX sites support over 150
  885.           terminals on a single computer.
  886.  
  887.       Mathplot  --  Mathematical  function  plotting  program.   Excellent
  888.           program   for   visualizing  mathematical  functions.   Enter  a
  889.           function using normal algebraic notation and it  is  immediately
  890.           graphed.
  891.  
  892.       Nonlin  --  Linear and nonlinear statistical regression analysis and
  893.           curve fitting.  Nonlin determines the values of  parameters  for
  894.           a  function  that  cause  the function to best fit a set of data
  895.           values.
  896.  
  897.  
  898.       2.9 Blank Lines and Page Ejects
  899.  
  900.       DPS advances to the next page of the document when the current  page
  901.       is  filled  up.   However,  there are various circumstances when DPS
  902.       checks to see if it should go ahead and start a new page before  the
  903.       current one is completely full.
  904.  
  905.       DPS  will always start a new page at the beginning of a new chapter.
  906.       The beginning of each section  within  the  chapter  forces  DPS  to
  907.       consider  whether  enough  space  on  the  page remains to begin it.
  908.       This prevents a section header appearing by itself at the bottom  of
  909.       the  page,  or  with  very  few  lines  of text.  Styles control the
  910.       minimum number of lines on a page for  each  nested  section  level,
  911.       using the .SLMLOP command.
  912.  
  913.       Chapter 2. DPS Operation                                          16
  914.  
  915.  
  916.       In  addition  to  checking  for  a minimum number of available lines
  917.       before starting a section, DPS also checks for a minimum  number  of
  918.       lines  before starting a new paragraph.  The default number of lines
  919.       that must be available for starting a new paragraph is  2,  but  you
  920.       can  change this value by use of the .MLOP command.  The .BLBP style
  921.       parameter controls the number of  blank  lines  between  paragraphs.
  922.       The default value is 1.
  923.  
  924.       Since  figures  must  all  fit  on  a page, DPS may also prematurely
  925.       eject the page to fit the figure on the next page.
  926.  
  927.       You can force DPS to be sure that a certain number of  lines  appear
  928.       on  a  page if you don't want certain text to be broken across pages
  929.       by using the .NEED command.  For example,
  930.  
  931.            .NEED 12
  932.  
  933.       asks DPS to be sure that at least 12 lines  remain  on  the  current
  934.       output page.  If fewer than 12 lines remain, a new page is started.
  935.  
  936.       A  more  forcible  command  is .PAGE, which tells DPS to begin a new
  937.       page if there is any text at all on the current one.
  938.  
  939.       To finish the subject of blank lines and page ejection we  have  the
  940.       commands .SPACE and .FSPACE.  First consider the command:
  941.  
  942.            .SPACE 5
  943.  
  944.       In  normal  text  mode, this command tells DPS to finish the current
  945.       paragraph and check to see how close to the end of the page  it  is.
  946.       The  next  paragraph  will begin 5 lines down on the current page if
  947.       there is enough room.  If there is not, it will begin at the top  of
  948.       the next page.
  949.  
  950.       A related command is .FSPACE.  The command
  951.  
  952.            .FSPACE 5
  953.  
  954.       means  that  you  want  5 blank lines to preceed the next paragraph,
  955.       even if the space must be placed at the top of the next page.   This
  956.       could be used to leave space for a figure or clip art.
  957.  
  958.       Note  that  when  in  figure  or  centered  mode,  .SPACE  acts like
  959.       .FSPACE.
  960.  
  961.       Chapter 2. DPS Operation                                          17
  962.  
  963.  
  964.       2.10 Page and Section References
  965.  
  966.       It is often necessary, especially  in  technical  documentation,  to
  967.       refer  the  reader  to  other  sections  of the document for further
  968.       information on a particular subject.  We  have  done  this  in  this
  969.       manual  when  we say things like "Lists are described in Section 2.8
  970.       on page 13".  The author did not count sections and  determine  that
  971.       Section  2.8 documents lists.  This would make a document tedious to
  972.       maintain because insertion of new  material  would  change  all  the
  973.       numbers.  Instead, the text used the \REF within line command:
  974.  
  975.            Lists are described in Section \ref{lists}.
  976.  
  977.       When  DPS encounters a \REF{name} command it looks up the label name
  978.       enclosed in braces and determines the chapter and section where  the
  979.       label  was  defined.   It  then  replaces  the \REF command with the
  980.       corresponding chapter or section number.
  981.  
  982.       A similar command is \PAGEREF.  This command causes the page  number
  983.       where  a label was defined to be inserted in the text.  For example,
  984.       the text
  985.  
  986.            See page \pageref{lists} for more information about lists.
  987.  
  988.       produces the output: See page 13 for more information about lists.
  989.  
  990.       In order for DPS to be able to locate the page, chapter, or  section
  991.       to  which  you are referring, both \REF and \PAGEREF commands take a
  992.       string argument, enclosed in braces.   This  descriptive  name  must
  993.       have  a  corresponding .LABEL command located near the text to which
  994.       you are  referring.   .LABEL  commands  for  chapters  and  sections
  995.       should  usually  immediately  follow  the  .CHAPTER or .HLn commands
  996.       that start the chapter or section.  However, you  can  place  .LABEL
  997.       commands  deep within sections when you want to define a label to be
  998.       used as a page  reference.   The  following  is  an  example  .LABEL
  999.       command  that  defines  a  label named 'intro': .figure .LABEL INTRO
  1000.       .endfigure
  1001.  
  1002.       DPS is a multi-pass processor so  you  can  use  \ref  and  \pageref
  1003.       commands  to  refer  to  labels that are defined after the reference
  1004.       point.
  1005.  
  1006.  
  1007.       2.11 Table of Contents
  1008.  
  1009.       DPS  will  automatically  produce  a  table  of  contents  for  your
  1010.       document  showing  chapter  and  section  numbers  and  pages.  This
  1011.       information  is  determined  by  DPS  from  the  .CHAPTER  and  .HLn
  1012.       commands.
  1013.  
  1014.       To  allow  you  to  have  heading  pages  in  front  of the table of
  1015.       contents, you must insert a .TOC command in your source file at  the
  1016.       point  where  you  want  the table of contents generated.  If you do
  1017.       not use a .TOC command no table of contents will be generated.
  1018.  
  1019.       Chapter 2. DPS Operation                                          18
  1020.  
  1021.  
  1022.       2.12 Index Entries
  1023.  
  1024.       An index is a valuable part of any large  document.   If  you  write
  1025.       technical  manuals,  try  to bear in mind that your readers will not
  1026.       always read your document from cover to cover,  or  even  an  entire
  1027.       chapter,  when  they are searching for a particular fact.  Having an
  1028.       index that can be used to rapidly  locate  topics  greatly  enhances
  1029.       the value of a manual.
  1030.  
  1031.       Index  entries  are  generated  by the .X command.  You should place
  1032.       the .X command on a line immediately preceeding  the  text  you  are
  1033.       referring to, as shown in the following example:
  1034.  
  1035.            .X Record length
  1036.            The maximum record length is 256 characters,
  1037.            but records are normally...
  1038.  
  1039.       Index  entries  can  have  both  a main topic and a subtopic.  To do
  1040.       this separate the main topic entry from the subtopic by a  semicolon
  1041.       as shown by the following example:
  1042.  
  1043.            .X File;Input
  1044.            .X File;Output
  1045.            .X File;Opening
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.                                    Chapter 3
  1053.  
  1054.                                Command Reference
  1055.  
  1056.  
  1057.  
  1058.  
  1059.       This  chapter  contains  an  alphabetical  list  of the DPS commands
  1060.       divided into three sections: between line, within  line,  and  style
  1061.       modification.
  1062.  
  1063.  
  1064.       3.1 Between Line Commands
  1065.  
  1066.       .BLCMD  character  --  Specifies  a  new  introducer  character  for
  1067.           between line commands.  The default character is period.
  1068.  
  1069.       .CENTER -- Causes each line of text between  this  command  and  the
  1070.           corresponding  .ENDCENTER  command  to  be centered on the page.
  1071.           The contents of each line is  preserved  (i.e.,  words  are  not
  1072.           moved between lines).
  1073.  
  1074.       .CHAPTER  title  --  Begins  a  new  chapter.   The  title string is
  1075.           printed as  the  chapter  heading  and  used  in  the  table  of
  1076.           contents.   DPS  starts  each  chapter on a new page.  If double
  1077.           sided printing is in effect (see  the  .DSIDE  command)  then  a
  1078.           blank  page  is ejected if needed to start the chapter on an odd
  1079.           page number.
  1080.  
  1081.       .DESCRIPTION -- Begins a description type list.  The first  line  of
  1082.           each  item  in  the  list  is  not  indented but other lines are
  1083.           indented.  The list is terminated by a .ENDLIST command.
  1084.  
  1085.       .DSIDE -- Specifies that the document will be printed on both  sides
  1086.           of  the  paper.   If  this  is  wanted the .DSIDE command should
  1087.           appear at the front of the document.  Double sided mode has  the
  1088.           following effects:
  1089.  
  1090.             . The  left  and  right  margin values (.LMARGIN and .RMARGIN)
  1091.               are reversed for even pages which  normally  appear  on  the
  1092.               left  side  of  a  bound document.  This means that the left
  1093.               margin value is always used on the side of the page  nearest
  1094.               to  the binding.  For a bound document you may want to use a
  1095.               larger value for the left  margin  to  allow  room  for  the
  1096.               space used by the binding.
  1097.  
  1098.             . Blank  pages  are inserted as necessary to force chapters to
  1099.               start on odd numbered pages.
  1100.  
  1101.  
  1102.  
  1103.  
  1104.                                        19
  1105.  
  1106.       Chapter 3. Command Reference                                      20
  1107.  
  1108.  
  1109.             . The standard heading is changed  so  that  the  the  chapter
  1110.               name  goes  on  the  right  end  of  the  even pages and the
  1111.               section name goes on the left end of the odd pages.
  1112.  
  1113.       .ENDCENTER -- Ends centered mode that was  started  with  a  .CENTER
  1114.           command.
  1115.  
  1116.       .ENDFIGURE  --  Ends  figure  mode  that  was started with a .FIGURE
  1117.           command.
  1118.  
  1119.       .ENDLIST -- Ends list mode that was started with  a  .LIST,  .NLIST,
  1120.           or .DESCRIPTION command.
  1121.  
  1122.       .ENDVERBATIM   --  Ends  verbatim  mode  that  was  started  with  a
  1123.           .VERBATIM command.
  1124.  
  1125.       .FIGURE -- Begins  figure  mode.   Use  the  .ENDFIGURE  command  to
  1126.           terminate  figure  mode.   No  formatting  takes place in figure
  1127.           mode and within line commands are not recognized.  You  may  use
  1128.           the .FINDENT command to cause figures to be indented.
  1129.  
  1130.       .FSPACE  number  -- Forces the specified number of blank lines to be
  1131.           skipped over.
  1132.  
  1133.       .HANG number -- Specifies that the following paragraphs are to  have
  1134.           hanging  indentation.   The  first  line of the paragraph is not
  1135.           indented but all other lines are indented the  specified  number
  1136.           of spaces.
  1137.  
  1138.       .HLn  text  -- Specify the heading for a section.  The 'n' character
  1139.           in .HLn should be replaced with a  digit.   .HL1  specifies  the
  1140.           heading  for  the  highest section level (below a chapter), .HL2
  1141.           specifies  the  heading  for   a   sub-section,   .HL3   for   a
  1142.           sub-sub-section,  etc.  The text string specified following .HLn
  1143.           is used as the heading for the section and also appears  in  the
  1144.           table of contents.
  1145.  
  1146.       .ITEM  text -- Specifies an item of a list.  This can be used in the
  1147.           range of .LIST, .NLIST, and .DESCRIPTION.  The text that  begins
  1148.           on the command line may be continued to subsequent lines.
  1149.  
  1150.       .LABEL  name  --  Defines  a  label  that  may  be referenced by the
  1151.           \ref{name} and \pageref{name} within line commands.
  1152.  
  1153.       .LE text -- Equivalent to .ITEM.  Specifies an item of a list.
  1154.  
  1155.       .LENGTH number -- Specifies the number of lines  to  be  printed  on
  1156.           each page.
  1157.  
  1158.       .LIST   --  Begins  a  list  whose  items  are  marked  by  "bullet"
  1159.           characters.  The default bullet character is the period but  you
  1160.           may  use  the .LIST_BULCHR command to specify a different bullet
  1161.           character.  The list is terminated by a .ENDLIST command.
  1162.  
  1163.       Chapter 3. Command Reference                                      21
  1164.  
  1165.  
  1166.       .LMARGIN number -- Specifies the number of spaces  to  use  for  the
  1167.           left margin of the page.  The default value is 6.
  1168.  
  1169.       .NEED  number -- Causes DPS to check to see if there are at least as
  1170.           many lines remaining on the page as  the  specified  value.   If
  1171.           there  are  not,  the  current page is ejected and the text that
  1172.           follows is printed at the top of the next page.
  1173.  
  1174.       .NLIST -- Begins  a  numbered  list.   Each  item  in  the  list  is
  1175.           numbered.  The list is terminated by a .ENDLIST command.
  1176.  
  1177.       .PAGE -- Forces a page eject at the current point.
  1178.  
  1179.       .RMARGIN  number  --  Specifies  the number of spaces to use for the
  1180.           right margin of the page.  The default value is 6.
  1181.  
  1182.       .SCENTER -- Causes the next single  line  to  be  centered.   Normal
  1183.           text formating mode resumes after the following line.
  1184.  
  1185.       .SPACE  number  --  If at least the specified number of lines remain
  1186.           on the current page they are skipped over and  left  blank.   If
  1187.           fewer  than  the  specified  number of lines remain, the current
  1188.           page is ejected and printing resumes at  the  top  of  the  next
  1189.           page.  See also the .FSPACE command.
  1190.  
  1191.       .SQUEEZE  number  --  Causes  the  following text to be indented the
  1192.           specified number of spaces on both the  left  and  right  sides.
  1193.           Specify ".SQUEEZE 0" to cancel squeeze mode.
  1194.  
  1195.       .STYLE  name -- Selects a specified style for the text that follows.
  1196.           If the name matches a style that has already been  defined  then
  1197.           that  style  is  resumed  and  any  style  parameters  that were
  1198.           specified for it continue in effect.  If the style name has  not
  1199.           been  previously used then a new style definition is begun.  New
  1200.           styles are  initialized  to  the  parameters  for  the  STANDARD
  1201.           style.
  1202.  
  1203.       .TOC  --  Causes the table of contents to be generated at this point
  1204.           in the document.
  1205.  
  1206.       .VERBATIM -- Begins verbatim mode.  In verbatim mode  no  formatting
  1207.           is  done  and  words are not moved between lines.  Verbatim mode
  1208.           is similar to figure mode but the text is not  required  to  fit
  1209.           on   a   single   page.    Verbatim  mode  is  terminated  by  a
  1210.           .ENDVERBATIM command.
  1211.  
  1212.       .WIDTH number -- Specifies the page width.   The  actual  area  that
  1213.           the  document  text  is  printed  in  is equal to the page width
  1214.           minus the left and right margins.  The default width is 80.
  1215.  
  1216.       .WLCMD character -- Specifies a new introducer character for  within
  1217.           line commands.  The default character is '\'.
  1218.  
  1219.       Chapter 3. Command Reference                                      22
  1220.  
  1221.  
  1222.       .X  item1[;item2]  --  Defines  an entry to go in the index.  If you
  1223.           want  a  two  level  entry  specify  the  primary  index  phrase
  1224.           followed by a semicolon and the secondary phrase.
  1225.  
  1226.  
  1227.       3.2 Within Line Commands
  1228.  
  1229.       The  following  commands  may  appear  within the body of your text.
  1230.       They are not recognized in figure or verbatim  mode.   You  can  use
  1231.       the .WLCMD command to change the introducer character.
  1232.  
  1233.       \PAGEREF{name}  -- When this command is encountered in your document
  1234.           it is replaced by the page  number  where  the  specified  label
  1235.           name  was defined.  The "name" must be defined somewhere in your
  1236.           document by use of the .LABEL command (see Section 2.10 on  page
  1237.           17).
  1238.  
  1239.       \REF{name}  --  When  this  command is encountered it is replaced by
  1240.           the chapter or section number where the  label  was  defined  by
  1241.           use  of  a  .LABEL  command.   If  the label was defined after a
  1242.           .CHAPTER command but before any .HLn  command  then  the  number
  1243.           will  be  an integer that corresponds to the chapter number.  If
  1244.           the label was defined  after  a  .HLn  command  then  a  section
  1245.           number of the form 'n.m.i' will be inserted.
  1246.  
  1247.  
  1248.       3.3 Style Parameter Commands
  1249.  
  1250.       The  following  commands  set  parameters for the currently selected
  1251.       style.  You choose a style by using  the  .STYLE  command.   If  you
  1252.       change  some  parameters for a style, select another style, and then
  1253.       reselect the first style, the  changed  parameters  are  remembered.
  1254.       See  Section 2.4 starting on page 7 for additional information about
  1255.       styles.
  1256.  
  1257.       .BLBP number -- Specifies the number of blank lines that DPS  should
  1258.           insert between paragraphs.  The default value is 1.
  1259.  
  1260.       .CHAPHEAD  number  --  Specifies  whether a chapter heading is to be
  1261.           printed on the first page  of  a  chapter.   A  chapter  heading
  1262.           consists  of  some blank lines, a line such as "Chapter nn", and
  1263.           the chapter title line.  Specify 1 to  enable  chapter  headings
  1264.           or  0  to disable them.  The STANDARD style has chapter headings
  1265.           enabled, the REPORT, LETTER, and PLAIN  styles  default  chapter
  1266.           headings off.
  1267.  
  1268.       .DESC_IN1  level  amt -- Amount to indent the text on the first line
  1269.           of each paragraph within a description type list.   The  'level'
  1270.           number  specifies  the  list  nesting  level; 0 corresponds to a
  1271.           list  that  is  not  within  another  list.   The  'amt'  number
  1272.           specifies  the  number  of  spaces  to  indent.   By default, an
  1273.           unnested list (level 0) is indented 0  spaces  and  each  deeper
  1274.           level of nesting is indented an additional 4 spaces.
  1275.  
  1276.       Chapter 3. Command Reference                                      23
  1277.  
  1278.  
  1279.       .DESC_INX  level amt -- Amount to indent the text on all lines other
  1280.           than the first line of each paragraph within a description  type
  1281.           list.   The  'level'  number specifies the list nesting level; 0
  1282.           corresponds to a list that is  not  within  another  list.   The
  1283.           'amt'  number  specifies  the  number  of  spaces to indent.  By
  1284.           default, an unnested list (level 0) is  indented  4  spaces  and
  1285.           each  deeper  level  of  nesting  is  indented  an  additional 4
  1286.           spaces.
  1287.  
  1288.       .F1PN number -- Type of page number to print in the footer  line  of
  1289.           first  page  of  a  chapter.   0  =  no number, 1 = decimal page
  1290.           number at right  end  of  line  or  alternating  left/right  for
  1291.           double  sided, 2 = decimal number in center of line, 3 = decimal
  1292.           number at right end of line, 4  =  roman  numberal  centered  in
  1293.           line.   The  default  value  is 2 for STANDARD and REPORT styles
  1294.           and 0 for the other styles.
  1295.  
  1296.       .F1TEXT number -- Type of footer to be printed on the first page  of
  1297.           a  chapter.  Specify 0 for no footer, 1 for the chapter name, or
  1298.           2 for the section name.  The default is 0.
  1299.  
  1300.       .FINDENT number -- Specifies the number of characters  that  figures
  1301.           are  to  be indented from the left margin.  The default value is
  1302.           0.
  1303.  
  1304.       .FXPN number -- Type of page number to  print  in  footer  lines  of
  1305.           pages  after  the  first  page of a chapter.  0 = no number, 1 =
  1306.           decimal  page  number  at  right  end  of  line  or  alternating
  1307.           left/right  for  double  sided,  2 = decimal number in center of
  1308.           line, 3 = decimal number  at  right  end  of  line,  4  =  roman
  1309.           numberal  centered  in  line.  The default value is 2 for REPORT
  1310.           style and 0 for all other styles.
  1311.  
  1312.       .FXTEXT number -- Type of footer to be printed on  pages  after  the
  1313.           first  page  of  a  chapter.  Specify 0 for no footer, 1 for the
  1314.           chapter name, or 2 for the section name.  The default is 0.
  1315.  
  1316.       .H1PN number -- Type of page number to print in the heading line  of
  1317.           the  first  page  of a chapter.  0 = no number, 1 = decimal page
  1318.           number at right  end  of  line  or  alternating  left/right  for
  1319.           double  sided, 2 = decimal number in center of line, 3 = decimal
  1320.           number at right end of line, 4  =  roman  numberal  centered  in
  1321.           line.  The default value is 0.
  1322.  
  1323.       .H1TEXT  number -- Type of header to be printed on the first page of
  1324.           a chapter.  Specify 0 for no header, 1 for the chapter name,  or
  1325.           2 for the section name.  The default is 0.
  1326.  
  1327.       .HXPN  number  --  Type  of  page number to print in heading line of
  1328.           pages after the first page of a chapter.  0 =  no  number,  1  =
  1329.           decimal  page  number  at  right  end  of  line  or  alternating
  1330.           left/right for double sided, 2 = decimal  number  in  center  of
  1331.           line,  3  =  decimal  number  at  right  end  of line, 4 = roman
  1332.           numberal centered in line.  The default value is 1 for  STANDARD
  1333.           style and 0 for all other styles.
  1334.  
  1335.       Chapter 3. Command Reference                                      24
  1336.  
  1337.  
  1338.       .HXTEXT  number  --  Type of header to be printed on pages after the
  1339.           first page of a chapter.  Specify 0 for no  header,  1  for  the
  1340.           chapter  name,  or 2 for the section name.  The default is 2 for
  1341.           STANDARD style and 0 for PLAIN, LETTER, and REPORT styles.
  1342.  
  1343.       .INDENT level amt -- Amount to indent  text  based  on  the  section
  1344.           level.   The  'level'  number  is  in  the  range  1  to  9  and
  1345.           corresponds to a section level as specified by the .HLn  command
  1346.           (see  Section 2.3 on page 6).  All text at the specified section
  1347.           level is indented the number of spaces specified  by  the  'amt'
  1348.           number.  The default value for all section levels is 0.
  1349.  
  1350.       .JUSTIFY  number  --  Specify  if  DPS  is to add spaces to lines to
  1351.           cause the right margin to be justified (flush).   Specify  1  to
  1352.           enable  right margin justification; specify 0 for a ragged right
  1353.           margin.  The .NOJUSTIFY command is equivalent to  ".JUSTIFY  0".
  1354.           The  default  value  is  0  for LETTER style and 1 for all other
  1355.           styles.
  1356.  
  1357.       .LIST_BULCHR level char -- Specify the character that is to be  used
  1358.           as  the  "bullet" marker character for each item of a list.  The
  1359.           'level' number specifies the list nesting level:  0  corresponds
  1360.           to  a  list  that  is  not within another list.  The 'char' item
  1361.           must be a single character.  The default bullet character  is  a
  1362.           period.
  1363.  
  1364.       .LIST_BULPOS  level amt -- Number of characters to indent the bullet
  1365.           character  for  each  item  of  a  list.   The  'level'   number
  1366.           specifies  the  list nesting level: 0 corresponds to a list that
  1367.           is not within another list.   The  'amt'  number  specifies  the
  1368.           number  of  characters  to  indent  the bullet for the specified
  1369.           level.  The default value is  2  for  an  unnested  list  and  4
  1370.           additional characters for each level of nesting.
  1371.  
  1372.       .LIST_IN1  level  amt -- Amount to indent the text on the first line
  1373.           of each item within a list.  The bullet character, or number  in
  1374.           the  case  of a .NLIST, is indented less so that it hangs out to
  1375.           the left of the text.  The 'level'  number  specifies  the  list
  1376.           nesting  level:  0  corresponds  to  a  list  that is not within
  1377.           another list.  The 'amt' number specifies the number  of  spaces
  1378.           to  indent.   By default, an unnested list (level 0) is indented
  1379.           4 spaces and  each  deeper  level  of  nesting  is  indented  an
  1380.           additional 4 spaces.
  1381.  
  1382.       .LIST_INX  level amt -- Amount to indent the text on all lines other
  1383.           than the first line of each item within  a  list.   The  'level'
  1384.           number  specifies  the  list  nesting  level: 0 corresponds to a
  1385.           list  that  is  not  within  another  list.   The  'amt'  number
  1386.           specifies  the  number  of  spaces  to  indent.   By default, an
  1387.           unnested list (level 0) is indented 4  spaces  and  each  deeper
  1388.           level of nesting is indented an additional 4 spaces.
  1389.  
  1390.       .LIST_NUMPOS  level amt -- Number of characters to indent the number
  1391.           for each item of a .NLIST (numbered)  type  list.   The  'level'
  1392.           number  specifies  the  list  nesting  level: 0 corresponds to a
  1393.  
  1394.       Chapter 3. Command Reference                                      25
  1395.  
  1396.  
  1397.           list  that  is  not  within  another  list.   The  'amt'  number
  1398.           specifies  the number of characters to indent the number for the
  1399.           specified level.  The default value is 0 for  an  unnested  list
  1400.           and 4 additional characters for each level of nesting.
  1401.  
  1402.       .LMEXTRA  number  --  Specify the number of characters to indent all
  1403.           lines of a  paragraph  after  the  first  line.   See  also  the
  1404.           description  of  the  .HANG command.  If both .LMEXTRA and .HANG
  1405.           are  specified,  their  values  are  added  to   determine   the
  1406.           indentation amount.  The default value for .LMEXTRA is 0.
  1407.  
  1408.       .LMFIRST  number  --  Specify the number of characters to indent the
  1409.           first line of each paragraph.  The default value is 0.
  1410.  
  1411.       .MLOP number -- Specify  the  minimum  number  of  lines  that  must
  1412.           remain  on a page for a new paragraph to be started on the page.
  1413.           If fewer than this many lines remain on the  page  the  page  is
  1414.           ejected  and  the  paragraph begins at the top of the next page.
  1415.           This prevents "orphan" lines where you have only the first  line
  1416.           of  a  paragraph  at the bottom of a page.  The default value is
  1417.           2.
  1418.  
  1419.       .NLAF number -- Number of blank lines  to  leave  between  the  last
  1420.           text  line  on a page and the footer line.  The default value is
  1421.           2.
  1422.  
  1423.       .NLAH number -- Number of blank lines  to  leave  above  the  header
  1424.           line at the top of each page.  The default value is 0.
  1425.  
  1426.       .NLAHL  level  lines  --  Number  of  blank  lines  to leave above a
  1427.           section header.  These blank lines separate a new  section  from
  1428.           the  previous  section.  The 'level' number is in the range 0 to
  1429.           9 and corresponds to the section heading level specified by  the
  1430.           .HLn  command  (see  page 20).  The special section number 0 can
  1431.           be used to specify the number of blank lines to put  before  the
  1432.           chapter  heading.   The 'lines' number is the number of lines to
  1433.           be set for this section level number.  The default  value  is  5
  1434.           lines  for  section  0  (chapter header), 2 lines for section 1,
  1435.           and 1 line for all other section levels.
  1436.  
  1437.       .NLBH number -- Number of blank lines to leave  between  the  header
  1438.           line  at  the top of each page and the first line of text on the
  1439.           page.  The default value is 2.
  1440.  
  1441.       .SLMLOP level amt -- Minimum number of lines that must be  available
  1442.           on  a  page  for DPS to start the section on the page.  If fewer
  1443.           lines are available DPS ejects the current page and  starts  the
  1444.           section  at  the top of the next page.  The 'level' number is in
  1445.           the range  1  to  9  and  corresponds  to  a  section  level  as
  1446.           specified  by the .HLn command (see Section 2.3 on page 6).  The
  1447.           'amt' number is  the  minimum  number  of  lines  that  must  be
  1448.           available.
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.                                    Chapter 4
  1456.  
  1457.                           Use And Distribution of DPS
  1458.  
  1459.  
  1460.  
  1461.  
  1462.       You  are  welcome to make copies of this program and pass them on to
  1463.       friends or post this program on bulletin  boards  or  distribute  it
  1464.       via  disk  catalog  services provided the entire DPS distribution is
  1465.       included in its original, unmodified form.  A distribution  fee  may
  1466.       be  charged  for  the  cost  of the diskette, shipping and handling.
  1467.       However, DPS may not be sold, or  incorporated  in  another  product
  1468.       that  is  sold,  without  the  permission  of the authors.  However,
  1469.       permission  is  granted  to  include  DPS  as  part  of   "shareware
  1470.       collections"  that  are sold on CD ROM's.  Vendors are encouraged to
  1471.       contact the authors to get the most recent version of DPS.
  1472.  
  1473.       As a shareware product, you are granted a no-cost, trial  period  of
  1474.       30  days  during  which you may evaluate DPS.  If you find DPS to be
  1475.       useful, educational, and/or entertaining, and  continue  to  use  it
  1476.       beyond  the  30 day trial period, you are required to compensate the
  1477.       authors by sending the registration form printed at the end of  this
  1478.       document  (and  in  REGISTER.DOC)  with the appropriate registration
  1479.       fee to help cover the development and support of DPS.
  1480.  
  1481.       In return for registering, you will be authorized to continue  using
  1482.       DPS  beyond  the  trial  period  and  you  will receive a registered
  1483.       version of DPS which does not  display  the  shareware  message  and
  1484.       pause.   You  will  also  receive a laser-printed, bound manual, and
  1485.       three months of support via telephone, mail,  or  CompuServe.   Your
  1486.       registration  fee  will  be  refunded if you encounter a serious bug
  1487.       that cannot be corrected.
  1488.  
  1489.       You are welcome to contact the authors:
  1490.  
  1491.                                Phillip H. Sherrod
  1492.                                4410 Gerald Place
  1493.                          Nashville, TN  37205-3806  USA
  1494.                             615-292-2881 (evenings)
  1495.                              CompuServe: 76166,2640
  1496.                       Internet: 76166.2640@compuserve.com
  1497.  
  1498.                                  Dan Cappannari
  1499.                               CCI Computing, Inc.
  1500.                                 P.O. Box 210963
  1501.                                Nashville TN 37221
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.                                        26
  1508.  
  1509.       Chapter 4. Use And Distribution of DPS                            27
  1510.  
  1511.  
  1512.       Both the DPS program and documentation are  copyright  (c)  1993  by
  1513.       Phillip  H.   Sherrod  and  Daniel  J.   Cappannari.   You  are  not
  1514.       authorized to modify the program or documentation.
  1515.  
  1516.       This  program  is  produced  by  a  member  of  the  Association  of
  1517.       Shareware  Professionals  (ASP).   ASP  wants  to make sure that the
  1518.       shareware principle works for you.  If you are unable to  resolve  a
  1519.       shareware-related  problem  with  an  ASP  member  by contacting the
  1520.       member directly, ASP may be able to help.   The  ASP  Ombudsman  can
  1521.       help  you  resolve a dispute or problem with an ASP member, but does
  1522.       not provide technical support for members' products.   Please  write
  1523.       to  the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 or send
  1524.       a  CompuServe  message  via  CompuServe  Mail   to   ASP   Ombudsman
  1525.       7007,3536.
  1526.  
  1527.  
  1528.       4.1 Disclaimer
  1529.  
  1530.       DPS  is  provided  "as  is"  without  warranty  of  any kind, either
  1531.       expressed  or  implied.   This  program  may  contain  "bugs".   The
  1532.       authors  assume no responsibility for the use of DPS and will not be
  1533.       responsible for any damage resulting from its use.
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.                                    Chapter 5
  1541.  
  1542.                                  Other Software
  1543.  
  1544.  
  1545.  
  1546.  
  1547.       If you like DPS, you should check out the following programs.
  1548.  
  1549.  
  1550.       5.1 Mathplot -- Mathematical Function Plotting Program
  1551.  
  1552.       Mathplot allows you to specify  complicated  mathematical  functions
  1553.       using  ordinary  algebraic  expressions  and  immediately plot them.
  1554.       Four types  of  functions  may  be  specified:  cartesian  (Y=f(X));
  1555.       parametric  cartesian  (Y=f(T) and X=f(T)); polar (Radius=f(Angle));
  1556.       and parametric polar  (Radius=f(T)  and  Angle=f(T)).   Up  to  four
  1557.       functions  may  be  plotted  simultaneously.   Scaling is automatic.
  1558.       Options are available to control axis display and labeling  as  well
  1559.       as  grid lines.  Hard copy output may be generated as well as screen
  1560.       display.  Mathplot is an ideal tool for engineers, scientists,  math
  1561.       and   science  teachers,  and  anyone  else  who  needs  to  quickly
  1562.       visualize mathematical functions.
  1563.  
  1564.  
  1565.       5.2 Nonlin -- Linear & Nonlinear Statistical Regression
  1566.  
  1567.       Nonlin  performs  linear  and   nonlinear   statistical   regression
  1568.       analysis.   What  is  regression analysis?  Regression analysis is a
  1569.       mathematical  technique  for  determining   the   best   values   of
  1570.       parameters  to  fit  an  equation  to  a  set  of  data points.  For
  1571.       example, you might want to develop an equation of the form
  1572.  
  1573.            price = p0 + p1*age + p2*miles
  1574.  
  1575.       to predict the price of a used car based on its age and  the  number
  1576.       of  miles driven.  With Nonlin you can collect data from car ads and
  1577.       then perform the analysis using the following set of commands:
  1578.  
  1579.            VARIABLES PRICE,AGE,MILES
  1580.            PARAMETERS P0,P1,P2
  1581.            FUNCTION  PRICE = P0 + P1*AGE + P2*MILES
  1582.            DATA
  1583.  
  1584.       Nonlin will analyze the data and determine the best  values  of  the
  1585.       parameters P0, P1, and P2 to fit the data values.
  1586.  
  1587.       Ordinary  linear  regression  programs  can only determine parameter
  1588.       values for linear (straight line) equations.  Nonlin, on  the  other
  1589.       hand,  can  handle  multivariate,  linear,  polynomial,  and general
  1590.  
  1591.  
  1592.                                        28
  1593.  
  1594.       Chapter 5. Other Software                                         29
  1595.  
  1596.  
  1597.       nonlinear equations.  For  example,  using  Nonlin  you  can  easily
  1598.       determine  the best values for the parameters Offset, Amplitude, and
  1599.       Frequency for an equation of the form:
  1600.  
  1601.            Y = Offset + Amplitude * sin(Frequency * X)
  1602.  
  1603.       Nonlin uses the same expression evaluator as  Mathplot  so  you  can
  1604.       model  complicated  equations  using  the  full set of operators and
  1605.       library functions available in Mathplot.
  1606.  
  1607.       Nonlin  comes  with  a  48  page  manual  that  explains  regression
  1608.       analysis  and  gives  many  examples.   Nonlin  is  in  use  at many
  1609.       universities and research labs around the world.
  1610.  
  1611.  
  1612.       5.3 TSX-32 -- Multi-User Operating System
  1613.  
  1614.       If you  have  a  need  for  a  multi-user,  multi-tasking  operating
  1615.       system,  you  should  look  into TSX-32.  TSX-32 is a full-featured,
  1616.       high performance, multi-user operating system for the  386  and  486
  1617.       that   provides  both  32-bit  and  16-bit  program  support.   With
  1618.       facilities  such  as  multitasking  and  multisessions,  networking,
  1619.       virtual  memory,  X-Windows,  background batch queues, data caching,
  1620.       file  access  control,  real-time,  and  dial-in   support,   TSX-32
  1621.       provides a solid environment for a wide range of applications.
  1622.  
  1623.       A  two  user,  shareware  version  of TSX-32 called TSX-Lite is also
  1624.       available.
  1625.  
  1626.       TSX-32 is not a limited, 16-bit, multi-DOS add-on.  Rather, it is  a
  1627.       complete  32-bit  operating  system  which  makes  full  use  of the
  1628.       hardware's potential, including protected  mode  execution,  virtual
  1629.       memory,  and  demand  paging.  TSX-32 sites range from small systems
  1630.       with 2-3  terminals  to  large  installations  with  more  than  100
  1631.       terminals on a single 486.
  1632.  
  1633.       In  addition  to supporting most popular 16-bit DOS programs, TSX-32
  1634.       also provides a 32-bit "flat" address space with both Phar  Lap  and
  1635.       DPMI compatible modes of execution.
  1636.  
  1637.       Since  the  DOS  file  structure  is  standard  for  TSX-32, you can
  1638.       directly read and write DOS disks.  And, you can  run  DOS  part  of
  1639.       the time and TSX-32 the rest of the time on the same computer.
  1640.  
  1641.       TSX-32  allows each user to control up to 10 sessions.  Programs can
  1642.       also "fork" subtasks for multi-threaded applications.  The  patented
  1643.       Adaptive  Scheduling  Algorithm  provides consistently good response
  1644.       time under varying conditions.
  1645.  
  1646.       The  TSX-32  network  option  provides  industry   standard   TCP/IP
  1647.       networking  through  Ethernet and serial lines.  Programs can access
  1648.       files on remote machines as easily as on  their  own  machine.   The
  1649.       SET  HOST  command  allows a user on one machine to log onto another
  1650.       computer in the network.  FTP, Telnet, and  NFS  are  available  for
  1651.       interoperability with other systems.
  1652.  
  1653.       Chapter 5. Other Software                                         30
  1654.  
  1655.  
  1656.       System  requirements:  386  or  486 system, 4MB memory, 12MB of free
  1657.       disk space (Stacker and DoubleSpace are not supported).
  1658.  
  1659.       TSX-32 is, quite  simply,  the  best  and  most  powerful  operating
  1660.       system  available  for  the 386 and 486.  For additional information
  1661.       contact:
  1662.  
  1663.                            S&H Computer Systems, Inc.
  1664.                              1027 17th Avenue South
  1665.                             Nashville, TN 37212 USA
  1666.                               615-327-3670 (voice)
  1667.                                615-321-5929 (fax)
  1668.                               CompuServe: 71333,27
  1669.                        Internet: 71333.27@compuserve.com
  1670.  
  1671.         ===============================================================
  1672.                               Software Order Form
  1673.         ===============================================================
  1674.  
  1675.       Name ______________________________________________________
  1676.  
  1677.       Address ___________________________________________________
  1678.  
  1679.       City _______________________  State _______ Zip ___________
  1680.  
  1681.       Country ____________________  Telephone ___________________
  1682.  
  1683.       CompuServe account (optional) _____________________________
  1684.  
  1685.       DPS version _______________________________________________
  1686.  
  1687.       Bulletin board where you found DPS ________________________
  1688.  
  1689.       Comments __________________________________________________
  1690.  
  1691.       Check the boxes which indicate your order type:
  1692.  
  1693.           ___ I wish to register DPS ($25).
  1694.  
  1695.           ___ I wish to order Mathplot ($20).
  1696.  
  1697.           ___ I wish to order Nonlin ($25)
  1698.  
  1699.       Add $5 to the total amount of the order if  the  software  is  being
  1700.       shipped  out  of  the  United  States.   I cannot accept checks from
  1701.       non-US banks.  Visa, MasterCard and  American  Express  credit  card
  1702.       charges   are  accepted  but  a  check,  money  order,  or  cash  is
  1703.       preferred.  If you wish to use a credit  card  specify  the  billing
  1704.       name, address, card number, and expiration date.
  1705.  
  1706.       In  return for registering, you will receive the most recent version
  1707.       of the program, a laser-printed,  bound  copy  of  the  manual,  and
  1708.       three  months of telephone or CompuServe support.  Your registration
  1709.       fee will be refunded if you  find  a  serious  bug  that  cannot  be
  1710.       corrected.
  1711.  
  1712.       Distribution disk choice (check one):
  1713.  
  1714.             3.50" HD (1.4 MB)  ______
  1715.             5.25" HD (1.2 MB)  ______
  1716.             5.25" DD (360 KB)  ______
  1717.  
  1718.       Send this form with the amount indicated to the author:
  1719.  
  1720.                                Phillip H. Sherrod
  1721.                                4410 Gerald Place
  1722.                          Nashville, TN  37205-3806 USA
  1723.  
  1724.                             615-292-2881 (evenings)
  1725.                              CompuServe: 76166,2640
  1726.                       Internet: 76166.2640@compuserve.com
  1727.  
  1728.       Index                                                             32
  1729.  
  1730.  
  1731.       ASP, 27                                lines below, 25
  1732.       Between line commands, 3, 19           page number, 23
  1733.       Blank lines, 15                        style of, 10, 23, 24
  1734.       BLBP command, 16, 22                HLn command, 6, 20
  1735.       BLCMD command, 3, 19                HXPN command, 10, 23
  1736.       Bullet character, 14, 24            HXTEXT command, 10, 24
  1737.       Bullet position, 14                 INDENT command, 24
  1738.       Cappannari, Dan, 26                 Index, 18
  1739.       CENTER command, 11, 19              Input File, 2
  1740.       Centering text, 11                  Internet, 30
  1741.       CHAPHEAD command, 22                ITEM command, 13, 20
  1742.       CHAPTER command, 6, 19              JUSTIFY command, 8, 24
  1743.       Chapters, 6                         LABEL command, 17, 20
  1744.       Command syntax, 3                   Labels, 17
  1745.       CompuServe, 30                      LE command, 13, 20
  1746.       Copyright notice, 26                LENGTH command, 6, 20
  1747.       Cross references, 17                LIST command, 13, 20
  1748.       Curve fitting, 28                   Lists, 13
  1749.       DESCRIPTION command, 13, 14,           Description, 14
  1750.                19                            Numbered, 14
  1751.       DESC_IN1 command, 14, 22               Regular, 13
  1752.       DESC_INX command, 14, 23            LIST_BULCHR command, 14, 24
  1753.       Disclaimer, 27                      LIST_BULPOS command, 14, 24
  1754.       Double sided printing, 13, 19       LIST_IN1 command, 12, 14, 24
  1755.       DOUBLESIDED command, 13             LIST_INX command, 12, 14, 24
  1756.       DPMI support, 29                    LIST_NUMPOS command, 24
  1757.       DSIDE command, 19                   LMARGIN command, 6, 21
  1758.       DSIDED command, 13                  LMEXTRA command, 8, 12, 25
  1759.       Ejecting pages, 15                  LMFIRST command, 12, 25
  1760.       ENDCENTER command, 11, 20           Margins, 12
  1761.       ENDDESCRIPTION command, 13          Mathplot, 28
  1762.       ENDFIGURE command, 20               MLOP command, 16, 25
  1763.       ENDLIST command, 13, 20             Mode
  1764.       ENDVERBATIM command, 20                figure, 4
  1765.       F1PN command, 10, 23                   text, 4
  1766.       F1TEXT command, 10, 23                 verbatim, 5
  1767.       FIGURE command, 4, 20               Multi-user operating system,
  1768.       Figure mode, 4                               29
  1769.       File                                NEED command, 16, 21
  1770.          Input, 2                         Networking, 29
  1771.       FINDENT command, 23                 NLAF command, 10, 25
  1772.       Flush right margin, 24              NLAH command, 10, 25
  1773.       Footer, 10                          NLAHL command, 9, 25
  1774.       Footers                             NLBH command, 10, 25
  1775.          lines above, 25                  NLIST command, 14, 21
  1776.          page number, 23                  NLIST_NUMPOS command, 14
  1777.          style of, 10, 23                 NOJUSTIFY command, 24
  1778.       FSPACE command, 16, 20              Nonlin, 28
  1779.       FXPN command, 10, 23                Nonlinear regression, 28
  1780.       FXTEXT command, 10, 23              Numbered lists, 14
  1781.       H1PN command, 10, 23                Order form, 31
  1782.       H1TEXT command, 10, 23              PAGE command, 16, 21
  1783.       HANG command, 12, 20                Page Layout, 6, 12, 15
  1784.       Headers, 10                         Page number
  1785.          lines above, 25                     in footer, 23
  1786.  
  1787.       Index                                                             33
  1788.  
  1789.  
  1790.          in header, 23
  1791.          style codes, 10
  1792.       PAGEREF command, 17, 22
  1793.       Ragged right margin, 24
  1794.       REF command, 17, 22
  1795.       Registering DPS, 26
  1796.       Registration form, 31
  1797.       Regression analysis, 28
  1798.       RMARGIN command, 6, 21
  1799.       S&H Computer Systems, Inc.,
  1800.                30
  1801.       SCENTER command, 11, 21
  1802.       Sections, 6
  1803.          blank lines between, 25
  1804.          minimum lines remaining,
  1805.             15, 25
  1806.       Sherrod, Phillip H., 26
  1807.       SLMLOP command, 15, 25
  1808.       SPACE command, 16, 21
  1809.       SQUEEZE command, 12, 21
  1810.       STYLE command, 21
  1811.       Styles, 7
  1812.       Table of contents, 17
  1813.       TCP/IP, 29
  1814.       Text mode, 4
  1815.       TOC command, 17, 21
  1816.       TSX-32, 29
  1817.       TSX-Lite, 29
  1818.       VERBATIM command, 5, 21
  1819.       Verbatim mode, 5
  1820.       Warranty, 27
  1821.       WIDTH command, 6, 21
  1822.       Within line commands, 3, 22
  1823.       WLCMD command, 4, 21
  1824.       X command, 18, 21
  1825.