home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / printer / dprint3.arc / DPRINT.TXT < prev    next >
Text File  |  1988-04-06  |  9KB  |  206 lines
  1.                           dPrint Documentation
  2.                   (C) Copyright Daniel Doman 1986, 1987
  3.                           166 East 96th Street
  4.                           New York, N.Y. 10128
  5.  
  6.  
  7.     dPrint is copyrighted by, and is the sole property of Daniel B. Doman.
  8. You are hereby granted a single user license to use dPrint. You may not
  9. modify dPrint, resell, or otherwise charge for its use without violating this
  10. license.
  11.  
  12.  
  13.                              What dPrint Is
  14.  
  15.     dPrint is a file printing utility that formats and paginates
  16. text. It has a variety of options that allows the user to customize
  17. its output. dPrint is not intended to print formatted text. dPrint
  18. was written primarily to print program source code.
  19.     The predecessor to dPrint was called Cprint. The change was made to
  20. match the naming conventions of other programs by the author such as
  21. dBBS, DFF etc.. Other utility programs are Cmove, 3Ct, BB-Sort, QuickLink,
  22. and Picklist.
  23.  
  24.  
  25. usage - dPrint {options} file1 \\progs\\file2 {new options} ?ile3* .....
  26.  
  27.  
  28.  
  29.  
  30.                          Command Line Arguments
  31.  
  32. -Lxx          Change the lines per page from the default of 58 lines per
  33.               page. dPrint will issue a page break, and print a new header
  34.               every xx lines.
  35.  
  36.               Example:  -L112          <- Change Lines Per Page to 112
  37.  
  38. -Wxxx         Change the Width or Right margin from the default of 76
  39.               columns. dPrint will wrap lines around to the next line if text
  40.               is wider than this value. You might want to change this value
  41.               if you are printing in compressed print to a larger value. If
  42.               you want to completely disable line wrapping, you can specify
  43.               a right very large margin value such as 9999.
  44.  
  45.               Example:  -W100          <- Change Right Margin To 100
  46.  
  47. -Mxx          Set left margin. The default left margin is 0, but you can
  48.               change this to any value that you want. 
  49.  
  50.               Example:  -M12           <- Change Left Margin To 12
  51. -Odevname    Change the output device. The default output device is "PRN",
  52.               but you can change this to another printer such as LPT2 or
  53.               the name of a file. If you are printing multiple files, all
  54.               output will go to the device or file that you specify until or
  55.               unless you change the name of the output file again. The
  56.               devicename can be any legal DOS filename or physical device.
  57.  
  58.               Example:  -oDUMP.TXT       <- Change Output From PRN To
  59.                                             DUMP.TXT
  60.  
  61. -P            Show File Paths. The dPrint prints the name of each file on
  62.               each header line. The default is to strip any drive and path
  63.               from the filename. If you toggle this switch the full pathname
  64.               will be printed.
  65.  
  66. -I            Toggle indentation OFF/ON. Most program source code is
  67.               indented according to program logic. If dPrint has to wrap a
  68.               line around, it will maintain the indentation plus one space. If
  69.               indentation is turned off text wrapped around to the next line
  70.               will begin at the left margin.
  71.  
  72. -T#           Change Default Tab alignment. The default value used for Tab
  73.               Alignment is 8, the same as for PC-DOS. This is not normally
  74.               necessary, but some editors align text using a non-standard
  75.               Tab size.
  76.  
  77.               Example:  -T4         <- Change TAB alignment to every 4
  78.                                        spaces. 
  79.  
  80. -N            Show Line Numbers. This command Turns ON/OFF line
  81.               numbering. If you are debugging source code this can be very
  82.               handy.
  83.  
  84.  
  85. -RYYMMDD      Print Only Files Newer Date Specified. This command can be
  86.               used to print only recently modified files. It specifies the
  87.               lower bounds of the file date.
  88.  
  89.               Example: -R870916     <- Print only files equal to or newer
  90.                                        than 09/16/87
  91. -E           Issue An Escape Code. Escape codes can be expressed as
  92.               decimal values, or as literal text. You can issue as many
  93.               escape codes as you want. You cannot mix decimal and literal
  94.               escape codes in the same string. It is sometimes more
  95.               convenient to express "escape" in its decimal form, and the
  96.               rest of the escape code by its literal value. You can embed
  97.               ANY character in an escape string. Below are some examples.
  98.  
  99.               -EwwSSxxQQ     <-   Send the literal string "wwSSxxQQ" To
  100.                                   The Printer.
  101.  
  102.               -E\027\015     <-   Send Escape-SI (commonly puts IBM or
  103.                                   Epson Printers into Compressed mode)
  104.  
  105.               -E\027\077     <-   Send Escape-M
  106.  
  107.               -E\027 -EM     <-   Send Escape-M in two commands
  108.  
  109. -DS           Print The System Date On The Header. dPrint normally prints
  110.               the file date on each header. You can change this with this
  111.               switch.
  112.  
  113. -DF           Print The File Date (default). This is the default.
  114.  
  115. -Hheadertext  Add Text To Each Page Header. dPrint prints at the top of
  116.               each page the file date, file name, and current page number.
  117.               You can add additional text with this command. Text must be
  118.               marked either by surrounding your text with "quotes", or by
  119.               separating each word in the text with a '@'. dPrint will
  120.               continue to add this text to each page header even as it
  121.               prints several files. You can turn off the text by defining
  122.               "null" text. Below are several examples:
  123.  
  124.  
  125.               dPrint -h"MY Header" file*.txt Te?t.doc
  126.  
  127.               dPrint -hMY@Header file*.txt Te?t.doc
  128.  
  129.          Print one set of files with "Mytext Is This", and a second set with
  130.          "Your Text Is This".
  131.  
  132.               dPrint -h"Mytext Is This" a*.txt -h"Your Text Is This" b*.txt
  133.  
  134.          Print all batch files with the string "ZazuPits Is My dog", and then
  135.          all ".DAT" files with NO header text.
  136.  
  137.               dPrint -h"ZazuPits Is My dog" *.bat -h*.dat
  138. -#xxx   Suppress portions of the page header. You can suppress various
  139.          elements of the page header. Below are the values you can specify:
  140.  
  141.               D    - Suppress the Date
  142.               F    - Suppress Filename
  143.               P    - Suppress Page numbering
  144.               H    - Suppress the page header altogether
  145.  
  146.               Examples:
  147.  
  148.               dPrint -#df    foo.xxx        <<-  Suppress date & filename
  149.  
  150.               dPrint -#pd    foo.xxx        <<-  Suppress Page numbering
  151.                                                  & date
  152.  
  153.               dPrint -#h     foo.xxx        <<-  Suppress All of page
  154.                                                  header
  155.  
  156.  
  157.                          Environment Variables
  158.  
  159.          You can preset your favorite command line arguments in a "dPrint"
  160. environment variable. If you set a DPRINT environment variable with
  161. command line arguments, dPrint will read the environment variable as if you
  162. had entered them from the command line, and THEN your real command line
  163. arguments. Anything that you can enter from the command line can be
  164. loaded into your dPRINT environment variable. This is very handy for
  165. preloading escape codes for laser printers etc. Hewlett Packard escape codes
  166. are notoriously long and obnoxious to type.
  167.  
  168.          What could be more useful than a dPRINT environment variable to
  169. initialize your printer? How about an environment variable to DE-initialize
  170. your printer? The second variable is called dPRINTX. The arguments
  171. expressed in it are read in after all other arguments have been processed.
  172. Below are two sample environment variables for an imaginary printer.
  173.  
  174.     SET DPRINT=-E\027 -E[1;0r -W110 -M10 -L78
  175.     SET DPRINTX=-E\027 -EM
  176.  
  177.     Please note that the environment variables are entirely optional.
  178.  
  179.  
  180.  
  181.                             Usage Guidelines
  182.  
  183.          Command line arguments may be repeated as many times as you
  184. like. You can use them in just about any combination that you can imagine.
  185. The arguments effect ONLY those files specified AFTER the arguments. They
  186. will not effect files specified before the argument.
  187.  
  188.          As you get used to dPrint, you will find that you give it same
  189. command line arguments every time you use it. PC-DOS limits the length of
  190. your command line arguments. You can extend this, and make dPrint easier
  191. to use by taking advantage of the dPrint environment variables.
  192.  
  193.          dPrint is not intended to print preformatted text, because it wraps
  194. long lines, and generates page breaks etc. If you are determined to use
  195. dprint on formatted text anyway, you can disable most of its formatting by
  196. turning OFF the page header altogether with "-#h" and the line wrapping
  197. with "-w999", and page breaks with "-L999".
  198.                                 Changes
  199.  
  200.          Changes from the 12-20-87 version:
  201.  
  202.     dPrint sometimes incorrectly reported a printer error when it flushed its
  203. buffers at the end of a print job or between files.
  204.     dPrint only accepted a "-" for command line switches. It now accepts
  205. either a "-" or a "/".
  206.