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