home *** CD-ROM | disk | FTP | other *** search
/ Programmer Power Tools / Programmer Power Tools.iso / turbopas / tlist23.arc / TLIST.DOC < prev    next >
Encoding:
Text File  |  1987-12-20  |  29.3 KB  |  768 lines
  1.         TLIST.EXE               Version 2.3                   12/18/87
  2.         Turbo Pascal Source Code Lister                    
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                     TLIST.EXE  
  18.  
  19.                                    Version 2.3
  20.  
  21.  
  22.                         A Turbo Pascal Source Code Lister
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                    Copyright (c) 1987 Omni Software Associates
  33.                                All Rights Reserved
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                                    Written By
  42.  
  43.                                   R.C. Ascheri
  44.  
  45.                              GENIE: AMIGAMAN
  46.                                BBS: RANDOM ACCESS
  47.                                     (714) 521-6386
  48.                                     PC EXCHANGE
  49.                                     (714) 956-5468
  50.          
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.         Copyright (c) 1987 Omni Software Associates
  60.         TLIST.EXE               Version 2.3                   12/18/87
  61.         Turbo Pascal Source Code Lister                    
  62.  
  63.  
  64.                                NO-NONSENSE LICENSE
  65.          
  66.  
  67.              All  versions of TLIST.EXE, starting with version  2.0,  are 
  68.              placed  in  the public domain and are hence  known  as  free 
  69.              software.   This shall include the actual program  TLIST.EXE 
  70.              and the corresponding documentation TLIST.DOC along with any 
  71.              trouble reports.  
  72.              
  73.              No  fee,  charge or other compensation may  be  accepted  or 
  74.              requested for any version of TLIST.EXE (it is free!).
  75.  
  76.              TLIST.EXE  may  not be distributed in conjunction  with  any 
  77.              other  product  where  a  charge  exists  for  the  original 
  78.              product.
  79.  
  80.              The  TLIST  package shall consist of  TLIST.EXE,  TLIST.DOC, 
  81.              TEST.PAS,   TEST.LIB,  README,  RUNME.BAT  and  any   update 
  82.              notices, bug reports etc..  
  83.  
  84.              The  source  code  for TLIST.EXE can be  obtained  from  the 
  85.              author  for the minimal cost of $25.00.  This shall  include 
  86.              one  diskette  with  the  Turbo  Pascal  4.0  Source   Code, 
  87.              any   and   all   libraries   required,   along   with   the 
  88.              documentation, etc..  To order the source code, fill out the 
  89.              order  blank and mail it to the addressee according  to  the 
  90.              instructions at the end of this documentation.
  91.  
  92.  
  93.                                      WARRANTY
  94.          
  95.  
  96.              Omni  Software  Associates makes no warranty  of  any  kind, 
  97.              express  or  implied,  including  without  limitation,   any 
  98.              warranties   of   merchantability  and/or  fitness   for   a 
  99.              particular  purpose.  Omni Software Associates shall not  be 
  100.              liable for any damages, whether direct, indirect, special or 
  101.              consequential  arising  from a failure of  this  program  to 
  102.              operate  in the manner desired by the user.   Omni  Software 
  103.              Associates  shall  not be liable for any damage to  data  or 
  104.              property  which may be caused directly or indirectly by  use 
  105.              of the program.
  106.  
  107.              IN  NO EVENT WILL Omni Software Associates BE LIABLE TO  YOU 
  108.              FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR 
  109.              OTHER  INCIDENTAL  OR CONSEQUENTIAL DAMAGES ARISING  OUT  OF 
  110.              YOUR  USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY  CLAIM 
  111.              BY ANY OTHER PARTY.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.         Copyright (c) 1987 Omni Software Associates
  119.         TLIST.EXE               Version 2.3                   12/18/87
  120.         Turbo Pascal Source Code Lister                    
  121.  
  122.              
  123.         1.0  INTRODUCTION
  124.  
  125.              What  is  TLIST.EXE?  TLIST is a Turbo  Pascal  Source  Code 
  126.              Listing utility that produces nice listings of Turbo  Pascal 
  127.              Source  Code.  The utility itself was thought of by  Borland 
  128.              International   with  their  LISTER.PAS  utility  that   has 
  129.              accompanied  all  of  their  Turbo  Pascal  Compilers  since 
  130.              version 2.0.  However, LISTER.PAS was just a simple  listing 
  131.              generator.   It didn't have any special formatting  commands 
  132.              of any kind.
  133.  
  134.              TLIST.EXE has many different formatting capabilities as well 
  135.              as  some  special functions for including the  page  number, 
  136.              current date, and current time in either the heading or  the 
  137.              footing  margins.   TLIST.EXE also supports  four  different 
  138.              kinds  of  printers HP2000, EPSON, OTC and  TOSHIBA.   Other 
  139.              printer types can be added easily upon request.
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.         Copyright (c) 1987 Omni Software Associates
  178.         TLIST.EXE               Version 2.3                   12/18/87
  179.         Turbo Pascal Source Code Lister                    
  180.  
  181.  
  182.         2.0  OPERATION
  183.  
  184.              TLIST  is basically a command line driven utility.   It  has 
  185.              three  forms  of  entry that are recognized.   They  are  as 
  186.              follows:
  187.  
  188.                          d:> TLIST <RETURN>
  189.                          d:> TLIST ? <RETURN>
  190.                          d:> TLIST filename.ext [-I] <RETURN>
  191.  
  192.              The  first form above will display the syntax of  how  TLIST 
  193.              must be called, much like the above information.  The second 
  194.              form  will  display all of the information relating  to  dot 
  195.              commands,  with a general description of each  dot  command.  
  196.              The  final  form  is the normal method used  to  format  and 
  197.              display  a  turbo  pascal source file.   This  final  method 
  198.              requires the filename of the file to be printed.  Naturally, 
  199.              the  filename can begin with a drive and path.  The [-I]  is 
  200.              an  opttional  parameter  which  is  used  to  disable   the 
  201.              inclusion  of any include files.  The output from  TLIST  is 
  202.              normally  sent to the screen.  You must redirect the  output 
  203.              to  the printer to actually get a hardcopy of the  formatted 
  204.              output.   As an example to format and print the  source  for 
  205.              TLIST.PAS, you would enter:
  206.  
  207.                             d:> TLIST TLIST.PAS >PRN
  208.  
  209.              Since Turbo Pascal 4.0 allows nested include files TLIST was 
  210.              written  to  automatically  include  the  source  code  from 
  211.              normal  and  nested  include files using  the  Turbo  Pascal 
  212.              include  directives.   The include directive MUST  begin  in 
  213.              column  number one for the files to be  included,  otherwise 
  214.              the  include directive is ignored.  Remember that the  turbo 
  215.              pascal include directive has the form:
  216.                                   {$I filename.ext}
  217.                                   ^
  218.                                   Must start in column number one.
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.         Copyright (c) 1987 Omni Software Associates
  237.         TLIST.EXE               Version 2.3                   12/18/87
  238.         Turbo Pascal Source Code Lister                    
  239.  
  240.  
  241.         3.0  DOT COMMANDS
  242.  
  243.              What  is  a  dot  command?  A dot command  is  a  string  of 
  244.              characters  that is placed between the turbo pascal  comment 
  245.              braces.   All dot commands must begin in the  first  column.  
  246.              The  form  of  a dot command  is  "{.XXYYYYYYYY}".   The  XX 
  247.              represents  the two character command to be  executed.   The 
  248.              YYYYYY represents the parameters for the command XX.    Most 
  249.              of   the dot commands should always appear at the  beginning 
  250.              of the source code so that proper initialization can  occur.  
  251.              The  following  paragraphs  will describe each  of  the  dot 
  252.              commands  in full detail, where they should be  placed,  and 
  253.              what  function they perform.  None of the dot commands  will 
  254.              be executed if they do NOT start in column number one.
  255.  
  256.         3.1.1  Set Page Length - .PL
  257.  
  258.              The  set page length dot command sets the maximum number  of 
  259.              lines per page to the value specified.  The format is  .PLnn 
  260.              where  nn is an integer number.  The number should be  based 
  261.              upon  the  number of lines per inch of  the  character  font 
  262.              being  used and the actual paper size.  With the standard  6 
  263.              lines  per inch characters and an 8.5 X 11 inch letter  size 
  264.              paper,  the  maximum number of lines per page would  be  66.  
  265.              The  .PL  command should be placed at the beginning  of  the 
  266.              source code.  This value can automatically be set by the .PT 
  267.              dot command.    
  268.  
  269.         3.1.2  Page Check - .PC
  270.  
  271.              The page check dot command will generate a new page break if 
  272.              the  value specified in the dot command is larger  than  the 
  273.              current  line  number minus four (the bottom  footer).   The 
  274.              format  of  the page check command is .PCnn, where nn  is  a 
  275.              value between zero and the maximum number of lines per page.  
  276.              The  maximum  number  of lines per  page  should  have  been 
  277.              initialized accordingly, prior to the use of the conditional 
  278.              page  command.  This dot command may appear anywhere  within 
  279.              the source code.  
  280.  
  281.         3.1.3  Immediate Page Break - .PA
  282.  
  283.              The  immediate page break dot command will start a new  page 
  284.              immediately.  A new page consists of printing the footer for 
  285.              the  previous  page followed by a new page (form  feed)  and 
  286.              then  the heading information for the new page.  The  format 
  287.              of the new page dot command is .PA.  No other parameters are 
  288.              required.   This dot command may appear anywhere within  the 
  289.              source code.
  290.  
  291.  
  292.  
  293.  
  294.  
  295.         Copyright (c) 1987 Omni Software Associates
  296.         TLIST.EXE               Version 2.3                   12/18/87
  297.         Turbo Pascal Source Code Lister                    
  298.  
  299.  
  300.         3.1.4  Set Left Margin Offset - .PO
  301.  
  302.              The set left margin offset dot command will add a series  of 
  303.              blank characters to the left side of the turbo pascal source 
  304.              code.  The format of the set left margin is .POnn, where  nn 
  305.              represents  the number of spaces to be inserted on the  left 
  306.              side  of  the turbo pascal source code.   This  dot  command 
  307.              should  appear at the beginning of the source  code,  unless 
  308.              for  some reason you want to unindent the left margin for  a 
  309.              piece of source code. 
  310.  
  311.         3.1.5  Set Current Page Number - .PN
  312.  
  313.              The  set  current page number dot command  will  change  the 
  314.              current  page number variable to the value specified in  the 
  315.              dot  command.  The format of the command is .PNnn, where  nn 
  316.              represents  the new current page number.  This  dot  command 
  317.              may  appear anywhere within the source code, but is  usually 
  318.              placed  at the beginning of the source code if  required  at 
  319.              all.   The  starting page number will always  be  zero  (0), 
  320.              therefore  all source code should contain an immediate  page 
  321.              break after initializing all of the variables.  See the test 
  322.              source file for an example.
  323.  
  324.         3.1.6  Set Printer Defaults According To Type - .PT
  325.  
  326.              The set printer defaults type dot command is a command  that 
  327.              will  change all of the printer control variables  to  their 
  328.              default  values according to the printer name  specified  in 
  329.              the  dot command.  The format of this command is  .PT<name>, 
  330.              where <name> represents one of the following names,  HP2000, 
  331.              EPSON, OTC or TOSHIBA.  When a specific printer is selected, 
  332.              the  page  offset, number of lines per page,  normal,  bold, 
  333.              initialization and de-initialization strings are all set  to 
  334.              their  corresponding values for that specific printer  type.  
  335.              Using  this  command to set all of the printer  defaults  is 
  336.              much  easier  than setting each of  these  printer  controls 
  337.              separately.   This  command  should  always  appear  at  the 
  338.              beginning  of  the  source  code  because  the  printer   is 
  339.              initialized  immediately after selecting the  printer  type.  
  340.              This   command  will  only  be  processed  once.   By   only 
  341.              processing this command once, include files may also contain 
  342.              the  printer  type dot command.  When the  include  file  is 
  343.              listed by itself the printer type will be processed, when it 
  344.              is  listed from the main file the printer type will  NOT  be 
  345.              processed. 
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.         Copyright (c) 1987 Omni Software Associates
  355.         TLIST.EXE               Version 2.3                   12/18/87
  356.         Turbo Pascal Source Code Lister                    
  357.  
  358.              
  359.         3.1.7  Turn Listing Generation OFF - .L-
  360.  
  361.              The turn listing generation off dot command is used to  turn 
  362.              off the physical listing (output) of the source code.   Once 
  363.              the listing generation has been turned off, NO text is  sent 
  364.              to  the output file until a turn listing generation  on  dot 
  365.              command  is processed.  The format of this command  is  .L-.  
  366.              No  other parameters are required.  This command may  appear 
  367.              anywhere  within  the  source  file  to  turn  the   listing 
  368.              generation off.
  369.  
  370.         3.1.8  Turn Listing Generation ON - .L+
  371.  
  372.              The  turn listing generation on dot command is used to  turn 
  373.              on  the physical listing (output) of the source code.   This 
  374.              must  be done to start listing source code once it has  been 
  375.              turned  off  with the listing generation off  command.   The 
  376.              format  of  this command is .L+.  No  other  parameters  are 
  377.              required.   This  command  may appear  anywhere  within  the 
  378.              source  file to turn the listing generation back  on,  after 
  379.              having it turned off with the listing off command.
  380.  
  381.         3.1.9  Set Start Of Heading String - .SH
  382.  
  383.              The  set  start of heading string dot command will  set  the 
  384.              start  of string variable to the specified string  found  in 
  385.              the  line.   The start of heading string is written  to  the 
  386.              output  device  prior to the actual  heading  string.   This 
  387.              allows the heading to be printed in any font desired because 
  388.              the  string may be changed to any string desired.  This  dot 
  389.              command  should normally be placed at the beginning  of  the 
  390.              source file.
  391.  
  392.         3.1.10  Set Start Of Footing String - .SF
  393.  
  394.              The  set  start of footing string dot command will  set  the 
  395.              start  of footing variable to the specified string  found  in 
  396.              the  line.   The start of footing string is written  to  the 
  397.              output  device  prior to the actual  footing  string.   This 
  398.              allows the footing to be printed in any font desired because 
  399.              the  string may be changed to any string desired.  This  dot 
  400.              command  should normally be placed at the beginning  of  the 
  401.              source file.
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.         Copyright (c) 1987 Omni Software Associates
  414.         TLIST.EXE               Version 2.3                   12/18/87
  415.         Turbo Pascal Source Code Lister                    
  416.  
  417.  
  418.         3.1.11  Set Heading Text - .MH
  419.  
  420.              The  set  heading dot command is used to  place  a  specific 
  421.              string of text characters at the beginning of each and every 
  422.              page.  The format of this command is .MH<text>, where <text> 
  423.              can   be  any  character  string.   Two  types  of   control 
  424.              characters  are allowed in the string.  The first  type  can 
  425.              consist of the imbedded control characters ^N and ^T.  These 
  426.              controls represent the turn bold on string and turn bold off 
  427.              strings.  When either of these controls are contained in the 
  428.              string the strings are expanded to the necessary  characters 
  429.              to  select  BOLD or NORMAL text mode.  If neither  of  these 
  430.              controls  are present in the string then all string  control 
  431.              characters  of  the form ^X and ( ) are packed  into  actual 
  432.              control characters and placed in the heading variable.  Note 
  433.              that the ( ) sequence is used to generate characters in  the 
  434.              range $80 - $FF range.
  435.  
  436.              This  next example contains string control characters  which 
  437.              will  be converted to actual control characters.  The  other 
  438.              alternative would be to imbed the control characters ^N  and 
  439.              ^T for bold and normal text mode into the heading string.
  440.  
  441.                    {.MH^[!8Turbo Pascal Source Code Lister^[!^D}
  442.  
  443.              This would have been converted to something like:
  444.  
  445.                  <ESC><!><8>Turbo Pascal Source Code Lister<ESC>!<EOT>
  446.  
  447.              The  set heading dot command may also contain three  special 
  448.              function character strings, #, @D and @T.  The # will always 
  449.              be replaced with the current page number.  To get the actual 
  450.              #  character in the heading use ##.  The @D will  always  be 
  451.              replaced with the current date in form MM/DD/YY, and the  @T 
  452.              will  always  be  replaced with the  starting  time  of  the 
  453.              listing in the form HH:MM:SS.
  454.  
  455.              This dot command may appear anywhere within the source code, 
  456.              BUT it will only be processed one time.  Use the .CH command 
  457.              to  actually change the heading to some other  text  string. 
  458.  
  459.         3.1.12  Change Heading Text - .CH
  460.  
  461.              The change heading dot command is used to change the heading 
  462.              that appears at the beginning of each and every page.   This 
  463.              command is exactly the same as the .MH dot command  (section 
  464.              3.1.11),  except that this dot command may  appear  anywhere 
  465.              within  the source file, and it will be processed  each  and 
  466.              everytime it appears.  The .MH dot command is only processed 
  467.              one time.
  468.  
  469.  
  470.  
  471.  
  472.         Copyright (c) 1987 Omni Software Associates
  473.         TLIST.EXE               Version 2.3                   12/18/87
  474.         Turbo Pascal Source Code Lister                    
  475.  
  476.  
  477.         3.1.13  Set Footing Text - .MF
  478.  
  479.              The  set  footing dot command is used to  place  a  specific 
  480.              string of text characters at the end of each and every page.  
  481.              The format of this command is .MF<text>, where <text> can be 
  482.              any  character string.  Two types of control characters  are 
  483.              allowed  in the string.  The first type can consist  of  the 
  484.              imbedded  control  characters  ^N and  ^T.   These  controls 
  485.              represent the turn bold on string and turn bold off strings.  
  486.              When  either of these controls are contained in  the  string 
  487.              the  strings  are expanded to the  necessary  characters  to 
  488.              select  BOLD  or  NORMAL text mode.   If  neither  of  these 
  489.              controls  are present in the string then all string  control 
  490.              characters  of  the form ^X and ( ) are packed  into  actual 
  491.              control characters and placed in the footing variable.  Note 
  492.              that the ( ) sequence is used to generate characters in  the 
  493.              range $80 - $FF range.  See the heading description above or 
  494.              the test source file for an example.
  495.  
  496.              The  set footing dot command may also contain three  special 
  497.              function  character strings, # (as shown above), @D and  @T.  
  498.              The # will always be replaced with the current page  number.  
  499.              To  get  the actual # character in the footing  use  the  ## 
  500.              sequence.   The @D will always be replaced with the  current 
  501.              date  in form MM/DD/YY, and the @T will always  be  replaced 
  502.              with the starting time of the listing in the form HH:MM:SS.
  503.  
  504.              This dot command may appear anywhere within the source code, 
  505.              however  it  is  usually set once at the  beginning  of  the 
  506.              source code.
  507.  
  508.         3.1.14  Change Footing Text - .CF
  509.  
  510.              The change footing dot command is used to change the footing 
  511.              that  appears  at the bottom of each and every  page.   This 
  512.              command is exactly the same as the .MF dot command  (section 
  513.              3.1.13),  except that this dot command may  appear  anywhere 
  514.              within  the source file, and it will be processed  each  and 
  515.              everytime it appears.  The .MF dot command is only processed 
  516.              one time.
  517.  
  518.         3.1.15  Set End Of Heading/Footing String - .SE
  519.  
  520.              The  set end of heading/footing string dot command will  set 
  521.              the end of heading/footing variable to the specified  string 
  522.              found  in  the line.  The end of heading/footing  string  is 
  523.              written  to  the output device after the actual  heading  or 
  524.              footing  have  been written.  This allows  the  heading  and 
  525.              footing to be printed in one type of font and then  continue 
  526.              with  the  normal  type of font.  This  dot  command  should 
  527.              normally be placed at the beginning of the source file.
  528.  
  529.  
  530.  
  531.         Copyright (c) 1987 Omni Software Associates
  532.         TLIST.EXE               Version 2.3                   12/18/87
  533.         Turbo Pascal Source Code Lister                    
  534.  
  535.  
  536.         3.1.16  Set Printer Initialization String - .SI
  537.  
  538.              The set printer initialization string dot command is used to 
  539.              set  the printer initialization string to a series  of  text 
  540.              characters.  The format of this command is .SI<text>,  where 
  541.              <text> can be any character string.  Special string  control 
  542.              characters  can  be  placed in the  string.   These  special 
  543.              string  control characters have the form ^X or ( ), where  X 
  544.              represents any character between A..Z.  The ( ) sequence  is 
  545.              used to generate characters in the range $80..$FF. 
  546.  
  547.              As an example the string:  {.SI^[E^[%(^A)}
  548.              Would  be  converted to:  <ESC><E><ESC><%><$81>
  549.  
  550.              Where  $81  represents the character $81 and not  the  three 
  551.              characters $,8 and 1.  
  552.  
  553.              This dot command may appear anywhere within the source code, 
  554.              however  it  is  usually set once at the  beginning  of  the 
  555.              source  code.   It  is not required when  the  printer  type 
  556.              command is used.
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.         Copyright (c) 1987 Omni Software Associates
  591.         TLIST.EXE               Version 2.3                   12/18/87
  592.         Turbo Pascal Source Code Lister                    
  593.  
  594.  
  595.         3.1.17  Set Printer De-initialization String - .SD
  596.  
  597.              The set printer de-initialization string dot command is used 
  598.              to  set the printer de-initialization string to a series  of 
  599.              text  characters.  The format of this command is  .SD<text>, 
  600.              where  <text> can be any character string.   Special  string 
  601.              control  characters  can  be placed in  the  string.   These 
  602.              special  string control characters have the form ^X or (  ), 
  603.              where  X  represents any character between A..Z.   The  (  ) 
  604.              sequence  is  used  to  generate  characters  in  the  range 
  605.              $80..$FF.  
  606.  
  607.              This dot command may appear anywhere within the source code, 
  608.              however  it  is  usually set once at the  beginning  of  the 
  609.              source  code.   It  is not required when  the  printer  type 
  610.              command is used.
  611.  
  612.         3.1.18  Set Bold Text Mode String (^N) - .SB
  613.  
  614.              The set bold text mode string dot command is used to set the 
  615.              bold  text  mode  string  variable   to  a  series  of  text 
  616.              characters.   The format of this command is SB<text>,  where 
  617.              <text> can be any character string.  Special string  control 
  618.              characters  can  be  placed in the  string.   These  special 
  619.              string  control characters have the form ^X or ( ), where  X 
  620.              represents any character between A..Z.  The ( ) sequence  is 
  621.              used to generate characters in the range $80..$FF. 
  622.  
  623.              This dot command may appear anywhere within the source code, 
  624.              however  it  is  usually set once at the  beginning  of  the 
  625.              source  code.   It  is not required when  the  printer  type 
  626.              command is used.
  627.  
  628.         3.1.19  Normal Text Mode String (^T) - .SN
  629.  
  630.              The  set normal text mode string dot command is used to  set 
  631.              the  normal text mode string variable  to a series  of  text 
  632.              characters.   The format of this command is SN<text>,  where 
  633.              <text> can be any character string.  Special string  control 
  634.              characters  can  be  placed in the  string.   These  special 
  635.              string  control characters have the form ^X or ( ), where  X 
  636.              represents any character between A..Z.  The ( ) sequence  is 
  637.              used to generate characters in the range $80..$FF. 
  638.  
  639.              This dot command may appear anywhere within the source code, 
  640.              however  it  is  usually set once at the  beginning  of  the 
  641.              source  code.   It  is not required when  the  printer  type 
  642.              command is used.
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.         Copyright (c) 1987 Omni Software Associates
  650.         TLIST.EXE               Version 2.3                   12/18/87
  651.         Turbo Pascal Source Code Lister                    
  652.  
  653.         4.0  CONCLUSIONS
  654.  
  655.              The turbo pascal lister was written to clean up listings and 
  656.              make  them  look real nice.  "If there's  anything  I  can't 
  657.              stand,  it's a messy listing that is hard to read".  I  hope 
  658.              that  everyone will find it as useful as I have, and as  fun 
  659.              using  it as I had writing it!  If you have any comments  or 
  660.              recommendations  regarding  this  listing  utility,  or  bug 
  661.              reports, please send them to Richard Ascheri via:
  662.  
  663.                             GENIE: AMIGAMAN
  664.                               BBS: RANDOM ACCESS, SYSOP
  665.                                    (714) 521-6386
  666.                                    PC EXCHANGE, Rick Ascheri
  667.                                    (714) 956-5468
  668.  
  669.              Also,  if you find the program useful why NOT go  ahead  and 
  670.              order  the  source code for it, especially  if  you've  just 
  671.              purchased your Turbo Pascal 4.0 Compiler.
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.         Copyright (c) 1987 Omni Software Associates
  709.         TLIST.EXE               Version 2.3                   12/18/87
  710.         Turbo Pascal Source Code Lister                    
  711.  
  712.  
  713.                               ORDERING INFORMATION
  714.  
  715.  
  716.              To  order the source code for TLIST.EXE include $25.00  with 
  717.              the  order form and mail to the appropriate mailing  address 
  718.              as   listed  below:
  719.  
  720.                                 Attn: Richard Ascheri    
  721.                                 Omni Software Associates 
  722.                                 15027 Watkins,
  723.                                 La Mirada, CA.  90638
  724.  
  725.              You  will receive an IBM formatted 360K diskette  containing 
  726.              the  source code and all library files necessary to  compile 
  727.              the source code and create a new TLIST.EXE file.
  728.  
  729.              Payment by:   ( ) Check   ( ) MoneyOrder
  730.  
  731.              Make Checks & Money Orders Payable To:  Richard Ascheri
  732.  
  733.  
  734.                Name: ____________________________________________________
  735.  
  736.             Company: ____________________________________________________
  737.  
  738.             Address: ____________________________________________________
  739.  
  740.                    : ____________________________________________________
  741.  
  742.                    : ____________________________________________________
  743.  
  744.           Day Phone: ______________________ Eve: ________________________
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.         Copyright (c) 1987 Omni Software Associates
  768.