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