ATTENTION: This is a sample text of how to use the new printer codes for PPRINT. The PPRINT.DOC file was generated using this file. This file is not complete, but is provided for your review to learn how to use the /DF parameter and codes. P P R I N T Users Guide and Reference ------------------------------------------------------- A General purpose printing system for all computers and printers ------------------------------------------------------- Shareware by Patri-Soft (ASP Member) (714) 352-2820 (Voice) (714) 352-2825 (BBS) (714) 352-1527 (FAX) Version 5.5 September 1991 ÚÄÄÄÄÄÄÄÄÄ¿ ÚÄÄÄÄÄÁÄÄÄ¿ ³ (tm) ³ ³o ³ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ³ ÚÄÄÄÄÄÁÐÄÄ¿ ³ Association of ³ ³ ³ÄÙ Shareware ÀÄÄij o ³ Professionals ÄÄÄij º ³ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÀÄÄÄÄÐÄÄÄÄÙ * Member * Support BBS -- Patriquin's BBS 714-352-2825 (DATA) Copyright 1986, 1987, 1988, 1989, 1991 by Patri-Soft $h1 PPRINT Version 5.5 &&MTHYEAR Copyright &&YR by Patri-Soft $h2 ______________________________________________________________________ $toc $h1 PPRINT Ver. 5.5 &&MTHYEAR Copyright &&YR Patri-Soft Page &&P $h3 $T1 Introduction ------------ PPRINT is a general purpose print utility that can be used with HP laser or other printers. PPRINT will scan a directory and select files for printing. Print control parameters govern the print process. A special print feature for the HP laserjet printer allows printing two pages on both halves of a side of paper. This is especially nice for printing large documents as it saves paper and print time. PPRINT is special and unique because it is customisable to any printer type. It also allows you to access printer features not normally availaable for printing normal text files. I know there are too many command parameters for each user to learn. PPRINT has all these features to support the many different printers and features available today. I have designed PPRINT to provide be a single utility that will accomplish most all print tasks. An installation can standardize on one one print utility even though it has users with many different kinds of printers. Type the PPRINT command without parameters to get help about command parameters available. Once you learn the parameters you use most often, set up DOS batch files to make printing easier. If you have questions, problems, ideas, or requests, please don't hesitate to contact me through my online support BBS. You are allowed immediate access the first call. The number is 714-352-2825. $PAGE $T1 Command Definition ------------------ PPRINT allows many command parameter switches to be specified to customize the printing process. All these parameters are optional. The command format and switch parameters are described below. A quick review of command parameters is always available by entering the PPRINT command with no parameters. $t2 COMMAND FORMAT: PPRINT filespec [ (/ switches) ] filespec Enter a DOS file specification. Pathnames and standard DOS wildcard characters are allowed. $BARS You may optionally supply a file containing a list of input file names. Create a file containing a filename or complete pathname on each line. Specify the name of this file as the filename for PPRINT and add the "@" character before the name. The list of files will be processed as if they were all specified on the input command line. For file list processing, PPRINT understands the output of the DOS DIR command. You may use the DOS redirection feature to direct DIR output to a file, edit the file to add or remove entries, and then provide this to PCOPY as input. For example: DIR A: >DIRLIST (edit dirlist) PPRINT @DIRLIST B: $BARE $T2 Command Parameters ------------------ $x3 /AP -- Set PIFONTA /AP Set printer to print using PI FONT A character set. For laser and other compatible printers. (See also Printer Definition file) $x3 /B: -- Begin with filename /B:filename When a wildcard name is supplied to indicate multiple files are to be printed, this parameter indicates to skip all files until this filename is found. $x3 /BA -- Batch processing /BA BAtch command operation. Causes PPRINT to ignore keystrokes entered during processing and to immediately end terminate processing when all printing is complete. You will not be asked to press any key to erase the print status window. $page $x3 /BM -- Bottom margin lines /BM:nn Number of lines of bottom margin $x3 /BW -- Black & WHite mode /BW Force PPRINT to use black and white screen colors instead of its normal default attributes. $X3 /C -- Compressed printing /C Sends code to printer to force compressed print. $X3 /CO: -- Multiple copies /CO:nn Specify the number of copies of each file to be printed. $X3 /Cn -- Alternate display colors /C2 /C3 These options change PPRINT's screen colors. If you like the colors they produce over the standard colors, specify them using the SET PPRINT=/C2 command. This will place them in the DOS environment where PPRINT can use them for each execution. $X3 /DB -- Double strike mode /DB Set printer to print using its Double Strike mode. (See also Printer Definition file) $BAR7 $X3 /DF Document formatting codes included /DF Document Formatting. The input file to be printed is prepared with PPRINT document formatting codes. The codes allow PPRINT to format the document with page breas, headings, footings, and Table of Contents. See the Document Formatting section of this manual more information about this feature. $X3 /DS -- Double Space /DS Double space printed output $page $X3 /D: -- Select files based on date /D:[(]xxx Date. Select files based on the relationship between [)] their last update date and the date specified. This [=] parameter includes a date or number of days value. It may also contain a modifier that reverses or modifies the use of the date specified. When xxx contains a date the date is compared to the last update date of the file. The last update date of the file is the date contained in its directory entry. The file is selected if the condition specified by the condition modifier is met. The condition modifier meanings are: '(' = Select files whose date is older than the date specified. ')' = Select files whose date is newer than the date specified. (default if none specified) '=' = Select files whose date is equal to the date specified. Date values may be specified in any of these formats: MM/DD/YY MM-DD-YY DDMMMYY 12/31/80 12-31-80 31DEC80 If xxx contains a numeric value, that positive number is used to calculate a date value a number of days prior to the current date. Then that date is used as in the calculation above. Example: /D:(1JAN86 - Process files updated before 1JAN86 /D:)1JAN86 - Process files updated after 1JAN86 /D:=1JAN86 - Process files updated 1JAN86 /D:(5 - Process files modified prior to 5 days ago /D:)5 - Process files modified within the last 5 days /D:=5 - Process files modified 5 days ago $X3 /E -- Emphasized printing /E Sends code to printer to force emphasized print. $page $X3 /EQ -- End Quick without waiting for keypress /EQ PPRINT normally asks the user to press a key before removing the print status window at the end of processing. This parameter causes PPRINT to END QUICKLY and not wait for a user key press. $X3 /EX -- Print headers with expanded print /EX Attempt to print the header and footer lines using dot matrix expanded print options. If there is not enough room on the line this option will be ignored. $X3 /F -- Add page footings with filename and page number /F Print page footings at the bottom of each page. This makes thumbing through listings to find a specific file much easier. $X3 /FC -- Set Courier type face /FC Set printer to print using Courier type face. For laser and other compatible printers. (See also Printer Definition file) $X3 /FE -- Set Prestiege Elite type face /FE Set printer to print using Prestiege Elite type face. For laser and other compatible printers. (See also Printer Definition file) $X3 /FG -- Set Gothic Type face /FG Set printer to print using Gothic Elite type face. For laser and other compatible printers. (See also Printer Definition file) $X3 /FH -- Set Helvetica type face /FH Set printer to print using Helvetica type face. For laser and other compatible printers. (See also Printer Definition file) $X3 /FL -- Set Line Printer type face /FL Set printer to print using Line Printer type face. For laser and other compatible printers. (See also Printer Definition file) $page $X3 /FP -- Add footer lines with page number only /FP Print Footer line that contains Page number only. $X3 /FT -- Set Times Roman type face /FT Set printer to print using Times Roman type face. For laser and other compatible printers. (See also Printer Definition file) $X3 /G -- Add indentation guides for C source files /G For printing C language source files. This option prints ruler lines to help follow IF and DO sets of lines down and across pages. $X3 /HD -- Add header lines with filename, date, and page /HD Print Header line that contains filename, date file was last updated, and page number. $X3 /HP -- Add header lines with page numbers only /HP Print Header line that contains Page number only. $X3 /HT -- Add headings and prompt for header title /HT PPRINT will prompt you for heading information to be placed in heading and footing lines. $X3 /HT: -- Add headings with specified text /HT:ccc Specify heading information to be placed in heading and footing lines. Since DOS does not allow spaces in command lines, enter an underline character '_' wherever you want a space printed. PPRINT will substitute a space in those positions. I.E. PPRINT *.BAT/ht:Disk_Batch_Files $X3 /IT -- Set Italics font /IT Use printers Italics print mode. (See also Printer Definition file) $page $X3 /JU -- Set printer's auto justification mode /JU Use printer's Auto Justification Mode (See also Printer Definition file) $X3 /LA -- Set printer's lasdscape mode /LA Set printer's Landscape print Mode (See also Printer Definition file) $X3 /LC -- Compress repeated spaces to a single line /LC Compress all sets of spaces to one space in each print line. $X3 /LD -- Set printer's Line Draw character set /LD Set printer to print using LINEDRAW character set. For laser and other compatible printers. (See also Printer Definition file) $X3 /LE -- Set printer's Legal character set /LE Set printer to print using LEGAL character set. For laser and other compatible printers. (See also Printer Definition file) $X3 /LJ -- Left Justify lines to be printed /LJ Left Justify each line to be printed. $X3 /LL: -- Set line length /LL:nn Number of characters to be allowed for each print line. Longer lines will be truncated. $X3 /LM: -- Set left margin size in characters /LM:nn Number of characters for the left margin. $X3 /LO: -- Print at Offset from beginning of line /LO:nn Ignore the first n characters and start printing with the nnth character in each print line. (Offset) $X3 /LP: -- Set lines per page /LP:nn Lines per page. 66 lines assumed. (11 inch * 6 lpi) $page $X3 /LPTn - Set alternate printer /LPTn Specify /LPT1 or /LPT2 or /LPT3 or /LPT4 to indicate the alternate printer PPRINT is to direct all output to. This has the same effect as specifying /PD:LPTn. Note, specification of LPT2 will cause PPRINT to attempt to use a printer definition file of PPRINT2.DEF. This allows a special printer definition file to be set up for different printers attached to your system. If the special printer definition file is not found, PPRINT will look for the standard printer definition file PPRINT.DEF. $X3 /LQ -- Set printer's Letter Quality mode /LQ When the printer has letter quality mode, this parm activates it. (See also Printer Definition file) $X3 /ML: -- Set maximum lines per file to print /ML:nn Indicate the maximum number of lines to be printed. $X3 /MP: -- Set maximum pages per file to print /MP:nn Indicate the maximum number of pages to be printed. $X3 /N -- Add line numbers at begin of each line /N Print a line number before each line printed. Useful for printing program source listings. $X3 /NC -- Ignore print control characters found in file /NC Ignore print control characters found in input lines. You may also want to specify /NE. $X3 /ND -- Ignore duplicate lines found in file /ND PPRINT will search for duplicate input lines and ignore them. This feature can be used to take any sorted text file and remove duplicate lines. $page $X3 /NE -- Do not eject paper /NE Do not eject the paper by inserting Form Feed characters. SPECIAL FEATURE: You can use this parameter to change a input file to upper case, lower case or for any of the other data manipulation features of PPRINT. This causes PPRINT to pass the file through without added print control. The following example reads file X.TXT and creates file Y.TXT and converts it to upper case and removes duplicate lines. PPRINT X.TXT/PD:Y.TXT/PU/ND/NE The next example takes the first 500 lines of file X.TXT and creates file Y.TXT. PPRINT X.TXT/PD:Y.TXT/NE/ML:500 $X3 /NF -- Ignore form feed characters found in file /NF Ignore Form Feed characters found in input files. Normally when PPRINT finds a form feed it honors it and skips to the top of the next page. With /NF specified, the form feed is removed from the input and ignored. $X3 /NI -- Ignore PPRINT= DOS Environment variable data /NI No envIronment variables. Causes PPRINT to ignore any PPRINT= DOS environment variable parameters during processing. $X3 /NT -- Do not expand tabs in file /NT Do not expand tabs in input file. $X3 /NV -- Disable PPRINT's display of lines during processing /NV Disables PPRINT display of file lines on its display during processing. $X3 /NW -- No Windows. Use standard DOS output for display /NW No Window causes PPRINT operation to write to the display like other DOS commands and not display and update a full screen status window during processing. $page $X3 /PA -- Payse before each page is printed /PA Pause before each page is printed. Use on single sheet printers to allow each new page to be placed in the printer. $X3 /PD: -- Alternate printer device or filename /PD:xxxx Alternate print device name. /PD:LPT2 will cause all output to be directed to printer 2. LPT1 is assumed. This can also be the name of a DOS file. $X3 /PF: -- Use alternate PPRINT printer definition file /PF:xxxx Specification of an alternate printer definition file name. You may cause PPRINT to use any printer definition file you wish. Just specify the name of the file as part of the /PF: parameter as shown by the following example. Any valid DOS file name may be used. /PF:LASER2.DEF or /PF:LASER.2 $X3 /PI -- Set printer's PI font /PI Set printer to print using PI FONT character set. For laser and other compatible printers. (See also Printer Definition file) $X3 /PL -- Convert all lines to lower case characters /PL Convert all print lines to lower case. $X3 /PI -- Convert all lines to upper case characters /PU Convert all print lines to upper case. $X3 /PR -- Set printer's Proportional print mode /PR Use printer's Proportional print mode. (See also Printer Definition file) $X3 /PS -- Set printer's Print over page perferation /PS Print file over page perforation. Also consider /NE. (See also Printer Definition file) $page $X3 /P% -- Set 8.5 size type /P5 Set printer to print using 8.5 point type $X3 /P% -- Set 7 size type /P7 Set printer to print using 7 point type $X3 /P% -- Set 8 size type /P8 Set printer to print using 8 point type $X3 /P% -- Set 10 size type /P10 Set printer to print using 10 point type $X3 /P% -- Set 12 size type /P12 Set printer to print using 12 point type $X3 /P% -- Set 14 size type /P14 Set printer to print using 14 point type For laser and other compatible printers. (See also Printer Definition file) $X3 /R -- Add a ruler at the top of each page /R Print a ruler at the top of each page of output. $X3 /RE -- Enter PPRINT registration codes /RE When you register PPRINT, you will be sent a registration code and serial number. Use this option to activate registration processing. $X3 /RO -- Set printer's Roman character set /RO Set printer to print using ROMAN character set. For laser and other compatible printers. (See also Printer Definition file) $X3 /RSET - Reset printer with reset codes and end /RSET Is the opposite of /SET parameter. Use to cause PPRINT to send printer reset codes to reset the printer as if PPRINT processing for the specified command were terminating. Allows you to reset the printer for other applications. $X3 /RX -- Set printer's ROMANX character set /RX Set printer to print using ROMANX character set. For laser and other compatible printers. (See also Printer Definition file) $page $X3 /S -- System - Scan all directories for files to print /S laSer printer. 2-up side by side page printing in compressed format. Requires lanscape font. This may be used with /2D or /2E or /PA to get double sided output on laser printer. $X3 /SC -- Set printer's Script character set /SC Use printers Script print mode. (See also Printer Definition file) $X3 /SET -- Use PPRINT to set printer options. Do not print a file /SET Changes the function of PPRINT. When /SET is specified, PPRINT will send all appropriate control codes to set the printer for processing and will terminate. No files will be printed. This parameter allows you to take advantage of PPRINT printer setup features for other applications, $X3 /SL: -- Start printing starting at file line number /SL:nnn Start or restart printing with the nnth line of the file. Previous lines will be skipped. $X3 /SP: -- Start printing starting at page number /SP:nnn Start or restart printing with page number nnn. Previous pages will be skipped. $X3 /S6 -- Set printer to 6 lines per inch /S6 Use printer's 6 line per inch mode. (See also Printer Definition file) $X3 /S8 -- Set printer to 8 lines per inch /S8 Use printer's 8 line per inch mode. (See also Printer Definition file) $X3 /T -- Test PPRINT command. Do not print /T Test the command. Use this switch when you would like to test the command entered without actually printing any files. Messages will indicate what will happen if the command is executed without the /T switch. $page $X3 /TB: -- Start printing when text found in file /TB:xxx Specify text to be located in the input file. When the text is found, the following data will be printed.