home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 19 Printer / 19-Printer.zip / IBMCUT.ZIP / README < prev   
Text File  |  1990-01-17  |  5KB  |  88 lines
  1.                                     Phil Callihan
  2.                                 Duck Run Electronics
  3.                                 5332 Adventure Drive
  4.                                   Dublin, OH 43017
  5.                                     (614)761-0724
  6.                               CompuServe (72617, 3620)
  7.  
  8.                                Date: 17 January 1990
  9.  
  10.             OS2 IBM4019 Laser Printer Program
  11.  
  12.                  This is a printer program that we use to assist in
  13.             developing software and to deliver source code documentation
  14.             to our customers.  The program accepts multiple file names
  15.             with paths to different directories and uses the command
  16.             line wild cards '*' and '?'.  The files are sorted by name,
  17.         printed, and a index listing is produced for the print out.
  18.  
  19.                  This program uses the  Courier 17.1 font in the
  20.             portrait orientation.  Each page printed contains a header,
  21.             66 lines of text, and a footer.  The default page width is
  22.             124 characters.  The top and bottom are 1/2 inch from the
  23.             papers edge.  The right margin is 1 inch from the papers
  24.             edge to allow the use of a three ring binder.  The left
  25.             margin is 1/4 inch from the papers edge.
  26.  
  27.                  The header is printed with double strike, double
  28.             height, and double width characters.  The header can contain
  29.             a company name line and a project title line.  The header
  30.             will always have the name of the file being printed on a
  31.             line.
  32.  
  33.                  The text is printed 66 lines per page without any
  34.             special printer characteristics.  This provides a very
  35.             legible listing and still allow rooms to make notes or
  36.             comments on the paper while using the print out.  Tabs are
  37.             expanded into spaces by the program.  The tab expansion is
  38.             based on the files extension unless a program user overrides
  39.             this with a command line switch.  This program expects .c
  40.             and .h files to use a tab size of 3 and all other extension
  41.             use a tab size of 8.  This is easily changed with the source
  42.             code or the clever use of a Norton utility.
  43.  
  44.                  The footer is printed with the double strike
  45.             characters.  The footer will always print "n page of m
  46.             pages" for each file being listed.  The n denotes the
  47.             current page of the file and m denotes the last page of the
  48.             file.  If the index command line switch is set the footer
  49.             with print a master index page number of each page printed.
  50.             After the files are printed and index is produced that
  51.             allows the files to be found quickly.
  52.  
  53.                  The index is printed with a header, text, and footer as
  54.             described above.  The text in the index contains an index
  55.             page number for the first page of the file, the file name,
  56.             the number of pages in each file, the file's size, the
  57.             file's disk allocation, and the date the file was last
  58.             written.
  59.  
  60.                  The program has several command line options.  The
  61.             options are set using the '-' character as a switch.  The
  62.             options are:
  63.                  -c<arg> - Company name to be used in header,
  64.                  -p<arg> - Project title to be used in header,
  65.                  -i<arg> - Produce index,
  66.                  -d<arg> - Use an Alternate output device,
  67.                  -q      - Query for company name and project title,
  68.                  -t      - Tab conversion size,
  69.                  -w      - Set print width to 132,
  70.                  -s      - Silent don't verify printing requirements
  71.                  -u      - Usage - produce program description.
  72.             Upper or lower case characters are accepted as switch
  73.             arguments.  An example of this program use could be:
  74.  
  75. ibmcute -ic "Duck Run Electronics" -p"IBM4019 Printer Program Source Code" g:\ibmcute\source\*.c g:\ibmcute\include\*.h
  76.  
  77.             This command line would use "Duck Run Electronics" as the
  78.             company name, "IBM4019 Printer Source Code" as the project
  79.             title, and produce an index.
  80.  
  81.                  I use the program on OS2 version 1.1 and 1.2.  The
  82.             program will work with the HPFS, but it treats the files as
  83.             though the were from a FAT file system.  The program will
  84.             not work in the DOS mode because threads are used to hurry
  85.             things up.  I hope the program is as useful to you as it is
  86.             to us.  With the IBM4019 speed it is no longer painful to
  87.             get a good looking program listing.  Good job IBM!
  88.