Der Mediaplex Sampler - Die 6 von Plex

home *** CD-ROM | disk | FTP | other *** search

/ Der Mediaplex Sampler - Die 6 von Plex / 6_v_plex.zip / 6_v_plex / DISK5 / DOS_33 / PCPS730.ZIP / PCPS.MAN < prev next >

Wrap

Text File | 1993-02-25 | 18KB | 416 lines

PCPS(V7.30) PCPS(V7.30) NAME PCPS.EXE - convert text to postscript SYNOPSIS PCPS [-arg1 -arg2 -arg3 ... -argn] [filename(s)] DESCRIPTION PCPS reads in text files, converts them to POSTSCRIPT and outputs them to a POSTSCRIPT printer, a file or stdout. If no input files are specified, PCPS will take its input from stdin. Many attributes such as fonts, headings, orientation, various formatting options etc. may be specified. The various arguments are detailed below. Any field enclosed in <> is mandatory for that argument but those enclosed in [] are optional: -? or ? or (no arguments AND no stdin pipe) This will give you a multiple page help screen. -l List available font codes. ALL other arguments are ignored when -l is used. -#[n] Print line numbers. If "n" is not specified, the line numbers default to 4 digits but are set to "n" digits when "n" is specified. "n" can be a maximum of 6. The number of digits is automatically increased should the line numbers exceed the number able to be specified by the current number of digits. EXAMPLE: -# print line numbers and start with 4 digits. -#3 print line numbers and start with 3 digits. * -#- Do NOT print line numbers. -a<o|e> Print alternate pages where o = ODD and e = even. This is useful when double sided printing is required. EXAMPLE: -ao print only odd pages. * -a- Turn OFF alternate page printing - print both odd and even. -b Disable banner printing. * -b- Enable banner printing. -c Truncate (Cut) lines longer than the maximum number of characters allowed in the current mode. * -c- Disable trancation of lines - wrap them instead. -db Debug - download the extended postscript error handler to the printer before the print job. This error handler causes the printer to output any errors on paper as well as back along its comms line. Use this option carefully as, on many printers, this causes a permanent change to its error handling routine. This option should only be used as a last resort if, for any reason, your printer refuses to print the output from PCPS and you are unable to monitor your printers errors; E.g. Most spoolers have a log file and any errors output by the printer are normally placed into this file, but access to this file may be impractical. * -db- Disable debug mode. -dl Delete the input file(s) after successful processing. **************** USE WITH CAUTION ******************* PCPS will consider the file processed successfully if it receives no errors during the processing and will delete the input file. Be aware that print jobs can sometimes get lost, especially on networks. * -dl- Do NOT delete the input file. -dm Disable memory sorting in inverse print mode (-i). This is useful if, for any reason, a memory allocation error is reported whilst processing your document. * -dm- Enable memory sorting in inverse print mode (-i). -dr Enable draft print mode where the word "DRAFT" is printed in light grey on the background of each page behind the text. This is functionally equivalent to the argument "-kDRAFT". * -dr- Disable all background printing including any text specified with the "-k" argument. -e<l|r|t|b><n> Set the specified margin (Edge) to be "n" points (1/72 inch) where l = Left, r = Right, t = Top and b = Bottom. EXAMPLE: -el72 set the left margin to 1 inch. The default margins are as follows: | Left Right Top Bottom ----------+--------------------------------------- Portrait | 36p(.50") 18p(.25") 36p(.50") 36p(.50") Landscape | 18p(.25") 18p(.25") 36p(.50") 18p(.25") * -e- Set the margins back to their defaults. -f<[font code][size]> This argument is used to set the font type and/or the font size. The "font code" is the abbreviated code for the font which is listed by the "-l" option. The size is in points. See SUPPORTED FONTS. EXAMPLE: -fhn12 set font to Helvetica Narrow with the size of 12 point. * -f- Set the font and size to the defaults. -g or -gonewordcomment or "-gmultiple word comment" Print a gaudy banner at the top of the page containing the files last modification date, the current page number, the file name and an optional comment. Please note that the -g and the comment must be enclosed in quotes if there is more than one word in the comment. EXAMPLE: -g print a gaudy banner at the top of each page. "-gMy file" print the gaudy banner but add a comment inside the banner. * -g- Disable the gaudy banner. -h<t|b>[n] Specify the paper tray (Hopper) to start with where t = Top and b = Bottom. This may be followed by an optional number which specifies the number of pages to print from this tray before switching to the other. EXAMPLE: -ht1 print the first page from the top paper tray, then switch to the bottom one. * -h- Do NOT specify any trays - use the printers default. -i Inverse page order (ie. Output the last page first). * -i- Normal page order. -k<text> Print "text" (K)omment in grey on the background of each page where "text" may be up to 40 characters. * -k- Disable background printing including any previously specified "-dr" argument. -m Enable manual paper feed - useful if you wish to use different paper than that loaded into the paper tray(s). -m1 Enable manual paper feed on the first page printed only - useful if the first page needs to be printed on letter head and you are not fortunate enough to have two paper trays. * -m- Disable all manual paper feeding. -n<n> Set lines per page to "n" lines. EXAMPLE: -n66 set the pages to 66 lines. -n- Set lines per page to the default which is to print whatever will fit on the page or until Form Feed characters are encountered. -o<path> Output postscript to <path> instead of the default LPT2 where <path> may be a filename (Eg. c:\doc\example.ps) or the name of another device (Eg. LPT1). EXAMPLE: -oC:\TEMP\EXAMPLE.PS output the POSTSCRIPT to the specified file. ***PLEASE NOTE*** If PCPS detects that its output is being piped to another program it will automatically send the postscript to stdout and totally ignore any output file specified with this argument. In this mode, PCPS sends the screen information to stderr. * -o- Use the default output file LPT2. -p<dir path> Get printer preparation data from the file PCPS.PPF under the directory <dir path>. The contents of this file are sent to the printer prior to any other output from PCPS. See SUPPORT FILES. EXAMPLE: -pC:\UTILS Use the file PCPS.PPF under the directory C:\UTILS -p- Do not use any printer preparation file. -q Quiet mode - no fancy information is displayed. For each file processed, only the number of pages printed is displayed. * -q- Noisy :-) mode with lots of information displayed. -r Rotate the print 90 degrees to Landscape orientation. * -r- Use portrait orientation. -2 Rotate to Landscape orientation and print in 2 columns. This allows two normal pages to fit on one. * -2- Use single column Portrait orientation. -s<a|u> Use paper size where a = A4 and u = US letter. EXAMPLE: -su set the paper size to US letter (11" x 8.5") * -s- Use default paper size (A4). -t[n] Expand tab characters to spaces. If "n" is specified, tabs will be expanded to "n" spaces, otherwise they will be expanded to 8 spaces. EXAMPLE: -t expand all tab characters to 8 spaces. -t4 expand all tab characters to 4 spaces. * -t- Do NOT expand tab characters; pass them through untouched. -u[n] Unlimited line length (well almost...65535 chars). If "n" is specified, set line length to "n" characters. Normally PCPS calculates the maximum line length using the font size and the available printing area but this calculation is moade assuming the non-proportional default COURIER font and is not necessarily accurate for other fonts. This argument allows the user to over-ride the calculated maximum. EXAMPLE: -u set maximum char per line to 65,535 -u60 set maximum char per line to 60 * -u- Use the default calculated maximum line length. -v<n[-|,|$> Specify page ranges to print where a range may be a single page (n), a range of pages (n1-n2) or from a page to the end of the document (n-$). Each separate range specification should be separated by a comma. EXAMPLE: -v1-12,35,50-$ print pages 1 through 12, 35 and 50 through to the end of the document. * -v- Print all pages. -x The first and last characters output by PCPS will be ^D (0x04) characters. This is required by some printers to signify end of job. * -x- Do not output ^D (0x04) characters. -z<o|e> Enable margin swapping for double sided printing on (O)dd or (E)ven pages. In Portrait mode the Left and Right margins will be swapped on the specified pages as well as the Page-number and File- -time boxes in the Gaudy header if gaudy mode is enabled. In Landscape mode the Top and Bottom margins are swapped on the specified pages. No change is performed on the Gaudy banner. * -z- Disable margin swapping. All arguments preceded by * reflect the default conditions for PCPS. Normal DOS style wildcards (* and ?) are allowed when specifying the input files. ENVIRONMENT PCPSCFG Points to a directory containing a PCPS configuration file (See SUPPORT FILES). PCPSPPF Points to a directory containing a PCPS printer prep file (See SUPPORT FILES). SUPPORT FILES PCPS can have two support files: PCPS.CFG and PCPS.PPF The Printer Preparation file (PPF) may be explicitly specified by the -p argument or explicitly disabled by -p- but if not, the method for locating both files is identical: The current directory is first searched for the file and if it is not found there, the directory that PCPS.EXE was executed from is then searched. If this also fails, PCPS checks the environment for a variable PCPS<ext> where <ext> is either CFG or PPF and checks for the existance of the file in the directory pointed to by this variable. PCPS.CFG This file can contain arguments in the same way that the command line can have arguments. The arguments may be spread over several lines and will be processed sequentially. PCPS processes arguments from this file first, should it exist, and then from the command line, so the command line arguments may over-ride the arguments in this file or even negate them. PCPS.PPF Some POSTSCRIPT printers require some setup or preparation information sent to them before the output of PCPS. This support file is provided for such purposes. Any characters contained in this file will sent to the output file before any POSTSCRIPT output from PCPS. SCREEN SUPPORT PCPS can support differing numbers of lines per screen and provides a "more" feature when listing font codes or showing usage. At the [more] prompt you may view the next screen by pressing any key other than the "q" key which will quit the output. SUPPORTED FONTS PCPS currently supports the default fonts built into an Apple Laserwriter and assumes that the target printer will "know" these fonts. Listed below are the fonts and the code for each that may be used with the -f argument: FontCode Font -------- ---- AGB AvantGarde-Book AGBO AvantGarde-BookOblique AGD AvanteGarde-Demi AGDO AvantGarde-DemiOblique BD Bookman-Demi BDI Bookman-DemiItalic BL Bookman-Light BLI Bookman-LightItalic C Courier CB Courier-Bold CBO Courier-BoldOblique CO Courier-Oblique H Helvetica HB Helvetica-Bold HBO Helvetica-BoldOblique HN Helvetica-Narrow HNB Helvetica-Narrow-Bold HNBO Helvetica-Narrow-BoldOblique HNO Helvetica-Narrow-Oblique HO Helvetica-Oblique NCSB NewCenturySchlbk-Bold NCSBI NewCenturySchlbk-BoldItalic NCSI NewCenturySchlbk-Italic NCSR NewCenturySchlbk-Roman PB Palatino-Bold PBI Palatino-BoldItalic PI Palatino-Italic PR Palatino-Roman S Symbol TB Times-Bold TBI Times-BoldItalic TI Times-Italic TR Times-Roman ZCMI ZapfChancery-MediumItalic ZD ZapfDingbats PCPS now supports most european characters in all text fonts. REQUIREMENTS DOS ONLY VERSION MS/PC DOS V2.1 is the minimum required version, though for full compatibility, DOS3.0 or greater is recommended. FAMILY MODE VERSION For running under DOS, the above requirements are true. For running under OS2 the user should require OS2 1.0 or higher though the author has only run it under OS2 2.0 and would appreciate confirmation that it runs under any other version. DIAGNOSTICS These should be fairly self-explanatory. AUTHOR Paul Carapetis Internet: pjc@melb.bull.oz.au BUGS Far too many argument letters which are far from intuitive. The author proposes to change the arguments to short words (Eg. -out, -tab etc.) where the user may specify the full word or enough letters to render it unique. The author is interested in the user's opinions on this and any other matters relating to PCPS so feel free to contact him. There has also been one report of some operating problems on one particular Novell lan - this is currently under investigation. Hopefully there are no others but sometimes they manage to sneak their ugly little heads through so the author would be extremely grateful to hear from anyone encountering any of these little beasties! NOTES POSTSCRIPT is a trademark of Adobe Systems Incorporated.