home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / c / tools / codep4c1 / cp.doc < prev    next >
Text File  |  1991-11-03  |  28KB  |  731 lines
  1. INTRODUCTION
  2.  
  3. CodePrint for C is a command-line driven source code reformatter and pretty 
  4. printer for the C programming language. As a source code reformatter, 
  5. CodePrint can quickly standardize the look of your source code. As a pretty 
  6. printer, CodePrint can enhance the readabilty of your printouts. It can assist 
  7. you in understanding code during maintenance and debugging and it's a great way
  8. to print out final source code listings. CodePrint offers you many optional 
  9. customization features, enabling you to format code the way you want to see it. 
  10. The program provides on-line help, user-friendly error messages, batch 
  11. processing and print spooling to make the program easy to use.
  12.  
  13. -   Reformatter
  14.  
  15.     The reformatting features include syntax driven auto-indenting, selection 
  16.     of indent style, alignment of comments, editable keyword templates, 
  17.     adjustable tab spacing and line editing for consistent whitespace.
  18.  
  19. -   Pretty Printer
  20.  
  21.     The pretty printer optional features include flow lines to enhance the 
  22.     visualization of code structure, a header with filename, time and date, 
  23.     page breaks, page numbers, form feeds, condensed printing, doublestrike 
  24.     printing of keywords, emphasized printing of executable code, italic print-
  25.     ing of function identifiers, adjustable margins and line numbers.
  26.  
  27. -   On-Line Help
  28.  
  29.     The on-line help provides you with CodePrint command syntax and command-
  30.     line options.
  31.  
  32. -   Batch Processing and Spooling
  33.  
  34.     You can format and/or pretty print your files in batch mode by entering 
  35.     more than one file name on the command line, by using DOS wild cards or by 
  36.     specifying a file list. CodePrint will process as many files as the print 
  37.     buffer will hold. And because CodePrint makes use of the DOS print spooler,
  38.     you don't have to wait for the printer to finish before you can continue to 
  39.     use your computer.
  40.  
  41. -   Error Messages
  42.  
  43.     CodePrint provides user-friendly error messages with suggestions for 
  44.     corrective actions to assist you.
  45.  
  46.  
  47.  
  48. SYSTEM REQUIREMENTS
  49.  
  50. -   An IBM Personal Computer or "compatible" running MS-DOS or PC-DOS 
  51.     Version 3.1 or later.
  52.  
  53. -   A dot matrix, daisy wheel or laser printer is required for the pretty 
  54.     printer features. CodePrint provides support for Epson FX, IBM Proprinter, 
  55.     HP LaserJet Series II, Diablo 630, NEC 3550 and Qume Sprint 11 printer 
  56.     emulations.
  57.  
  58. -   A hard disk drive.
  59.  
  60. -   512K bytes installed memory.   
  61.  
  62.  
  63.  
  64. DISK CONTENTS
  65.  
  66. The following files are included on your product disk. You will also find these 
  67. files listed in the file named PACKING.LST.
  68.                
  69.     File Name           Description
  70.  
  71.     CP.EXE              CodePrint reformatter and pretty printer.
  72.     CP.DOC              CodePrint documentation. 
  73.     C.DEF               The keyword template for ANSI Standard C.
  74.     C.MS                The keyword template for Microsoft C and QuickC.
  75.     C.BOR               The keyword template for Borland Turbo C.
  76.     INSTALL.EXE         The installation program.
  77.     PACKING.LST         The list of all files included on the product disk.
  78.     LICENSE.DOC         The CodePrint license agreement.
  79.     ORDER.DOC           The CodePrint order form.
  80.     SHAREW.ARE          The Shareware description and license agreement.
  81.     OMBUDS.MAN          The ASP Ombudsman policy.
  82.     PROBLEM.RPT         The CodePrint problem report form.
  83.     READ.ME             The information you should read before using CodePrint.
  84.  
  85.                                                 
  86. INSTALLING CodePrint
  87.  
  88. -   Executing the Install Program
  89.  
  90.     An install program is provided for loading CodePrint onto your hard disk. 
  91.     First load the product disk into your disk drive. Enter the letter 
  92.     designation of the drive for the product disk, followed by a colon and 
  93.     press ENTER. Then type INSTALL as shown below:
  94.  
  95.         C> A:
  96.         A> INSTALL
  97.  
  98.     The install program will:
  99.  
  100.         (1) Prompt you for information about source and destination drives.
  101.         (2) Prompt you for information about your printer.
  102.         (3) Prompt you for information about your compiler.
  103.         (4) Create new directories on your hard drive.
  104.         (5) Copy program and support files to your hard drive.
  105.         (6) Create an initialization file, CPINI.BAT, and place it in the
  106.             default directory.
  107.         (7) Add the instruction, CPINI, to your autoexec.bat.
  108.  
  109.     CodePrint options that reside in the CP environment are saved in an 
  110.     initialization file each time you run the program. The initialization file
  111.     is activated when you reboot. The initialization file, CPINI.BAT will then
  112.     restore the previous CP environment with the SET CP command. The setting
  113.     for the destination drive is also restored with the SET DRIVE command.
  114.  
  115.  
  116. -   Modifying Your AUTOEXEC.BAT File
  117.  
  118.     You will need to set a path to the main directory, the DOS directory and
  119.     the CodePrint language directory. Add the following information to the
  120.     path in your AUTOEXEC.BAT:
  121.  
  122.         PATH=C:\;C:\DOS;C:\CP\C;
  123.  
  124.     CodePrint makes use of the print spooler built into the DOS PRINT command.
  125.     The PRINT /Q:queuesize switch controls the number of files that may be in
  126.     the print queue at any one time. The allowable range is 1 to 32. The default
  127.     is 10. To provide the maximum number of files in the print queue, add the 
  128.     following line to your AUTOEXEC.BAT:
  129.  
  130.         PRINT /Q:32
  131.  
  132. -   Check for DOS PRINT 
  133.  
  134.     Since CodePrint makes use of the DOS PRINT command, you will need to check 
  135.     that PRINT.COM or PRINT.EXE has been loaded in the main directory C:\ or 
  136.     the DOS directory C:\DOS. 
  137.  
  138. -   Check Your Printer Configuration
  139.  
  140.     Make sure that your printer is configured correctly by checking your 
  141.     printer manual for the proper internal switch settings. If you do not
  142.     have a printer to match the list of available configurations, you may
  143.     utilize your printer by using the default setting. However, many of the 
  144.     enhanced printer features are not available with the default setting.
  145.  
  146.  
  147. USING CodePrint
  148.  
  149. The CodePrint program is issued from the DOS command line. The format for
  150. invoking CodePrint is:
  151.  
  152.     C> CP <filespec> [options]
  153.  
  154. The file specification can be a single file, multiple files (separated by
  155. spaces), or the name of a file listing immediately preceded by the @ symbol.
  156. CodePrint will only accept file names with legal extensions. The legal 
  157. extensions of filespec for C are ".C" and ".H".
  158.  
  159. For example, a command to process a single C source file might be:
  160.  
  161.     C> CP MYFILE.C /F /J80
  162.  
  163. or a command to process multiple C source files:
  164.  
  165.     C> CP FILE1.C FILE2.C FILE3.C /F /J80
  166.  
  167. or a command to process a C source file listing:
  168.  
  169.     C> CP @MYFILES.LST /F /J80
  170.  
  171. If you create a file listing, put each file name on a separate line. You can
  172. process as many files as the print buffer will handle.
  173.  
  174. You may not want to type options each time you run the program. You can avoid
  175. the necessity for retyping the options by setting the CodePrint options just
  176. once with the DOS SET command. The format for permanently setting the CodePrint 
  177. options in a DOS session is:
  178.  
  179.     C> SET CP=[options]
  180.  
  181. For example:
  182.  
  183.     C> SET CP=/F /G1 /J80
  184.  
  185. To check the contents of the environment simply enter SET from the DOS command 
  186. line:
  187.  
  188.     C> SET
  189.  
  190.  
  191.  
  192. CodePrint OPTIONS
  193.  
  194. The following information is provided to assist you with the use of CP options. 
  195. Each option suppresses one or more features of CodePrint. In the absence of 
  196. these options all of the features are active and/or set to default values.
  197.  
  198.     /A      AUTOINDENT
  199.  
  200.             The /A option suppresses the auto-indent feature. When the auto-
  201.             indent feature is active, it provides syntax driven automatic 
  202.             indenting for code blocks and loops. The tab spacing for each 
  203.             indent level can be set with the /T option.
  204.            
  205.  
  206.     /Bn     PAGE BREAKS
  207.  
  208.             The /B option controls the pagebreak feature. The pagebreak feature 
  209.             provides a form feed at the end of each page for non-zero arguments.
  210.             Page breaks occur at the end of each page length. The length of a 
  211.             page is set by the argument n. The default value for n is 60. You
  212.             can suppress the pagebreak feature by entering 0 as an argument.
  213.  
  214.            
  215.     /C      CONDENSED PRINTING
  216.                                
  217.             The /C option suppresses the condensed printing feature. When the 
  218.             condensed printing feature is active (and with the default carriage
  219.             width), the option provides a 138 character page width if the 
  220.             printer is configured as an Epson FX or HP LaserJet Series II
  221.             printer and a 96 character page width if the printer is configured 
  222.             as an IBM Proprinter. When condensed printing is inactive, the page 
  223.             width is limited to 80 characters. Condensed printing has no effect
  224.             on Diablo 630, NEC 3550 and Qume Sprint 11 printer emulations.
  225.  
  226.            
  227.     /D      DOUBLESTRIKE PRINTING (of keywords) 
  228.  
  229.             The /D option supresses the doublestrike printing feature. When the 
  230.             doublestrike printing feature is active, it provides for double-
  231.             strike printing of keywords. Doublestrike printing is equivalent to
  232.             the BOLD typeface.
  233.  
  234.            
  235.     /E      EMPHASIZED PRINTING (of executable code)
  236.  
  237.             The /E option suppresses the emphasized printing feature. When the 
  238.             emphasized printing feature is active, it provides for emphasized 
  239.             printing of executable code. Emphasized printing is equivalent to
  240.             the MEDIUM typeface. 
  241.  
  242.  
  243.     /F      FLOW LINES
  244.  
  245.             The /F option suppresses the flow lines feature. When this feature 
  246.             is active, it provides flow lines for visualizing code blocks and 
  247.             loops. The vertical flow lines feature is dependent on the auto-
  248.             indent feature being active.
  249.            
  250.  
  251.     /Gn     PRINTER CONFIGURATION
  252.  
  253.             The /G option suppresses the printer configuration feature. You 
  254.             will need to set this option to match the dip switch settings on 
  255.             your printer. If you are not familiar with how to configure you 
  256.             printer, consult your printer manual. Then set the dip switches in 
  257.             your printer accordingly.
  258.  
  259.             Value of n          Printer Configuration (Emulation)
  260.  
  261.             0                   Other (default)
  262.             1                   Epson FX
  263.             2                   IBM Proprinter
  264.             3                   HP LaserJet Series II
  265.             4                   Diablo 630
  266.             5                   NEC 3550
  267.             6                   Qume Sprint 11
  268.  
  269.            The special printing features (COMPRESSED, DOUBLESTRIKE, EMPHASIZED,
  270.            ITALICS and UNDERLINE) are not valid for the default printer 
  271.            configuration. The italics printing feature is not a valid feature
  272.            of the IBM, DIABLO and NEC printer configurations.
  273.  
  274.  
  275.     /H      HEADER
  276.  
  277.             The /H option suppresses the header feature. When the header 
  278.             feature is active, it provides for a header at the top of each file 
  279.             listing. The header consists of the filename, time and date that 
  280.             the file was printed.
  281.  
  282.             
  283.     /I      ITALIC PRINTING (of function identifiers)
  284.  
  285.             The /I option suppresses the italicized printing feature. When the 
  286.             italicized printing feature is active, it provides for italicized 
  287.             printing of function identifiers.
  288.  
  289.             
  290.     /Jn     JUSTIFICATION (of in-line comments) 
  291.  
  292.             The /J option controls the justification (alignment) of in-line 
  293.             comments. If you want comments to be left justifed then n must be a 
  294.             positive integer. If you want comments to be right justified then n 
  295.             must be a negative integer. If n=0, then a tab is placed between 
  296.             the end of the executable code and the beginning of each comment. 
  297.             If n is non-zero, it represents the number of characters from the 
  298.             left or right edge of the printout. The default is n=-1, leaving 
  299.             all in-line comments aligned on the first column at the right edge 
  300.             of the paper.
  301.  
  302.             Value of n        Effect On In-line Comments
  303.  
  304.             zero              Tab before each comment
  305.             positive          Left justified comment on column n (from left)
  306.             negative          Right justified comment on column n (from right)
  307.  
  308.             The justification feature is dependent on the autoindent feature
  309.             being active.
  310.  
  311.              
  312.     /Kn     KEYWORD TEMPLATE
  313.  
  314.             The /K option controls the keyword template feature. The keyword 
  315.             template feature provides a limited selection of keyword templates 
  316.             supporting popular C compilers. You may also edit these files. The 
  317.             default is n=0, resulting in the use of a default keyword file.
  318.              
  319.             Value of n        C Keyword Template      Support
  320.  
  321.             0                 C.DEF                   ANSI Standard C
  322.             1                 C.MS                    Microsoft C and QuickC
  323.             2                 C.BOR                   Borland Turbo C
  324.  
  325.  
  326.     /L      LINE NUMBER
  327.  
  328.             The /L option suppresses the line numbers feature. When the line 
  329.             numbers feature is active, it provides for line numbers to be 
  330.             displayed at the beginning of each line of code.
  331.  
  332.            
  333.     /Mn     MARGIN
  334.  
  335.             The /M option controls the margin feature. The value n sets the 
  336.             number of characters to indent. The default is n=0, or no margin.
  337.  
  338.             
  339.     /N      PAGE NUMBERS
  340.  
  341.             The /N option suppresses the page numbers feature. When the page 
  342.             numbers feature is active, it provides page numbers at the bottom 
  343.             center of each page. The page numbers feature is dependent on the 
  344.             page break feature being active.
  345.  
  346.  
  347.     /O      OPTIONS
  348.  
  349.             The /O option suppresses the options listing feature. When the 
  350.             options listing feature is active, it provides a list of the option 
  351.             status in the header. The options features is dependent on the 
  352.             header feature being active.
  353.  
  354.  
  355.     /Pn     PRINTER PORT  
  356.  
  357.             The /P option controls the printer port status check activated 
  358.             prior to printing. The value n sets the number of the printer port 
  359.             to check. The default is 0, the DOS printer port LPT1. You can 
  360.             suppress the print feature altogether by assigning an invalid 
  361.             printer port to n.
  362.  
  363.             Value of n                  Printer Port         
  364.  
  365.             0                           LPT1                 
  366.             1                           LPT2                
  367.             2                           LPT3              
  368.             3                           COM1    
  369.             4                           COM2
  370.             5                           COM3
  371.             6                           COM4
  372.  
  373.             The COM1, COM2, COM3 ports work only for IBM PCs and true 
  374.             compatibles. The COM4 port is available for IBM PS/2s.
  375.  
  376.             
  377.     /Q      QUICK PRINT
  378.  
  379.             The /Q option activates the quick print macro. When the quick 
  380.             print feature is active, it provides a quick printout of the 
  381.             destination file by cancelling the following enhanced printing 
  382.             features: doublestrike, emphasized, italicized and underlined
  383.             printing. This is equivalent to the /D /E /I /U options. 
  384.  
  385.             
  386.     /R      REFORMAT
  387.  
  388.             The /R option activates the reformatting macro. It provides for 
  389.             reformatting of source files by cancelling all pretty printing 
  390.             features including: page breaks, doublestrike and emphasized 
  391.             printing, form feeds, header, italicicized printing,line numbers, 
  392.             margin, page numbers, printing, underlined printing and flow lines. 
  393.             This is equivalent to the /B0 /D /E /F /H /I /L /M /N /P-1 /U /V /X 
  394.             options. 
  395.  
  396.  
  397.     /S     SPACES
  398.  
  399.             The /S option suppresses the spaces feature. When the space feature 
  400.             is active, it provides consistent whitespace editing for each line 
  401.             of code. The spaces feature is dependent on the auto-indent feature
  402.             being active. 
  403.  
  404.         
  405.     /Tn     TAB SPACING
  406.     
  407.             The /T option controls the tab spacing feature. The tab spacing 
  408.             feature specifies the number of spaces per indent level. The 
  409.             default is n=4. The tab spacing feature is dependent on the auto-
  410.             indent feature being active.
  411.  
  412.  
  413.     /U      UNDERLINE
  414.  
  415.             The /U option suppresses the underlined printing feature. When the 
  416.             underline feature is active, it provides for underlined printing of 
  417.             subroutine identifiers.
  418.  
  419.  
  420.     /Vn     TAB CONVERSION
  421.  
  422.             The /V option controls the tab conversion feature. CodePrint 
  423.             replaces any tabs it finds in the source file with an equivalent 
  424.             number of spaces in the destination file. The value n specifies the 
  425.             number of spaces that are used to replace tabs. The default is n=8, 
  426.             resulting in 8 spaces per tab. The spaces feature is dependent on 
  427.             the auto-indent feature being active.
  428.  
  429.  
  430.     /Wn     CARRIAGE WIDTH 
  431.  
  432.             The /W option controls the carriage width option. The carriage
  433.             width option specifies the width of the printed page in decimal
  434.             inches. Legal values for carriage width are between 1.0 and 18.0 
  435.             inches. The default value of 8.0 inches allows for 1/4" margins
  436.             on each side of an 8-1/2" sheet of paper.
  437.  
  438.  
  439.     /X      EXTRA FORM FEED
  440.  
  441.             The /X option suppresses the extra form feed feature. When the 
  442.             extra form feed feature is active, it provides for a form feed at 
  443.             the end of each file printed.
  444.  
  445.  
  446.     /Yn     INDENT STYLE
  447.  
  448.             The /Y option controls the indent style of the formatted source
  449.             code. 
  450.  
  451.             Value of n      Description        Example
  452.                             
  453.             0               No Effect          if (<condition>) {<statement>}
  454.                             
  455.             1               Standard           if (<condition>) {
  456.                             K&R Indent             <statement>
  457.                             Style              }
  458.                             
  459.             2               Braces on          if (<condition>)
  460.                             Separate Lines     {
  461.                             Aligned with           <statement>
  462.                             Keyword            }
  463.                             
  464.             3               Braces on          if (<condition>)
  465.                             Separate Lines         {
  466.                             Indented Beyond        <statement>
  467.                             Keyword                }
  468.  
  469.  
  470.  
  471. CodePrint OPTIONS ARRANGED BY CATEGORY
  472.  
  473. -   REFORMAT OPTIONS
  474.  
  475.     The options listed below provide control of the CodePrint reformatting 
  476.     feature.
  477.  
  478.     /A      Autoindent               /Jn     Justification
  479.     /Kn     Keyword Templates        /R      Reformat
  480.     /S      Spaces                   /Tn     Tab Spacing
  481.     /Vn     Tab Conversion           
  482.  
  483.  
  484. -   PRETTY PRINT OPTIONS
  485.  
  486.     The options listed below in addition to the reformat options above provide 
  487.     control of the CodePrint pretty printing feature. 
  488.  
  489.     /D      Doublestrike             /E      Emphasized 
  490.     /I      Italicized               
  491.  
  492.  
  493. -   ADDITIONAL PRINT CONTROL OPTIONS
  494.  
  495.     The options listed below provide additional print control.
  496.  
  497.     /Bn     Page Breaks              /C      Compressed 
  498.     /F      Flow Lines               /Gn     Configuration
  499.     /H      Header                   /L      Line Numbers
  500.     /Mn     Margin                   /N      Page Numbers
  501.     /O      Options                  /Pn     Printer Port 
  502.     /Q      Quick Print              /W      Carriage Width
  503.     /Xn     Extra Form Feed
  504.  
  505.  
  506. REFORMATTER
  507.  
  508. The /R option should be used when you wish to format source code. This option 
  509. cancels all printing options, leaving only reformatting options toggled on. 
  510. The /R option is equivalent to /B0 /D /E /H /I /L /M /N /P-1 /W /X. If you
  511. wish to customize the formatting of your source code you may use one or more
  512. of the following options in addition to the /R option: 
  513.  
  514.     /A    Auto Indent
  515.     /Jn   Justification
  516.     /Kn   Keyword Template
  517.     /S    Spaces
  518.     /Tn   Tab
  519.     /V    Tab Conversion
  520.  
  521.  
  522. PRETTY PRINTER
  523.  
  524. All of the CP options are valid for pretty printing with two exceptions. You
  525. cannot use the /P option or the /R option. The /P option with an invalid 
  526. argument cancels printing and the /R option cancels all of the printing 
  527. options. 
  528.  
  529.  
  530. ON-LINE HELP
  531.  
  532. CodePrint provides you with on-line help displaying CP command syntax and 
  533. command-line options. To invoke the on-line help just type: 
  534.  
  535.     C> CP 
  536.  
  537. and press enter.
  538.  
  539.  
  540. BATCH PROCESSING AND SPOOLING
  541.  
  542. CodePrint provides you with three methods of batch processing. First, you may 
  543. enter more than one file on the command line. The command line is limited by
  544. DOS to 128 bytes. The file names must be separated by spaces. For example:
  545.  
  546.     C> CP FILE1.C FILE2.C FILE3.C
  547.  
  548. Second, you may use the "*" and "?" wild cards in your file specification.
  549. For example:
  550.  
  551.     C> CP *.C       
  552.  
  553.        ... or ...
  554.  
  555.     C> CP FILE?.C
  556.  
  557. Third, you may process a file listing by entering the file listing name 
  558. immediately preceded by the @ symbol. For example:
  559.  
  560.     C> CP @MYFILES.LST
  561.  
  562. The file must be in standard ASCII format. You may create these files with 
  563. any text editor. Each file name must be placed on a separate line. The number 
  564. of files you may enter in the file listing is limited to 100 when you are 
  565. reformatting source code and by the size of the print queue when you are 
  566. printing source code. You may modify the size of the print queue with the 
  567. PRINT /Q:queuesize command. Legal values for queuesize range from 1 to 32. 
  568. The default value is 10. 
  569.  
  570. CodePrint makes use of the DOS PRINT spooler. That means you do not have to
  571. wait for the printer to finish before you can continue to use your computer
  572. for other tasks. CodePrint just loads files to print in the print queue and
  573. immediately returns control of the keyboard to you.
  574.  
  575.  
  576. KEYWORD TEMPLATES
  577.  
  578. The keyword template is list of keywords for a programming language. The 
  579. templates also contain special characters that control the auto-indent feature. 
  580. You are free to edit the templates. They are provided in ASCII format. Special
  581. characters have been added to the list of keywords for the purpose of 
  582. controlling the indenting. Below are samples of indent symbols and their 
  583. meanings:
  584.  
  585.     Symbol     Meaning
  586.  
  587.     [>         If the keyword is the first token on the line, indent right 
  588.                after the line.
  589.  
  590.     ]>         If the keyword is last token on the line, indent right after the 
  591.                line.
  592.  
  593.     <[]>       If the keyword is both the first and last (the only) token on 
  594.                the line, indent left before the line and indent right after the 
  595.                line.
  596.  
  597.     [-         If the keyword is the first token on the line, indent right on 
  598.                the next line only.
  599.  
  600.     !          This keyword signifies an exception to the indent rules and 
  601.                triggers special handling. 
  602.  
  603.  
  604. ERROR MESSAGES
  605.  
  606. The following is a complete list of error messages. You may encounter some of 
  607. them as you process source files with CodePrint. Corrective actions and/or 
  608. brief explanations are provided after each error message.
  609.  
  610. 01. Incorrect DOS version.
  611.  
  612.     CodePrint requires DOS version 3.1 or a later version.
  613.  
  614. 02. Printer not ready.
  615.  
  616.     The printer is not available, not powered on, not on-line or out of paper.
  617.  
  618. 03. Source file not found: <source file name>.
  619.  
  620.     The source file does not exist.
  621.  
  622. 04. Source code nesting too deep.
  623.  
  624.     CodePrint cannot process source files with nesting deeper than 20 indent
  625.     levels.
  626.  
  627. 05. Illegal argument in CP option: /Bn.
  628.  
  629.     The range for legal arguments to the /B option is 0 thru 60.
  630.  
  631. 06. Illegal argument in CP option: /Gn.
  632.  
  633.     The range for legal arguments to the /G option is 0 thru 6.
  634.  
  635. 07. Illegal argument in CP option: /Jn.
  636.  
  637.     The range for legal arguments to the /J option is -138 thru 138.
  638.  
  639. 08. Illegal argument in CP option: /Kn.
  640.  
  641.     The range for legal arguments to the /K option is 0 thru 3.
  642.  
  643. 09. Illegal argument in CP option: /Mn.    
  644.  
  645.     The range for legal arguments to the /M option is 0 thru 16.         
  646.  
  647. 10. Illegal argument in CP option: /Tn.
  648.  
  649.     The range for legal arguments to the /T option is 0 thru 8.
  650.  
  651. 11. Illegal argument in CP option: /Vn.
  652.  
  653.     The range for legal arguments to the /V option is 0 thru 8.
  654.  
  655. 12. Illegal argument in CP option: /Wn.
  656.  
  657.     The range for legal arguments to the /W option is 1.0 thru 18.0.
  658.  
  659. 13. Illegal argument in CP option: /Yn.
  660.  
  661.     The range for legal arguments to the /Y option is 0 thru 2.
  662.  
  663. 14. No extension supplied in source file name.
  664.  
  665.     A file name extension must be supplied for the source file name.
  666.  
  667. 15. Unrecognized source file extension.
  668.  
  669.     The recognized source file extensions for the C language are ".c" and ".h".
  670.  
  671. 16. Unrecognized CP option: <option>.
  672.  
  673.     The recognized CP options are: /A /Bn /C /D /E /F /Gn /H /I /Jn /Kn /L 
  674.     /Mn /N /O /Pn /Q /R /S /Tn /U /Vn /Wn /X /Yn /Z. 
  675.  
  676. 17. Print executive/com file not found.
  677.  
  678.     To enable printing, CodePrint requires that PRINT.EXE or PRINT.COM be 
  679.     located in the DOS directory, C:\DOS, or the main directory, C:\.
  680.  
  681. 18. Too many bytes per line.
  682.  
  683.     CodePrint cannot process source files with more than 512 bytes per line.
  684.  
  685. 19. Too many tokens per line.
  686.  
  687.     CodePrint cannot process source files with more than 250 tokens per line.
  688.  
  689. 20. Keyword file not found: <keyword file>.
  690.  
  691.     The keyword file does not exist.
  692.  
  693. 21. Too many keywords in keyword file: <keyword file>.
  694.  
  695.     CodePrint cannot process keyword template files with more than 250 keyword
  696.     entries.
  697.  
  698. 22. Source listing file not found: <source listing file>.
  699.  
  700.     The source listing file does not exist.
  701.  
  702. 23. Too many source files: <number of source files>.
  703.  
  704.     CodePrint cannot process more than 100 source files in batch mode.
  705.  
  706. 24. Print queue is full.
  707.  
  708.     CodePrint uses the DOS PRINT command to process source files in batch mode.
  709.     The number of files CodePrint can process at any one time is limited to the
  710.     number of files specified in the PRINT /Q:queuesize command. Legal values
  711.     range from 0 to 32. The default is 10.
  712.  
  713. 25. Disk is full.
  714.  
  715.     CodePrint cannot write output to the hard drive because the disk is full.
  716.     You can remedy this by freeing up space on your hard drive.
  717.  
  718. 26. The CP environment variable has not been set.
  719.  
  720.     This variable is set when you install the software. The installation 
  721.     procedure stores this value in CPINI.BAT. You can also set environment
  722.     variables from the DOS command line with SET CP=<options>.
  723.  
  724. 27. The DRIVE environment variable has not been set.
  725.  
  726.     This variable is set when you install the software. The installation 
  727.     procedure stores this value in CPINI.BAT. You can also set environment
  728.     variables  from the DOS command line with SET DRIVE=<destination drive>.
  729.  
  730.  
  731.