home *** CD-ROM | disk | FTP | other *** search
/ POINT Software Programming / PPROG1.ISO / misc / source14 / readme.1st < prev    next >
Encoding:
Text File  |  1993-04-21  |  6.3 KB  |  179 lines
  1.                                    SOURCE
  2.  
  3.      SOURCE Version 1.4 - Source code file printing program
  4.      Copyright 1992, 1993 Rick Maddy
  5.  
  6.      1    Distribution
  7.  
  8.      The SOURCE program is made up of these files:
  9.  
  10.           SOURCE.EXE     The SOURCE program file.
  11.           SOURCE.DOC     The main documentation file.
  12.           SOURCE.PRT     The default printer definition file.
  13.           SOURCE.CFG     The default configuration option file.
  14.           SOURCE.LNG     The default language definition file.
  15.           README.1ST     This file.
  16.           REGISTER.TXT   Order form to register SOURCE.
  17.  
  18.      The shareware version of SOURCE is distributed as a self-
  19.      extracting compressed file.  SRCV14.EXE may be passed onto anyone
  20.      you choose, provided it remains intact, ALL files are kept
  21.      together, and only the original files are distributed.  DO NOT
  22.      compress and pass on your modified files.  If you make any
  23.      changes to the SOURCE.PRT or SOURCE.LNG files that you feel would
  24.      effect or benefit other users, please send me a copy.
  25.  
  26.      2    What is SOURCE?
  27.  
  28.      SOURCE is a program for printing source code and text files. 
  29.      However, using SOURCE to its fullest potential gives you an
  30.      extremely powerful and flexible program for printing source code
  31.      and allows for numerous options for formatting the output. 
  32.      SOURCE will usually be used to send programming source code to a
  33.      printer.  I strongly advise you to read SOURCE.DOC to understand
  34.      all of SOURCE's capabilities.
  35.  
  36.      3    Quick Start
  37.  
  38.      Before running SOURCE for the first time, make sure you have
  39.      placed SOURCE.EXE, SOURCE.PRT, SOURCE.LNG, and SOURCE.CFG all
  40.      within the same directory.  You may also wish to include this
  41.      directory in your path so that you can run SOURCE from anywhere
  42.      on your system.
  43.  
  44.      The simplest way to run SOURCE is to type:
  45.  
  46.           SOURCE filename.ext
  47.  
  48.      "SOURCE" is the program SOURCE, and "filename.ext" is the name of
  49.      the file you are going to print.  You may press the [Esc] key
  50.      anytime while a file is being printed to abort SOURCE and stop
  51.      the current file from printing.  Remember, most printers have a
  52.      buffer and the printing will probably not stop immediately.
  53.  
  54.      4    Selecting a Printer
  55.  
  56.      The first time you run SOURCE you will be asked to select your
  57.      default printer from the list of initially supported printers. 
  58.  
  59.                                    Page 1
  60.                                    SOURCE
  61.  
  62.      SOURCE supports many common printers, which should cover most of
  63.      the printers in use.  Pick the printer that matches closest to
  64.      the one that you have.  
  65.  
  66.           Note:  If none of the printers are like yours, select
  67.           the "Generic" printer for now.  You will still be able
  68.           to print files, you just won't be able to take full
  69.           advantage of SOURCE's strengths.  Later on you'll see
  70.           how to modify SOURCE.PRT to take full advantage of your
  71.           printer.  See SOURCE.DOC for more information on
  72.           printer definitions.
  73.  
  74.      This printer should be connected to printer port one, "LPT1:". 
  75.      If you are using a different port for your printer, see
  76.      SOURCE.DOC for information on changing the printer port used by
  77.      SOURCE.
  78.  
  79.      5    SOURCE Options
  80.  
  81.      Typing "SOURCE" at the command prompt with no options will give
  82.      you a few lines about the general command line syntax.  You may
  83.      type "SOURCE -?" to see a few screens showing the command line
  84.      syntax, what each option is, and the options' current defaults.
  85.  
  86.      What follows is an abbreviated list of the command line options
  87.      that SOURCE recognizes.  See SOURCE.DOC for a complete listing
  88.      and an explanation of each option.  All options are case
  89.      sensitive, so remember not to run SOURCE with your Caps Lock key
  90.      on.
  91.  
  92.  
  93.      A partial list of SOURCE options:
  94.  
  95.      Option         Description
  96.  
  97.      ?              Help.
  98.      b[-]           Block Grouping.
  99.      c{b|u|i|o|n}   Comment Highlighting.
  100.      f#             Final Line.
  101.      F#             Final Page.
  102.      h#             Header Page.
  103.      i#             Initial Line.
  104.      I#             Initial Page.
  105.      k{b|u|i|o|n}   Keyword Highlighting.
  106.      l{6|8}         Line Spacing.
  107.      n[-]           Line Numbering.
  108.      o{l|p}         Page Orientation.
  109.      p{p|e|c}       Pitch.
  110.      s{1|2|3|4}     Column Count.
  111.      t[#,]#         Tab Stop [Start and] Size.
  112.      $              Registration Info (if you like it, please register
  113.                     it).
  114.  
  115.      Remember to read SOURCE.DOC for a complete listing of options.
  116.  
  117.  
  118.                                    Page 2
  119.                                    SOURCE
  120.  
  121.      6    Final Notes
  122.  
  123.      The language file as supplied contains, among others, separate
  124.      definitions for dBASE and Clipper.  Since both languages use the
  125.      '.prg' extension, SOURCE may not properly choose the right
  126.      definition for you.  When you print a '.prg' file, SOURCE will
  127.      select the last definition it finds in SOURCE.LNG that has a
  128.      '.prg' extension.  As supplied, this will be Clipper.  If you
  129.      only program in dBASE, you have a few options to solve this:
  130.  
  131.           - You could remove the Clipper definition from SOURCE.LNG. 
  132.             This is not the best because you may need it later.
  133.  
  134.           - You could move the dBASE definition after the Clipper
  135.             definition.  This would cause SOURCE to use the dBASE
  136.             definition over the Clipper definition when it prints a
  137.             '.prg' file.
  138.  
  139.           - You could change the defined extension for Clipper to
  140.             something other than '.prg'.  The downside to this is if
  141.             you need to print a Clipper file, you have to do more
  142.             work.
  143.  
  144.           - The last option is to use the 'x' command line option to
  145.             force SOURCE to use the dBASE definition.  Example:
  146.  
  147.                     SOURCE -x dbase file.prg
  148.  
  149.             This will make SOURCE use the dBASE definition regardless
  150.             of the file's extension and any other definition that uses
  151.             the file's extension.
  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.                                    Page 3
  178.  
  179.