home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / c / tools / formatte / clist / cl.doc next >
Encoding:
Text File  |  1988-05-01  |  27.8 KB  |  727 lines
  1.                   Documentation for Clist, version 05.01.88
  2.  
  3.  
  4.  
  5.          
  6.  
  7.                  CLIST
  8.  
  9.         C Source listing utility    
  10.  
  11.                                       by
  12.  
  13.                                   John Hardin
  14.  
  15.                                           
  16.  
  17.                
  18.               Clist is a utility for listing "C" language source files  
  19.          with  various formatting options.  Available options  include  
  20.          highlighting  of keywords,  graphic connection of { }  pairs,  
  21.          forcing  of  a  new page at the beginning/ending  of  include  
  22.          files  and/or functions,  and cross-reference  of  functions,  
  23.          variables and constants.
  24.  
  25.               Clist does the following formatting automatically: Pages  
  26.          are  numbered and titled as to date of listing,  source  file  
  27.          being  listed  and include file currently being  listed.  The  
  28.          source  file can also specify two lines of title  text  which  
  29.          can be changed at any time.
  30.  
  31.               Clist   will   include  files  specified   in   #include  
  32.          statements.  Depth of inclusion is effectively unlimited, and  
  33.          inclusion  may be controlled by directives within the  source  
  34.          file. Clist will search specified paths for #include files.
  35.  
  36.               Clist  will  print  multiple copies of  multiple  source  
  37.          files  from  one invocation of  the  Clist  program.  Clist's  
  38.          output  is sent to the standard output,  so it can be sent to  
  39.          either  the  printer  or a file  using  the  DOS  redirection  
  40.          facilities.
  41.  
  42.               Clist  can  be  reconfigured for use  on  a  variety  of  
  43.          printers  with  a great deal of ease,  through the use  of  a  
  44.          configuration file that Clist references upon execution.
  45.  
  46.               Clist  requires MS-DOS version 2.0 or  later,  at  least  
  47.          256k  of RAM,  and a printer (the printer being handy but not  
  48.          absolutely essential).  Clist has also been tested and  works  
  49.          under SCO VP/ix version 1.0,  but it displays some minor bugs  
  50.          that  don't occur with normal MS-DOS.  A Xenix version is  in  
  51.          the works... 
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                        1
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                   Documentation for Clist, version 05.01.88
  68.  
  69.  
  70.                                  RUNNING CLIST
  71.  
  72.               To  get  a brief description of the Clist  command-line,  
  73.          type: 
  74.  
  75.          A>CL
  76.  
  77.               This will display the command line format as well as the  
  78.          switches Clist recognizes.
  79.  
  80.               The basic command line format for calling Clist is:
  81.  
  82.          A>CL {-switch} ufn {{-switch} ufn} >destination
  83.  
  84.          where {...} means ... is repeated zero or more times.
  85.  
  86.               Valid  switches consist of a dash `-' followed by one or  
  87.          more letters or a numeral, depending on the switch. The valid  
  88.          switches are:
  89.  
  90.                    -G     Control graphics connection of { } pairs
  91.  
  92.                    -H     Control highlighting of keywords. 
  93.  
  94.                    -S     Initially suppress listing the source code
  95.                           (useful for getting just a cross-reference).
  96.                           A /*.list*/ will start listing source code.
  97.  
  98.                    -I     Initially list include files. If you don't
  99.                           want to list includes and you don't want to 
  100.                           edit the files to put in a /*.noincl*/, say 
  101.                           CL -!I ...
  102.               
  103.                    -PBI   Force a new page at the beginning of
  104.                           each included file.
  105.  
  106.                    -PAI   Force a new page at the end of each
  107.                           included file.
  108.  
  109.                    -PBF   Force a new page at the beginning of
  110.                           each function.
  111.  
  112.                    -PAF   Force a new page at the end of each
  113.                           function.
  114.  
  115.                    -C &   Cross-reference functions and
  116.                    -CFV     variables/constants
  117.  
  118.                    -CF    Cross-reference functions only
  119.  
  120.                    -CV    Cross-reference variables/constants only
  121.  
  122.                    -CG    Cross-reference across all files on command
  123.                           line (also -CGF and -CGV) 
  124.  
  125.  
  126.  
  127.                                        2
  128.  
  129.  
  130.  
  131.  
  132.  
  133.                   Documentation for Clist, version 05.01.88
  134.  
  135.  
  136.               The -C, -G, -H, -S, -I and -P switches work as follows:
  137.  
  138.                    -switch     Turn function on.
  139.                    -!switch    Turn function off.
  140.  
  141.               These are samples of valid Clist command lines:
  142.          
  143.          A>cl -c-g hack.c >prn
  144.  
  145.               Clist  will  list  the  file  HACK.C,  cross-referencing  
  146.          functions and variables and graphically connecting { } pairs,  
  147.          and will send the listing to the printer.
  148.  
  149.          A>cl -paf clib >prn
  150.  
  151.               Clist  will list the file CLIB.C,  forcing a new page at  
  152.          the  end of each function,  and will send the listing to  the  
  153.          printer.
  154.  
  155.          A>cl homework. >hmwk.lst
  156.  
  157.               Clist will list HOMEWORK doing no fancy formatting,  and  
  158.          will  send  the  listing to the file HMWK.LST  for  spooling,  
  159.          archiving,   etc.  Note  the  difference  from  the  previous  
  160.          example!  The  hanging  period  overrides  the  automatic  .C  
  161.          assumption.
  162.  
  163.          A>cl -cf proga.c -!c progb.c >prn
  164.  
  165.               Clist  will list PROGA.C,  cross-referencing  functions,  
  166.          and  will  send the listing to the printer.  Clist will  then  
  167.          list  PROGB.C without cross-referencing,  and will  send  the  
  168.          listing to the printer. In this case, it would be less effort  
  169.          to say:
  170.  
  171.          A>cl progb.c -cf proga.c >prn
  172.  
  173.          which  would produce the same results,  albeit  the  listings 
  174.          would be in different order.
  175.  
  176.          A>cl -cg mod1 mod2 mod3 > xx
  177.  
  178.               Clist  will  list modules mod1.c,  mod2.c and mod3.c  to  
  179.          file xx, then will list a cross-reference for all three files  
  180.          (useful   for  finding  global  variables  and   cross-module  
  181.          function calls)
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.                                        3
  194.  
  195.  
  196.  
  197.  
  198.  
  199.                   Documentation for Clist, version 05.01.88
  200.  
  201.  
  202.                               SEARCHING FOR FILES
  203.               
  204.               If  you  wish to list source or #include files that  are  
  205.          not  in  the current directory,  you may specify  that  Clist  
  206.          search for them in other directories or other disks,  similar  
  207.          to  the way MS-DOS searches for .COM and .EXE files.  If  the  
  208.          environment  variables  INCLUDE  or  EINCLUDE  exist,   Clist  
  209.          assumes they specify which directories or drives needed files  
  210.          are to found in or on.  The search paths must be separated by  
  211.          semicolons and must not have embedded spaces. For example,
  212.  
  213.          A>set include=c:\prog\c\incls;c:\prog\c\headrs;b:\
  214.  
  215.          would tell Clist to look for files in the current  directory,  
  216.          then  in  the directory named C:\PROG\C\INCLS,  then  in  the  
  217.          directory  named  C:\PROG\C\HEADRS,  then  in B:\  (the  root  
  218.          directory of the B:  drive). If the needed file is not in any  
  219.          of these directories, Clist will not list that file.
  220.  
  221.               You  can also specify an alternate environment  variable  
  222.          in  the  configuration file if your C compiler does  not  use  
  223.          INCLUDE  or  EINCLUDE.  If you specify an alternate  it  will  
  224.          replace EINCLUDE.
  225.  
  226.  
  227.                                CLIST DIRECTIVES
  228.  
  229.               The  behavior of Clist is also controlled by  directives  
  230.          embedded  within the source code.  These directives all begin  
  231.          with a period, and all occur within comments. Clist will only  
  232.          see directives that are in the first level of comments,  so a  
  233.          directive can be rendered ineffective without removing it  by  
  234.          placing   a  second  set  of  comment  delimiters  around  it  
  235.          (assuming, of course, your compiler will allow comments to be  
  236.          nested):
  237.  
  238.                          /* .seen  /* .ignored */  */
  239.  
  240.               Valid  directives consist of a period followed by one or  
  241.          more  letters.  Only  as many letters as needed  to  uniquely  
  242.          specify a directive must be typed,  meaning `.p' is the  same  
  243.          as `.page'. The valid directives are:
  244.  
  245.               .page       force a new page after printing this line
  246.  
  247.               .title      The text that follows up to the first */, 
  248.                           excluding leading blanks, one formatting 
  249.                           character at the beginning and trailing 
  250.                           blanks, is to be printed as the first line 
  251.                           of the page title.
  252.  
  253.               .subtitle   The text that follows (as above) is to be
  254.                           printed as the second line of the page 
  255.                           title.
  256.  
  257.  
  258.  
  259.                                        4
  260.  
  261.  
  262.  
  263.  
  264.  
  265.                   Documentation for Clist, version 05.01.88
  266.  
  267.  
  268.               .author     The text that follows (as above) is to be 
  269.                           printed as the author's name, job code, etc.
  270.  
  271.               .nolist     Suspend output of the listing after
  272.                           printing this line.
  273.  
  274.               .list       Resume output of the listing, beginning with
  275.                           this  line.  (Default  unless -S on  command  
  276.                           line)
  277.  
  278.               .noinclude  Suspend inclusion of files appearing in
  279.                           #include statements.
  280.  
  281.               .include    Resume inclusion of files appearing in
  282.                           #include statements. (Default)
  283.  
  284.               .nofunction Suspend listing the current function's name  
  285.                           at the top of each page. (Default)
  286.  
  287.               .function   Resume listing the current function's name  
  288.                           at the top of each page.
  289.  
  290.               .lzero      Print  page numbers  with  leading  zeroes.  
  291.                           (Default)
  292.  
  293.               .nolzero    Print page numbers without leading zeroes.
  294.  
  295.               The text in .title, .subtitle and .author directives may  
  296.          be  formatted  by  placing one of  the  following  characters  
  297.          before the text:
  298.  
  299.                    `|'    Print the text centered on the page.
  300.  
  301.                    `>'    Print the text right-flush on the page.
  302.  
  303.                    `<'    Return the text to it's previous value.
  304.  
  305.                    '0'    Create a new, empty text string. 
  306.  
  307.               If no formatting characters appear,  the text is printed  
  308.          flush left. All leading and trailing blanks are stripped. For  
  309.          example,
  310.  
  311.          /*.title | C program */
  312.  
  313.          would  make the first line of the title "C program"  centered  
  314.          in the page, and
  315.  
  316.          /*.t < last title */
  317.  
  318.          will  make the title whatever it was before the  last  .title  
  319.          directive. The "last title" is ignored.
  320.           
  321.               A  suggested way to use .title and .subtitle is to  make  
  322.          the first line of the main source file set the title text  to  
  323.  
  324.  
  325.                                        5
  326.  
  327.  
  328.  
  329.  
  330.  
  331.                   Documentation for Clist, version 05.01.88
  332.  
  333.  
  334.          a  short  description of the entire program,  then  have  the  
  335.          first  line  of  each file set the subtitle text to  a  short  
  336.          description of that file.  Each include file would then do  a  
  337.          /*.st<*/ at it's end to restore the previous subtitle. 
  338.  
  339.                              AUTOMATIC FORMATTING
  340.  
  341.               Clist automatically titles each page with a line telling  
  342.          when the listing was produced,  what the main source file is,  
  343.          and which include file is currently being listed.  Each  page  
  344.          is numbered.
  345.  
  346.               Each  line  is  preceded by two numbers separated  by  a  
  347.          slash.  The  first  number is the number of the line  in  the  
  348.          entire listing.  The second number is the number of the  line  
  349.          in the file it appears in. For example,
  350.  
  351.          1000/100    blah blah blah blah
  352.  
  353.          means  this line is the 1000th line of the listing,  and  the  
  354.          100th line in the file being listed.  This makes it easier to  
  355.          pinpoint an error after finding it in the listing.
  356.             
  357.               The format for cross-reference entries is:
  358.  
  359.               Name of token
  360.               page of listing this occurrence appears on
  361.               listing line this occurrence appears in
  362.               name of the file this occurrence appears in
  363.               line this occurrence appears in within that file 
  364.               name of the function this occurrence appears in, or
  365.                 "defined" if it doesn't appear inside a function.
  366.  
  367.  
  368.                               CONFIGURATION FILE
  369.  
  370.               If  the  file CL.CNF exists in the current directory  or  
  371.          along PATH, or an alternate file specified in the environment  
  372.          variable CLCONFIG exists,  Clist will treat it's contents  as  
  373.          configuration  information,  and will open and read it before  
  374.          beginning   the   listing  process.   The  format   for   the  
  375.          configuration file is as follows:
  376.  
  377.               # COMMENT - Everything on a line after a # is ignored
  378.               # blank lines are also ignored.
  379.               # In both commands and arguments (except for literal
  380.               # characters), case is ignored, so WiDTh == width
  381.  
  382.               # Values may be specified in six ways:
  383.               # . decimal numbers 0 to 255 
  384.               # . hexadecimal numbers x0 to xFF
  385.               # . octal numbers o0 to o377
  386.               # . control characters ^O, ^Z, etc.
  387.               # . literal characters 'G', '|', etc.
  388.               #   in literal characters the following MUST be escaped
  389.  
  390.  
  391.                                        6
  392.  
  393.  
  394.  
  395.  
  396.  
  397.                   Documentation for Clist, version 05.01.88
  398.  
  399.  
  400.               #   with a preceding \ character: ,;'#\ and whitespace
  401.               # . the escape character, esc
  402.               # 27, x1b, ^[ and ESC are all equivalent.
  403.  
  404.               width = 132; # This specifies the width in characters of
  405.                            # a printed line, after the printer initial-
  406.                            # ization string has been sent, is 132.
  407.               margin = 5;  # This specifies to leave a five-space margin
  408.                            # at the left edge of the paper (for hole
  409.                            # punches, etc.)
  410.               length = 66; # This specifies the length of the paper in
  411.                            # lines after the printer initialization
  412.                            # string has been sent is equal to 66.
  413.               depth = 8;   # This specifies that Clist will allow 8
  414.                            # spaces for block connection at first.
  415.               tabs = 4;    # This specifies that tab characters will
  416.                            # be expanded to simulate tab stops every
  417.                            # 4 characters.
  418.               search = "INCLUDE";  # Additional environment variable
  419.                            # to use as a path to find #include files - the 
  420.                            # only one that accepts a string argument. 
  421.                            # Escape special characters ,;'"#\ and whitespace!
  422.                            # The string MUST be capitalized.
  423.               # Printer control strings (PCSs) may be up to sixty (60)
  424.               # characters in length, and may contain zero bytes (\0).
  425.               # Bytes in a PCS are separated by a comma, and the PCS
  426.               # is terminated by a semicolon.  A PCS may be zero 
  427.               # length, in which case it is not sent to the printer.
  428.               # Examples:
  429.  
  430.               init = ^o;  # sets the printer initialization PCS to
  431.                           # one character, namely a ^O.
  432.               init = 15;
  433.               init = xf;  # Both are equivalent to the above. 
  434.  
  435.               normal = esc,'G';  
  436.                           # PCS NORMAL is sent to the printer
  437.                           # upon completion of a listing.
  438.  
  439.               # The other PCS commands are:
  440.  
  441.               bdark ;   # Code sent to begin emphasizing text
  442.                         # (used to highlight keywords).
  443.                         # This is how a zero-length PCS is coded.
  444.               edark ;   # Code sent to end emphasizing text
  445.               bcntl ;   # Code send before a control code
  446.               ecntl = 27, # Code send after a control code
  447.                      'G', # (In the listing Clist produces, control 
  448.                      xff; # codes are mapped to letters, meaning
  449.                           # a ^O in the source will become 
  450.                           # (bcntl)O(ecntl)
  451.                           # PCSs may be split across lines.
  452.               hline ;   # Code to produce horizontal line when
  453.                         # connecting { } pairs
  454.               vline ;   # Code to produce vertical line as above
  455.  
  456.  
  457.                                        7
  458.  
  459.  
  460.  
  461.  
  462.  
  463.                   Documentation for Clist, version 05.01.88
  464.  
  465.  
  466.               tcrnr ;   # Code to produce top corner as above
  467.               bcrnr ;   # Code to produce bottom corner as above
  468.               #      ,-   tcrnr hline
  469.               #      |    vline
  470.               #      `-   bcrnr hline
  471.               double = true;
  472.               # DOUBLE is a special case: if your printer does not do
  473.               # any special effects, you may still emphasize keywords
  474.               # by specifying double = true, which will cause Clist to 
  475.               # emphasize keywords by printing letter(backspace)letter.
  476.               # Otherwise, leave DOUBLE out of your .CNF file.
  477.  
  478.               Clist defaults to using codes for an Epson MX-80 without  
  479.          Graftrax.  CL.CNF is not required for the operation of Clist,  
  480.          and  may  be  left  off  if your  printer  is  an  MX-80  (or  
  481.          equivalent).
  482.  
  483.               Configurable characteristics and their keywords are:
  484.  
  485.                 KEYWORD               CHARACTERISTIC
  486.                                       
  487.                 width                 printer line width in characters
  488.                 length                printer page length in lines
  489.                 margin                margin at left edge for binding
  490.                 depth                 space allowed for nesting
  491.                 tabstops              number of spaces for a TAB
  492.                 searchpath            secondary search path env. var.
  493.                 initialize            printer initialization PCS
  494.                 normal                return printer to normal PCS
  495.                 bdark                 PCS to begin highlighting
  496.                 edark                 PCS to end highlighting
  497.                 doublestrike          Highlight by doublestriking?       
  498.                 bcntl                 PCS before a control character
  499.                 ecntl                 PCS after a control character
  500.                 hline                 horizontal connection line
  501.                 vline                 vertical connection line
  502.                 tcrnr                 top corner of connection line
  503.                 bcrnr                 bottom corner of connection line
  504.  
  505.  
  506.                           Miscellaneous other garbage
  507.  
  508.               Clist  is  a  being distributed under a variant  of  the  
  509.          Freeware system, so you are allowed (even encouraged) to make  
  510.          copies  of the Clist archive,  and to donate those copies  to  
  511.          your friends, enemies and total strangers, and to upload them  
  512.          to your favorite (and not so favorite) bulletin boards.
  513.  
  514.               Clist is available free of any monetary obligation,  but  
  515.          if  you  use  the program regularly  and  like  it,  a  small  
  516.          donation  to the author would be welcomed ($20 is suggested).  
  517.          In addition,  if you send a blank,  formatted disk and return  
  518.          postage  with your donation,  you will get a complete copy of  
  519.          the latest version of Clist.  Also,  if you have any  gripes,  
  520.          comments or suggestions, please don't hesitate to write.
  521.  
  522.  
  523.                                        8
  524.  
  525.  
  526.  
  527.  
  528.  
  529.                   Documentation for Clist, version 05.01.88
  530.  
  531.  
  532.  
  533.               Along  with  this  distribution scheme go  a  few  small  
  534.          responsibilities that you should fulfill:
  535.  
  536.                    o Since the sign-on message isn't offensive,
  537.                      don't alter it.
  538.                    o Also, don't tinker with the program or 
  539.                      documentation then distribute the results 
  540.                      as the original item.
  541.                    o Clist is a stand-alone program, but it's 
  542.                      nice to have the documentation, too. Don't
  543.                      split them up.
  544.                    o You MAY NOT charge a fee for distribution of 
  545.                      copies of the program or documentation.
  546.  
  547.               These  are not difficult to follow,  and are directed at  
  548.          making life easier for the guys on down the line.
  549.  
  550.  
  551.              "The first thing we do, let's kill all the lawyers."
  552.                                                      - Shakespeare
  553.                                                  (probably a misquote)
  554.  
  555.                                   DISCLAIMER
  556.  
  557.               In  no event shall the author of this program be  liable  
  558.          for any damages,  material or otherwise, arising from the use  
  559.          (or misuse) or this program. Suitability and functionality of  
  560.          this program is not guaranteed.  The responsibilities of  the  
  561.          author  shall  be limited to supplying a replacement copy  of  
  562.          the archive,  providing the conditions stated above have been  
  563.          met.
  564.  
  565.                            Misfeatures and warnings
  566.  
  567.               Clist is great at producing large volumes of output.  Be  
  568.          careful  when  trying to list large  files,  especially  when  
  569.          cross-referencing.
  570.  
  571.               Clist sees program name extensions as directives if they  
  572.          are  in  comments,  so you may get some  "Unknown  Directive"  
  573.          warnings.   Clist   ignores   the  standard  ".c"  and   ".h"  
  574.          extensions,  so in most cases this particular annoyance won't  
  575.          occur.  Putting program names and abbreviations (i.e. "i.e.")  
  576.          two comment levels deep will prevent this.
  577.  
  578.               If  you  are prototyping functions,  the semicolon  that  
  579.          comes after the formal parameter list or parameter types must  
  580.          be  on  the  same  line as  the  beginning  of  the  function  
  581.          prototype,  otherwise  Clist  will  see the  prototype  as  a  
  582.          function  definition.   The  same  holds  true  for  function  
  583.          declarations.
  584.  
  585.               Also,  function definitions, declarations and calls that  
  586.          span lines, i.e.:
  587.  
  588.  
  589.                                        9
  590.  
  591.  
  592.  
  593.  
  594.  
  595.                   Documentation for Clist, version 05.01.88
  596.  
  597.  
  598.          
  599.          func
  600.          (a,b,c)
  601.          
  602.          will  be interpreted as variables rather than functions  when  
  603.          cross-referencing. Declare functions and prototypes like this  
  604.          to be safe:
  605.          
  606.          void func(int a, int b);
  607.                                 ^ on the same line for prototypes!
  608.  
  609.               And if you write null functions like this:
  610.          
  611.          null()
  612.          {}
  613.          
  614.          Clist  won't  be able to tell where the function  ends.  This  
  615.          won't cause any problems, except perhaps cosmetic ones if you  
  616.          are  using  the  .function directive.  Put the  {  and  }  on  
  617.          separate lines.
  618.  
  619.               If you have downloaded your copy of this archive from  a  
  620.          BBS,  it  may be a subset (teaser copy) of the complete Clist  
  621.          program  described above.  If this is the case,  the  version  
  622.          number ends in S. The subset version of Clist does not cross- 
  623.          reference,  connect blocks or highlight keywords,  which  are  
  624.          Clist's  best  features.  To obtain a complete copy,  send  a  
  625.          donation  and  a  blank disk with return  postage  as  stated  
  626.          above.
  627.  
  628.               Please direct all correspondence to:
  629.  
  630.                               John Hardin, KA7OHZ
  631.                             1215 E. 1700 So. Apt. B
  632.                            Salt Lake City, UT 84105
  633.  
  634.                               Compuserve: 74076,22
  635.  
  636.                      - Be sure to read the file READ.ME -
  637.  
  638.          Comments - especially printer configuration information - are  
  639.          eagerly solicited!
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.                                       10
  656.  
  657.  
  658.  
  659.  
  660.  
  661.                   Documentation for Clist, version 05.01.88
  662.  
  663.  
  664.                                 Program history
  665.                      (minor tweaking and frobbing omitted)
  666.  
  667.                October 1986  - Development commenced, using Toolworks
  668.                                C version 3.2M
  669.               December 1986  - Ported to Data General Eclipse 
  670.                                under AOS-VS 6.00
  671.                              - Ported to Eco-C version 3.17
  672.                              - Clist released upon the unsuspecting
  673.                                public
  674.                              - Bug that prevented recognition of VOID
  675.                                and ENUM keywords fixed
  676.                              - .author and .function added
  677.                  March 1987  - Bug that prevented recognition of error
  678.                                on write fixed
  679.                              - Handling of exhaustion of cross-ref
  680.                                allocation space improved 
  681.                    May 1987  - Handling of block nesting exceeding
  682.                                space allowed for by DEPTH improved
  683.                 August 1987  - Added CONST and VOLATILE keywords to
  684.                                support Microsoft C version 5.0
  685.                January 1988  - Ported to ECOC-88 Release 4.0 
  686.                              - Changed configuration routine to use a
  687.                                generic configurator - configuration
  688.                                file format changed slightly.
  689.                              - Added searchpath, CLCONFIG, -S and
  690.                                title/subtitle/author stacks
  691.                              - Fixed source file pathname handling bug 
  692.                  April 1988  - Ported to Turbo C version 1.5
  693.                              - Recompiled using compact model, allowing
  694.                                access to 1M of data
  695.                              - Added -I command line switch
  696.                              - Lots of minor bugs squashed
  697.                              - Compiled a '286 version
  698.                              - Expanded PCSs to 60 characters for 
  699.                                laserjets and other talkative printers 
  700.                              - Added command-line wildcard expansion
  701.                                (Thanks to John Maline's Turbo-C module 
  702.                                ARGV from BIX)
  703.                     May 1988 - Added global cross-referencing
  704.                              - Modified connecting lines to leave only
  705.                                one leading blank before the program
  706.                                text  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.                          ** end of documentation **
  722.  
  723.  
  724.  
  725.  
  726.  
  727.