home *** CD-ROM | disk | FTP | other *** search
Text File | 1998-10-28 | 72.3 KB | 1,585 lines
EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) NNNNAAAAMMMMEEEE enscript - convert text files to PostScript SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS eeeennnnssssccccrrrriiiipppptttt [----11112222BBBBccccggggGGGGhhhhjjjjkkkkKKKKllllmmmmOOOOqqqqrrrrRRRRvvvvVVVVzzzzZZZZ] [----#### _c_o_p_i_e_s] [----aaaa _p_a_g_e_s] [----AAAA _a_l_i_g_n] [----bbbb _h_e_a_d_e_r] [----CCCC[_s_t_a_r_t__l_i_n_e]] [----dddd _p_r_i_n_t_e_r] [----DDDD _k_e_y[::::_v_a_l_u_e]] [----eeee[_c_h_a_r]] [----EEEE[_l_a_n_g]] [----ffff _f_o_n_t] [----FFFF _h_e_a_d_e_r__f_o_n_t] [----HHHH[_n_u_m]] [----iiii _i_n_d_e_n_t] [----IIII _f_i_l_t_e_r] [----JJJJ _t_i_t_l_e] [----LLLL _l_i_n_e_s__p_e_r__p_a_g_e] [----MMMM _m_e_d_i_a] [----nnnn _c_o_p_i_e_s] [----NNNN _n_e_w_l_i_n_e] [----oooo _o_u_t_p_u_t_f_i_l_e] [----oooo ----] [----pppp _o_u_t_p_u_t_f_i_l_e] [----pppp ----] [----PPPP _p_r_i_n_t_e_r] [----ssss _b_a_s_e_l_i_n_e_s_k_i_p] [----SSSS _k_e_y[::::_v_a_l_u_e]] [----tttt _t_i_t_l_e] [----TTTT _t_a_b_s_i_z_e] [----uuuu[_t_e_x_t]] [----UUUU _n_u_m] [----WWWW _l_a_n_g_u_a_g_e] [----XXXX _e_n_c_o_d_i_n_g] [_f_i_l_e_n_a_m_e ...] DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN EEEEnnnnssssccccrrrriiiipppptttt converts text files to PostScript and spools generated PostScript output to the specified printer or leaves it to file. If no input files are given, eeeennnnssssccccrrrriiiipppptttt processes standard input. EEEEnnnnssssccccrrrriiiipppptttt can be extended to handle different output media and it has many options which can be used to customize printouts. OOOOPPPPTTTTIIIIOOOONNNNSSSS ----#### _n_u_m Print _n_u_m copies of each page. ----1111,,,, ----2222,,,, --------ccccoooolllluuuummmmnnnnssss====_n_u_m Specify how many columns each page have. With long option --------ccccoooolllluuuummmmnnnnssss====_n_u_m you can specify more than 2 columns per page. ----aaaa _p_a_g_e_s,,,, --------ppppaaaaggggeeeessss====_p_a_g_e_s Specify which pages are printed. Page specification _p_a_g_e_s can be given in following formats: _b_e_g_i_n-_e_n_d print pages from _b_e_g_i_n to _e_n_d -_e_n_d print pages from 0 to _e_n_d _b_e_g_i_n- print pages from _b_e_g_i_n to end _p_a_g_e print page _p_a_g_e odd print odd pages even print even pages ----AAAA _a_l_i_g_n,,,, --------ffffiiiilllleeee----aaaalllliiiiggggnnnn====_a_l_i_g_n Align separate input files to even _a_l_i_g_n page count. Page 1 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) This is handy for two-side and 2-up printings (--file-align=2). ----bbbb _h_e_a_d_e_r,,,, --------hhhheeeeaaaaddddeeeerrrr====_h_e_a_d_e_r Use text _h_e_a_d_e_r as a page header. The default page header is constructed from file's name and last modification time. The header string _h_e_a_d_e_r can contain the same formatting escapes which can be specified for the %%%%FFFFoooorrrrmmmmaaaatttt directives in the user defined fancy headers. For example, the following option prints the file name, current data and page numbers: eeeennnnssssccccrrrriiiipppptttt --------hhhheeeeaaaaddddeeeerrrr====''''$$$$nnnn %%%%WWWW PPPPaaaaggggeeee $$$$%%%% ooooffff $$$$===='''' ****....cccc The header string can also contain left, center and right justified fields which are separated with the ''''||||'''' character: eeeennnnssssccccrrrriiiipppptttt --------hhhheeeeaaaaddddeeeerrrr====''''$$$$nnnn||||%%%%WWWW||||PPPPaaaaggggeeee $$$$%%%% ooooffff $$$$===='''' ****....cccc now the file name is printed left justified, the date is centered to the header and the page numbers are printed right justified. ----BBBB,,,, --------nnnnoooo----hhhheeeeaaaaddddeeeerrrr Do not print page headers. ----cccc,,,, --------ttttrrrruuuunnnnccccaaaatttteeee----lllliiiinnnneeeessss Cut lines that are too long. As a default, eeeennnnssssccccrrrriiiipppptttt wraps long lines so no information is lost. See also option --------sssslllliiiicccceeee which can be used to slice long lines to separate pages. ----CCCC[_s_t_a_r_t__l_i_n_e],,,, --------lllliiiinnnneeee----nnnnuuuummmmbbbbeeeerrrrssss[====_s_t_a_r_t__l_i_n_e] Precede each line with its line number. Optional argument _s_t_a_r_t__l_i_n_e specifies the number of the first line in the input. The number of the first line defaults to 1. ----dddd _n_a_m_e Spool output to the printer _n_a_m_e. ----DDDD _k_e_y[::::_v_a_l_u_e],,,, --------sssseeeettttppppaaaaggggeeeeddddeeeevvvviiiicccceeee====_k_e_y[::::_v_a_l_u_e] Pass a page device definition to the generated PostScript output. If no value is given, key _k_e_y is removed from definitions. For example, command eeeennnnssssccccrrrriiiipppptttt ----DDDDDDDDuuuupppplllleeeexxxx::::ttttrrrruuuueeee ffffoooooooo....ttttxxxxtttt Page 2 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) prints file foo.txt in duplex (two side) mode. Page device operators are implementation dependant but they are standardized. See section PPPPAAAAGGGGEEEE DDDDEEEEVVVVIIIICCCCEEEE OOOOPPPPTTTTIIIIOOOONNNNSSSS for details. ----eeee[_c_h_a_r],,,, --------eeeessssccccaaaappppeeeessss[====_c_h_a_r] Enable special escapes interpretation (see section SSSSPPPPEEEECCCCIIIIAAAALLLL EEEESSSSCCCCAAAAPPPPEEEESSSS). If argument _c_h_a_r is given, it changes the escape character to _c_h_a_r. The default escape character is 0. ----EEEE[_l_a_n_g],,,, --------pppprrrreeeettttttttyyyy----pppprrrriiiinnnntttt[====_l_a_n_g] Pretty-print source code by creating a special input filter with the ssssttttaaaatttteeeessss program. Optional argument _l_a_n_g specifies the language to highlight, as a default ssssttttaaaatttteeeessss makes an educated guess. A description of supported highlighting languages and file formats can be printed with command: eeeennnnssssccccrrrriiiipppptttt --------hhhheeeellllpppp----pppprrrreeeettttttttyyyy----pppprrrriiiinnnntttt The highlighting rules are defined in the `/usr/freeware/share/enscript/enscript.st' file which can be edited to create highlighting definitions for new languages. NNNNooootttteeee!!!! You can't use your own input filters with this option. ----ffff _n_a_m_e,,,, --------ffffoooonnnntttt====_n_a_m_e Select font that is used for body text. The default body font is _C_o_u_r_i_e_r_1_0, unless multicolumn landscape printing mode is selected, in which case the default is _C_o_u_r_i_e_r_7. Font specification _n_a_m_e contains two parts: font's name and font's size in points. For example "TTTTiiiimmmmeeeessss----RRRRoooommmmaaaannnn11112222" selects "Times-Roman" font with size 12pt. The font specification _n_a_m_e can also be given in format `_n_a_m_e@_p_t_s_i_z_e', where font's name and point size are separated by a `@' character. This allows eeeennnnssssccccrrrriiiipppptttt to use fonts which contain digit characters in their names. The font point size can also be given in format _w_i_d_t_h/_h_e_i_g_h_t where _w_i_d_t_h and _h_e_i_g_h_t specify the font's size in x- and y-directions. For example "TTTTiiiimmmmeeeessss----RRRRoooommmmaaaannnn@@@@11110000////11112222" selects 10 points wide and 12 Page 3 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) points high "Times-Roman" font. NNNNooootttteeee!!!! font sizes can be given as a decimal number. For example "TTTTiiiimmmmeeeessss----RRRRoooommmmaaaannnn11110000....2222" selects 10.2pt "Times-Roman" font. ----FFFF _n_a_m_e,,,, --------hhhheeeeaaaaddddeeeerrrr----ffffoooonnnntttt====_n_a_m_e Select font for header texts. ----gggg,,,, --------pppprrrriiiinnnntttt----aaaannnnyyyywwwwaaaayyyy Print file even if it contains binary data. Option is here only for compatibility since eeeennnnssssccccrrrriiiipppptttt prints binary files anyway. ----GGGG,,,, --------ffffaaaannnnccccyyyy----hhhheeeeaaaaddddeeeerrrr[====_n_a_m_e] Print fancy page header _n_a_m_e to top of each page. Option ----GGGG specifies the default fancy header (see section CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN FFFFIIIILLLLEEEESSSS to see how the default fancy header can be changed). ----hhhh,,,, --------nnnnoooo----jjjjoooobbbb----hhhheeeeaaaaddddeeeerrrr Suppress printing of the job header page. ----HHHH[_n_u_m],,,, --------hhhhiiiigggghhhhlllliiiigggghhhhtttt----bbbbaaaarrrrssss[====_n_u_m] Specify how high highlight bars are in lines. If _n_u_m is not given, the default value 2 is used. As a default, no highlight bars are printed. ----iiii _n_u_m,,,, --------iiiinnnnddddeeeennnntttt====_n_u_m Indent every line _n_u_m characters. The indentation can also be specified in other units by appending an unit specifier after the number. Possible unit specifiers and the corresponding units are: cccc centimeters iiii inches llll characters (default) pppp PostScript points ----IIII _f_i_l_t_e_r,,,, --------ffffiiiilllltttteeeerrrr====_f_i_l_t_e_r Read all input files through input filter _f_i_l_t_e_r. Input filter can be a single command or a command pipeline and it can refer to the name of the input file with escape `%s'. The name of the input file ssssttttddddiiiinnnn can be changed with option `--------ffffiiiilllltttteeeerrrr----ssssttttddddiiiinnnn'. For example, the following command can be used to print file `foo.c' by using only upper-case characters: Page 4 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) enscript --filter="cat %s | tr 'a-z' 'A-Z'" foo.c And to highlight changes made to files since the last checkout: enscript --filter="rcsdiff %s | diffpp %s" -e *.c NNNNooootttteeee!!!! To include string "%s" to the filter command, you must write it as "%%s". ----jjjj,,,, --------bbbboooorrrrddddeeeerrrrssss Print borders around columns. ----JJJJ _t_i_t_l_e An alias for option ----tttt, --------ttttiiiittttlllleeee. ----kkkk,,,, --------ppppaaaaggggeeee----pppprrrreeeeffffeeeeeeeedddd Enable page prefeed. ----KKKK,,,, --------nnnnoooo----ppppaaaaggggeeee----pppprrrreeeeffffeeeeeeeedddd Disable page prefeed (default). ----llll,,,, --------lllliiiinnnneeeepppprrrriiiinnnntttteeeerrrr Emulate lineprinter. This option is a shortcut for options: --------lllliiiinnnneeeessss----ppppeeeerrrr----ppppaaaaggggeeee====66666666, --------nnnnoooo----hhhheeeeaaaaddddeeeerrrr. ----LLLL _n_u_m,,,, --------lllliiiinnnneeeessss----ppppeeeerrrr----ppppaaaaggggeeee====_n_u_m Print only _n_u_m lines per each page. ----mmmm,,,, --------mmmmaaaaiiiillll Send mail notification to user after print job has been completed. ----MMMM _n_a_m_e,,,, --------mmmmeeeeddddiiiiaaaa====_n_a_m_e Select output media _n_a_m_e. EEEEnnnnssssccccrrrriiiipppptttt's default output media is LLLLeeeetttttttteeeerrrr. ----nnnn _n_u_m,,,, --------ccccooooppppiiiieeeessss====_n_u_m Print _n_u_m copies of each page. ----NNNN _n_l,,,, --------nnnneeeewwwwlllliiiinnnneeee====_n_l Select the _n_e_w_l_i_n_e character. Possible values for _n_l are: nnnn (unix newline, 0xa hex) and rrrr (mac newline, 0xd hex). ----oooo _f_i_l_e An alias for option ----pppp, --------oooouuuuttttppppuuuutttt. ----OOOO,,,, --------mmmmiiiissssssssiiiinnnngggg----cccchhhhaaaarrrraaaacccctttteeeerrrrssss Print a listing of character codes which couldn't be printed. ----pppp _f_i_l_e,,,, --------oooouuuuttttppppuuuutttt====_f_i_l_e Page 5 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) Leave output to file _f_i_l_e. If _f_i_l_e is `-', leave output to _s_t_d_o_u_t. ----PPPP _n_a_m_e,,,, --------pppprrrriiiinnnntttteeeerrrr====_n_a_m_e Spool output to the printer _n_a_m_e. ----qqqq,,,, --------qqqquuuuiiiieeeetttt,,,, --------ssssiiiilllleeeennnntttt Make eeeennnnssssccccrrrriiiipppptttt really quiet. Only fatal error messages are printed to _s_t_d_e_r_r. ----rrrr,,,, --------llllaaaannnnddddssssccccaaaappppeeee Print in landscape mode; rotate page 90 degrees. ----RRRR,,,, --------ppppoooorrrrttttrrrraaaaiiiitttt Print in portrait mode (default). ----ssss _n_u_m,,,, --------bbbbaaaasssseeeelllliiiinnnneeeesssskkkkiiiipppp====_n_u_m Specify the baseline skip in PostScript points. Number _n_u_m can be given as a decimal number. When eeeennnnssssccccrrrriiiipppptttt moves from line to line, current point _y coordinate is moved (_f_o_n_t _p_o_i_n_t _s_i_z_e + _b_a_s_e_l_i_n_e_s_k_i_p) points down. The default baseline skip is 1. ----SSSS _k_e_y[::::_v_a_l_u_e],,,, --------ssssttttaaaattttuuuussssddddiiiicccctttt====_k_e_y[::::_v_a_l_u_e] Pass a statusdict definition to the generated PostScript output. If no value is given, key _k_e_y is removed from definitions. Statusdict operators are implementation dependant; see printer's documentation for details. For example, command eeeennnnssssccccrrrriiiipppptttt ----SSSSsssseeeettttppppaaaappppeeeerrrrttttrrrraaaayyyy::::1111 ffffoooooooo....ttttxxxxtttt prints file _f_o_o._t_x_t by using paper from the paper tray 1 (assuming that printer supports paper tray selection). ----tttt _t_i_t_l_e,,,, --------ttttiiiittttlllleeee====_t_i_t_l_e Set banner page's job title to _t_i_t_l_e. Option sets also the name of the input file ssssttttddddiiiinnnn. ----TTTT _n_u_m,,,, --------ttttaaaabbbbssssiiiizzzzeeee====_n_u_m Set tabulator size to _n_u_m (default is 8). ----uuuu[_t_e_x_t],,,, --------uuuunnnnddddeeeerrrrllllaaaayyyy[====_t_e_x_t] Print string _t_e_x_t under every page. Text's properties can be changed with options --------uuuullll----aaaannnngggglllleeee, --------uuuullll----ffffoooonnnntttt, --------uuuullll----ggggrrrraaaayyyy, --------uuuullll----ppppoooossssiiiittttiiiioooonnnn and --------uuuullll----ssssttttyyyylllleeee. If no _t_e_x_t is given, no underlay is printed. This Page 6 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) can be used to remove underlay that was specified with the `UUUUnnnnddddeeeerrrrllllaaaayyyy' configuration file option. ----UUUU _n_u_m,,,, --------nnnnuuuupppp====_n_u_m Print _n_u_m logical pages on each output page (N-up printing). ----vvvv,,,, --------vvvveeeerrrrbbbboooosssseeee[====_l_e_v_e_l] Tell what eeeennnnssssccccrrrriiiipppptttt is doing. ----VVVV,,,, --------vvvveeeerrrrssssiiiioooonnnn Print eeeennnnssssccccrrrriiiipppptttt version and exit. ----WWWW [_l_a_n_g],,,, --------llllaaaannnngggguuuuaaaaggggeeee[====_l_a_n_g] Generate output in language _l_a_n_g. Possible values for _l_a_n_g are: PPPPoooossssttttSSSSccccrrrriiiipppptttt generate PostScript (default) hhhhttttmmmmllll generate HTML oooovvvveeeerrrrssssttttrrrriiiikkkkeeee generate overstrikes (line printers, less) rrrrttttffff generate RTF (Rich Text Format) ----XXXX _n_a_m_e,,,, --------eeeennnnccccooooddddiiiinnnngggg====_n_a_m_e Use input encoding _n_a_m_e. Currently eeeennnnssssccccrrrriiiipppptttt supports following encodings: 88888888555599991111,,,, llllaaaattttiiiinnnn1111 ISO-8859-1 (ISO Latin1) (eeeennnnssssccccrrrriiiipppptttt's default encoding). 88888888555599992222,,,, llllaaaattttiiiinnnn2222 ISO-8859-2 (ISO Latin2) 88888888555599993333,,,, llllaaaattttiiiinnnn3333 ISO-8859-3 (ISO Latin3) 88888888555599994444,,,, llllaaaattttiiiinnnn4444 ISO-8859-4 (ISO Latin4) 88888888555599995555,,,, ccccyyyyrrrriiiilllllllliiiicccc ISO-8859-5 (ISO Cyrillic) 88888888555599997777,,,, ggggrrrreeeeeeeekkkk ISO-8859-7 (ISO Greek) aaaasssscccciiiiiiii 7-bit ascii Page 7 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) aaaasssscccciiiiiiiiffffiiiisssseeee,,,, aaaasssscccciiiiiiiiffffiiii,,,, aaaasssscccciiiiiiiisssseeee 7-bit ascii with some scandinavian (fi, se) extensions aaaasssscccciiiiiiiiddddkkkknnnnoooo,,,, aaaasssscccciiiiiiiiddddkkkk,,,, aaaasssscccciiiiiiiinnnnoooo 7-bit ascii with some scandinavian (dk, no) extensions iiiibbbbmmmmppppcccc,,,, ppppcccc,,,, ddddoooossss IBM PC charset mmmmaaaacccc Mac charset vvvvmmmmssss VMS multinational charset hhhhpppp8888 HP Roman-8 charset kkkkooooiiii8888 Adobe Standard Cyrillic Font KOI8 charset ppppssss,,,, PPPPSSSS PostScript font's default encoding ppppssssllllaaaattttiiiinnnn1111,,,, IIIISSSSOOOOLLLLaaaattttiiiinnnn1111EEEEnnnnccccooooddddiiiinnnngggg PostScript interpreter's `ISOLatin1Encoding' ----zzzz,,,, --------nnnnoooo----ffffoooorrrrmmmmffffeeeeeeeedddd Turn off form feed character interpretation. ----ZZZZ,,,, --------ppppaaaassssssss----tttthhhhrrrroooouuuugggghhhh Pass through all PostScript and PCL files without any modifications. This allows that eeeennnnssssccccrrrriiiipppptttt can be used as a lp filter. PostScript files are recognized by looking up the `%!' magic cookie from the beginning of the file. NNNNooootttteeee!!!! EEEEnnnnssssccccrrrriiiipppptttt recognized also the Windoze damaged `^D%!' cookie. PCL files are recognized by looking up the `^[E' or `^[%' magic cookies from the beginning of the file. --------ccccoooolllloooorrrr[====_c_o_l_o_r] Set the pretty-printing color model to _c_o_l_o_r. If no _c_o_l_o_r is specified, use color model eeeemmmmaaaaccccssss. --------ddddoooowwwwnnnnllllooooaaaadddd----ffffoooonnnntttt====_f_o_n_t_n_a_m_e Include the font description file (._p_f_a or ._p_f_b file) of the font _f_o_n_t_n_a_m_e to the generated output. --------ffffiiiilllltttteeeerrrr----ssssttttddddiiiinnnn====_n_a_m_e Specify how ssssttttddddiiiinnnn is shown to the input filter. The default value is an empty string ("") but some programs require that ssssttttddddiiiinnnn is called something Page 8 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) else, usually "-". --------hhhh----ccccoooolllluuuummmmnnnn----hhhheeeeiiiigggghhhhtttt====_h_e_i_g_h_t Set the horizontal column height to be _h_e_i_g_h_t PostScript points. The option sets the formfeed type to _h_o_r_i_z_o_n_t_a_l-_c_o_l_u_m_n_s. --------hhhheeeellllpppp Print short help message and exit. --------hhhheeeellllpppp----pppprrrreeeettttttttyyyy----pppprrrriiiinnnntttt Describe all supported --------pppprrrreeeettttttttyyyy----pppprrrriiiinnnntttt languages and file formats. --------hhhhiiiigggghhhhlllliiiigggghhhhtttt----bbbbaaaarrrr----ggggrrrraaaayyyy====_g_r_a_y Specify the gray level which is used to print highlight bars. --------lllliiiisssstttt----mmmmeeeeddddiiiiaaaa List the names of all known output media and exit successfully. --------lllliiiisssstttt----ooooppppttttiiiioooonnnnssss List all options and their current values. Exit successfully. --------mmmmaaaarrrrggggiiiinnnnssss====_l_e_f_t::::_r_i_g_h_t::::_t_o_p::::_b_o_t_t_o_m Adjust page marginals to be exact _l_e_f_t, _r_i_g_h_t, _t_o_p and _b_o_t_t_o_m PostScript points. Any of arguments can be left empty in which case the default value is used. --------mmmmaaaarrrrkkkk----wwwwrrrraaaappppppppeeeedddd----lllliiiinnnneeeessss[====_s_t_y_l_e] Mark wrapped lines in the output with style _s_t_y_l_e. Possible values for _s_t_y_l_e aaaarrrreeee:::: nnnnoooonnnneeee do not mark them (default) pppplllluuuussss print a plus (+) character to the end of each wrapped line bbbbooooxxxx print a black box to the end of each wrapped line aaaarrrrrrrroooowwww print a small arrow to the end of each wrapped line --------nnnnoooonnnn----pppprrrriiiinnnnttttaaaabbbblllleeee----ffffoooorrrrmmmmaaaatttt====_f_o_r_m_a_t Specify how non-printable characters are printed. Possible values for _f_o_r_m_a_t aaaarrrreeee:::: ccccaaaarrrreeeetttt caret notation: `^@', `^A', `^B', ... Page 9 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) ooooccccttttaaaallll octal notation: `\000', `\001', `\002', ... (default) qqqquuuueeeessssttttiiiioooonnnnmmmmaaaarrrrkkkk replace non-printable characters with a question mark `?' ssssppppaaaacccceeee replace non-printable characters with a space ` ' --------nnnnuuuupppp----xxxxppppaaaadddd====_n_u_m Set the page x-padding of the _n-up printing to _n_u_m PostScript points. The default is 10 points. --------nnnnuuuupppp----yyyyppppaaaadddd====_n_u_m Set the page y-padding of the _n-up printing to _n_u_m PostScript points. The default is 10 points. --------ppppaaaaggggeeee----llllaaaabbbbeeeellll----ffffoooorrrrmmmmaaaatttt====_f_o_r_m_a_t Set page label format to _f_o_r_m_a_t. Page label format specifies how labels for the `%%Page:' PostScript comments are formatted. Possible values are: sssshhhhoooorrrrtttt Print current pagenumber: `%%Page: (1) 1' (default) lllloooonnnngggg Print current filename and pagenumber: `%%Page: (main.c: 1) 1' --------ppppssss----lllleeeevvvveeeellll====_l_e_v_e_l Set the PostScript language level, that eeeennnnssssccccrrrriiiipppptttt uses for its output, to _l_e_v_e_l. The possible values are 1111, and 2222. --------pppprrrriiiinnnntttteeeerrrr----ooooppppttttiiiioooonnnnssss====_o_p_t_i_o_n_s Pass extra options to the printer command. --------rrrroooottttaaaatttteeee----eeeevvvveeeennnn----ppppaaaaggggeeeessss Rotate each even-numbered page 180 degrees. --------sssslllliiiicccceeee====_n_u_m Print vertical slice _n_u_m. Slices are vertical regions of input files, new slice starts from the point where the line would otherwise be wrapped to the next line. Slice numbers start from 1. --------ttttoooocccc Print table of contents to the end of the print job. --------wwwwoooorrrrdddd----wwwwrrrraaaapppp Wrap long lines from word boundaries. --------uuuullll----aaaannnngggglllleeee====_a_n_g_l_e Page 10 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) Set underlay text's angle. As a default, angle is atan(-page_height, page_width). --------uuuullll----ffffoooonnnntttt====_n_a_m_e Select font for the underlay text. The default underlay font is _T_i_m_e_s-_R_o_m_a_n_2_0_0. --------uuuullll----ggggrrrraaaayyyy====_n_u_m Print underlay text with gray value _n_u_m (0 ... 1), the default gray is .8. --------uuuullll----ppppoooossssiiiittttiiiioooonnnn====_p_o_s_i_t_i_o_n__s_p_e_c Set underlay text's starting position according to _p_o_s_i_t_i_o_n__s_p_e_c. Position specification must be given in format: `_s_i_g_n _x_p_o_s _s_i_g_n _y_p_o_s', where _s_i_g_n must be `+' or `-'. Positive dimensions are measured from the lower left corner and negative dimensions from the upper right corner. For example, spec `+0-0' specifies the upper left corner and `-0+0' specifies the lower right corner. --------uuuullll----ssssttttyyyylllleeee====_s_t_y_l_e Set underlay text's style to _s_t_y_l_e. Possible values for _s_t_y_l_e are: oooouuuuttttlllliiiinnnneeee print outline underlay texts (default) ffffiiiilllllllleeeedddd print filled underlay texts CCCCOOOONNNNFFFFIIIIGGGGUUUURRRRAAAATTTTIIIIOOOONNNN FFFFIIIILLLLEEEESSSS EEEEnnnnssssccccrrrriiiipppptttt reads configuration information from following sources (in this order): command line options, environment variable EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT, user's personal configuration file ($$$$HHHHOOOOMMMMEEEE////....eeeennnnssssccccrrrriiiippppttttrrrrcccc), site configuration file (////uuuussssrrrr////ffffrrrreeeeeeeewwwwaaaarrrreeee////eeeettttcccc////eeeennnnssssccccrrrriiiippppttttssssiiiitttteeee....ccccffffgggg) and system's global configuration file (////uuuussssrrrr////ffffrrrreeeeeeeewwwwaaaarrrreeee////eeeettttcccc////eeeennnnssssccccrrrriiiipppptttt....ccccffffgggg). The configuration files have the following format: Empty lines and lines starting with `#' are comments. All other lines are option lines and have format: _O_P_T_I_O_N [_a_r_g_u_m_e_n_t_s ...]. Following options can be specified: AAAAcccccccceeeeppppttttCCCCoooommmmppppoooossssiiiitttteeeeCCCChhhhaaaarrrraaaacccctttteeeerrrrssss:::: _b_o_o_l Specify whatever PostScript font's composite characters are accepted as printable or should they be considered as non-existent. The default value is Page 11 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) false (0). AAAAFFFFMMMMPPPPaaaatttthhhh:::: _p_a_t_h Specifies search path for the _A_F_M files. AAAAppppppppeeeennnnddddCCCCttttrrrrllllDDDD:::: _b_o_o_l Specify if the Control-D (^D) character should be appended to the end of the output. The default value is false (0). CCCClllleeeeaaaannnn7777BBBBiiiitttt:::: _b_o_o_l Specify how characters greater than 127 are printed. Value true (1) generates 7-bit clean code by escaping all characters greater than 127 to the backslash-octal notation (default). Value false (0) generates 8-bit PostScript code leaving all characters untouched. DDDDeeeeffffaaaauuuullllttttEEEEnnnnccccooooddddiiiinnnngggg:::: _n_a_m_e Select the default input encoding. Encoding name _n_a_m_e can be one of the values of the ----XXXX, --------eeeennnnccccooooddddiiiinnnngggg option. DDDDeeeeffffaaaauuuullllttttFFFFaaaannnnccccyyyyHHHHeeeeaaaaddddeeeerrrr:::: _n_a_m_e Select the default fancy header. Default header is used when option ----GGGG is specified or option --------ffffaaaannnnccccyyyy----hhhheeeeaaaaddddeeeerrrr is given without an argument. System-wide default is `eeeennnnssssccccrrrriiiipppptttt'. DDDDeeeeffffaaaauuuullllttttMMMMeeeeddddiiiiaaaa:::: _n_a_m_e Select the default output media. DDDDeeeeffffaaaauuuullllttttOOOOuuuuttttppppuuuuttttMMMMeeeetttthhhhoooodddd:::: _m_e_t_h_o_d Select the default target to which generated output is send. Possible values for _m_e_t_h_o_d are: pppprrrriiiinnnntttteeeerrrr send output to printer (default) ssssttttddddoooouuuutttt send output to _s_t_d_o_u_t DDDDoooowwwwnnnnllllooooaaaaddddFFFFoooonnnntttt:::: _f_o_n_t_n_a_m_e Include the font description file of the font _f_o_n_t_n_a_m_e to the generated output. EEEEssssccccaaaappppeeeeCCCChhhhaaaarrrr:::: _n_u_m Specify the escape character for special escapes. The default value is 0. FFFFoooorrrrmmmmFFFFeeeeeeeeddddTTTTyyyyppppeeee:::: _t_y_p_e Specify what to do when a formfeed character is encountered from the input. Possible values for _t_y_p_e are: Page 12 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) ccccoooolllluuuummmmnnnn move to the beginning of the next column (default) ppppaaaaggggeeee move to the beginning of the next page GGGGeeeennnneeeerrrraaaatttteeeePPPPaaaaggggeeeeSSSSiiiizzzzeeee:::: _b_o_o_l Specify whether the PPPPaaaaggggeeeeSSSSiiiizzzzeeee page device setting is generated to the PostScript output. The default value is true (1). HHHHiiiigggghhhhlllliiiigggghhhhttttBBBBaaaarrrrGGGGrrrraaaayyyy:::: _g_r_a_y Specify the gray level which is used to print highlight bars. HHHHiiiigggghhhhlllliiiigggghhhhttttBBBBaaaarrrrssss:::: _n_u_m Specify how high highlight bars are in lines. The default value is 0 so no highlight bars are printed. LLLLiiiibbbbrrrraaaarrrryyyyPPPPaaaatttthhhh:::: _p_a_t_h Specifies eeeennnnssssccccrrrriiiipppptttt's library path that is used to lookup various resources. Default path is: `/usr/freeware/share/enscript:_h_o_m_e/.enscript'. Where _h_o_m_e is the user's home directory. MMMMaaaarrrrkkkkWWWWrrrraaaappppppppeeeeddddLLLLiiiinnnneeeessss:::: _s_t_y_l_e Mark wraped lines in the output with style _s_t_y_l_e. Possible values for _f_o_r_m_a_t are the same which can be given for the --------mmmmaaaarrrrkkkk----wwwwrrrraaaappppppppeeeedddd----lllliiiinnnneeeessss option. MMMMeeeeddddiiiiaaaa:::: _n_a_m_e _w_i_d_t_h _h_e_i_g_h_t _l_l_x _l_l_y _u_r_x _u_r_y Add a new output media with name _n_a_m_e. Media's physical dimensions are _w_i_d_t_h and _h_e_i_g_h_t. Media's bounding box is specified by points (_l_l_x, _l_l_y) and (_u_r_x, _u_r_y). EEEEnnnnssssccccrrrriiiipppptttt prints all graphics inside media's bounding box. User can select this media by giving option ----MMMM _n_a_m_e. NNNNooooJJJJoooobbbbHHHHeeeeaaaaddddeeeerrrrSSSSwwwwiiiittttcccchhhh:::: _s_w_i_t_c_h Specify the spooler option to suppress the print job header. This option is passed to the printer spooler when eeeennnnssssccccrrrriiiipppptttt's option ----hhhh, --------nnnnoooo----jjjjoooobbbb----hhhheeeeaaaaddddeeeerrrr is selected. NNNNoooonnnnPPPPrrrriiiinnnnttttaaaabbbblllleeeeFFFFoooorrrrmmmmaaaatttt:::: _f_o_r_m_a_t Specify how non-printable characters are printed. Possible values for _f_o_r_m_a_t are the same which can be given for the --------nnnnoooonnnn----pppprrrriiiinnnnttttaaaabbbblllleeee----ffffoooorrrrmmmmaaaatttt option. OOOOuuuuttttppppuuuuttttFFFFiiiirrrrssssttttLLLLiiiinnnneeee:::: _l_i_n_e Set PostScript output's first line to _l_i_n_e, the default value is PPPPSSSS----AAAAddddoooobbbbeeee----3333....0000. Since some printers Page 13 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) do not like DSC levels greater than 2.0, this option can be used to change the output first line to something more suitable like %%%%!!!!PPPPSSSS----AAAAddddoooobbbbeeee----2222....0000 or %%%%!!!!. PPPPaaaaggggeeeeLLLLaaaabbbbeeeellllFFFFoooorrrrmmmmaaaatttt:::: _f_o_r_m_a_t Set page label format to _f_o_r_m_a_t. Possible values for _f_o_r_m_a_t are the same which can be given for the --------ppppaaaaggggeeee----llllaaaabbbbeeeellll----ffffoooorrrrmmmmaaaatttt option. PPPPaaaaggggeeeePPPPrrrreeeeffffeeeeeeeedddd:::: _b_o_o_l Enable / disable page prefeed. The default is false (0). PPPPoooossssttttSSSSccccrrrriiiippppttttLLLLeeeevvvveeeellll:::: _l_e_v_e_l Set the PostScript language level, that eeeennnnssssccccrrrriiiipppptttt uses for its output, to _l_e_v_e_l. The possible values for _l_e_v_e_l are the same which can be given for the --------ppppssss----lllleeeevvvveeeellll option. PPPPrrrriiiinnnntttteeeerrrr:::: _n_a_m_e Names the printer to spool to. QQQQuuuueeeeuuuueeeePPPPaaaarrrraaaammmm:::: _n_a_m_e The spooler command switch for the printer queue, e.g. -_P in _l_p_r -_P_p_s. This option can also be used to pass other flags to the spooler command but they must be given before the queue switch. SSSSeeeettttPPPPaaaaggggeeeeDDDDeeeevvvviiiicccceeee:::: _k_e_y[::::_v_a_l_u_e] Pass a page device definition to the generated PostScript output. SSSSppppoooooooolllleeeerrrr:::: _n_a_m_e Names printer spooler command. EEEEnnnnssssccccrrrriiiipppptttt pipes generated PostScript to command _n_a_m_e. SSSSttttaaaatttteeeessssCCCCoooolllloooorrrrMMMMooooddddeeeellll:::: _m_o_d_e_l Set the pretty-printing color model to _m_o_d_e_l. Possible values are bbbbllllaaaacccckkkkwwwwhhhhiiiitttteeee and eeeemmmmaaaaccccssss. SSSSttttaaaatttteeeessssCCCCoooonnnnffffiiiiggggFFFFiiiilllleeee:::: _f_i_l_e Read pretty-printer states configuration from file _f_i_l_e. The default config file is `/usr/freeware/share/enscript/enscript.st'. SSSSttttaaaatttteeeessssHHHHiiiigggghhhhlllliiiigggghhhhttttLLLLeeeevvvveeeellll:::: _l_e_v_e_l Set the pretty-printing highlight level to _l_e_v_e_l. Possible values are nnnnoooonnnneeee, lllliiiigggghhhhtttt and hhhheeeeaaaavvvvyyyy. SSSSttttaaaatttteeeessssPPPPaaaatttthhhh:::: _p_a_t_h Define path for the ssssttttaaaatttteeeessss program. Page 14 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) SSSSttttaaaattttuuuussssDDDDiiiicccctttt:::: _k_e_y[::::_v_a_l_u_e] Pass a statusdict definition to the generated PostScript output. TTTTOOOOCCCCFFFFoooorrrrmmmmaaaatttt:::: _f_o_r_m_a_t Format table of contents entries with format string _f_o_r_m_a_t. Format string _f_o_r_m_a_t can contain the same escapes which are used to format header strings with the `%Format' special comment. UUUUnnnnddddeeeerrrrllllaaaayyyy:::: _t_e_x_t Print string _t_e_x_t under every page. UUUUnnnnddddeeeerrrrllllaaaayyyyAAAAnnnngggglllleeee:::: _n_u_m Set underlay text's angle to _n_u_m. UUUUnnnnddddeeeerrrrllllaaaayyyyFFFFoooonnnntttt:::: _f_o_n_t_s_p_e_c Select font for the underlay text. UUUUnnnnddddeeeerrrrllllaaaayyyyGGGGrrrraaaayyyy:::: _n_u_m Print underlay text with gray value _n_u_m. UUUUnnnnddddeeeerrrrllllaaaayyyyPPPPoooossssiiiittttiiiioooonnnn:::: _p_o_s_i_t_i_o_n__s_p_e_c Set underlay text's starting position according to _p_o_s_i_t_i_o_n__s_p_e_c. UUUUnnnnddddeeeerrrrllllaaaayyyySSSSttttyyyylllleeee:::: _s_t_y_l_e Set underlay text's style to _s_t_y_l_e. CCCCUUUUSSSSTTTTOOOOMMMMIIIIZZZZAAAATTTTIIIIOOOONNNN Users can create their own fancy headers by creating a header description file and placing it in a directory which is in eeeennnnssssccccrrrriiiipppptttt's library path. The name of the header file must be in format: `_h_e_a_d_e_r_n_a_m_e.hdr'. Header can be selected by giving option: --------ffffaaaannnnccccyyyy----hhhheeeeaaaaddddeeeerrrr====_h_e_a_d_e_r_n_a_m_e. Header description file contains PostScript code that paints the header. Description file must provide procedure ddddoooo____hhhheeeeaaaaddddeeeerrrr which is called by eeeennnnssssccccrrrriiiipppptttt at the beginning of every page. Header description file contains two parts: comments and code. Parts are separated by a line containing text: % -- code follows this line -- EEEEnnnnssssccccrrrriiiipppptttt copies only the code part of description file to the generated PostScript output. The comments part can contain any data, it is not copied. If separator line is missing, no data is copied to output. Page 15 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEEnnnnssssccccrrrriiiipppptttt defines following constants which can be used in header description files: dddd____ppppaaaaggggeeee____wwww page width dddd____ppppaaaaggggeeee____hhhh page height dddd____hhhheeeeaaaaddddeeeerrrr____xxxx header lower left _x coordinate dddd____hhhheeeeaaaaddddeeeerrrr____yyyy header lower left _y coordinate dddd____hhhheeeeaaaaddddeeeerrrr____wwww header width dddd____hhhheeeeaaaaddddeeeerrrr____hhhh header height dddd____ffffooooooootttteeeerrrr____xxxx footer lower left _x coordinate dddd____ffffooooooootttteeeerrrr____yyyy footer lower left _y coordinate dddd____ffffooooooootttteeeerrrr____wwww footer width dddd____ffffooooooootttteeeerrrr____hhhh footer height dddd____oooouuuuttttppppuuuutttt____wwww width of the text output area dddd____oooouuuuttttppppuuuutttt____hhhh height of the text output area uuuusssseeeerrrr____hhhheeeeaaaaddddeeeerrrr____pppp predicate which tells if user has defined his/her own header string: ttttrrrruuuueeee/ffffaaaallllsssseeee uuuusssseeeerrrr____hhhheeeeaaaaddddeeeerrrr____lllleeeefffftttt____ssssttttrrrr if uuuusssseeeerrrr____hhhheeeeaaaaddddeeeerrrr____pppp is ttttrrrruuuueeee, this is the left field of the user supplied header string. uuuusssseeeerrrr____hhhheeeeaaaaddddeeeerrrr____cccceeeennnntttteeeerrrr____ssssttttrrrr if uuuusssseeeerrrr____hhhheeeeaaaaddddeeeerrrr____pppp is ttttrrrruuuueeee, this is the center field of the user supplied header string uuuusssseeeerrrr____hhhheeeeaaaaddddeeeerrrr____rrrriiiigggghhhhtttt____ssssttttrrrr if uuuusssseeeerrrr____hhhheeeeaaaaddddeeeerrrr____pppp is ttttrrrruuuueeee, this is the right field of the user supplied header string HHHHFFFF standard header font (from ----FFFF, --------hhhheeeeaaaaddddeeeerrrr----ffffoooonnnntttt option). This can be selected simply by invoking command: `HHHHFFFF sssseeeettttffffoooonnnntttt'. ppppaaaaggggeeeennnnuuuummmm the number of the current page ffffnnnnaaaammmmeeee the full name of the printed file (/foo/bar.c) ffffddddiiiirrrr the directory part of the file name (/foo) Page 16 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) ffffttttaaaaiiiillll file name without the directory part (bar.c) ggggssss____llllaaaannnngggguuuuaaaaggggeeeelllleeeevvvveeeellll PostScript interpreter's language level (currently 1 or 2) You can also use the following special comments to customize your headers and to specify some extra options. Special comments are like DSC comments but they start with a single `%' character; special comments start from the beginning of the line and they have the following syntax: %_c_o_m_m_e_n_t_n_a_m_e: _o_p_t_i_o_n_s Currently eeeennnnssssccccrrrriiiipppptttt support the following special comments: %%%%FFFFoooorrrrmmmmaaaatttt:::: _n_a_m_e _f_o_r_m_a_t Define a new string constant _n_a_m_e according to the format string _f_o_r_m_a_t. Format string start from the first non-space character and it ends to the end of the line. Format string can contain general `%' escapes and input file related `$' escapes. Currently following escapes are supported: %%%%%%%% character `%' $$$$$$$$ character `$' $$$$%%%% current page number $$$$==== number of pages in the current file $$$$((((_V_A_R)))) value of the environment variable _V_A_R. %%%%cccc trailing component of the current working directory %%%%CCCC ($$$$CCCC) current time (file modification time) in `hh:mm:ss' format %%%%dddd current working directory %%%%DDDD ($$$$DDDD) current date (file modification date) in `yy-mm-dd' format %%%%DDDD{{{{_s_t_r_i_n_g}}}} ($$$$DDDD{{{{_s_t_r_i_n_g}}}}) format string _s_t_r_i_n_g with the strftime(3) function. `%%%%DDDD{{{{}}}}' refers to the current date and `$$$$DDDD{{{{}}}}' to the input file's last modification date. %%%%EEEE ($$$$EEEE) current date (file modification date) in Page 17 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) `yy/mm/dd' format %%%%FFFF ($$$$FFFF) current date (file modification date) in `dd.mm.yyyy' format %%%%HHHH document title $$$$LLLL number of lines in the current input file. This is valid only for the toc entries, it can't be used in header strings. %%%%mmmm the hostname up to the first `.' character %%%%MMMM the full hostname %%%%nnnn the user login name $$$$nnnn input file name without the directory part %%%%NNNN the user's pw_gecos field up to the first `,' character $$$$NNNN the full input file name %%%%tttt ($$$$tttt) current time (file modification time) in 12-hour am/pm format %%%%TTTT ($$$$TTTT) current time (file modification time) in 24-hour format `hh:mm' %%%%**** ($$$$****) current time (file modification time) in 24-hour format with seconds `hh:mm:ss' $$$$vvvv the sequence number of the current input file $$$$VVVV the sequence number of the current input file in the `Table of Contents' format: if the --------ttttoooocccc option is given, escape expands to `_n_u_m-'; if the --------ttttoooocccc is not given, escape expands to an empty string. %%%%WWWW ($$$$WWWW) current date (file modification date) in `mm/dd/yy' format All format directives except `$=' can also be given in format _e_s_c_a_p_e _w_i_d_t_h _d_i_r_e_c_t_i_v_e where _w_i_d_t_h specifies the width of the column to which the escape is printed. For example, escape Page 18 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) "$5%" will expand to something like " 12". If the width is negative, the value will be printed left- justified. For example, the `emacs.hdr' defines its date string with the following format comment: %%%%FFFFoooorrrrmmmmaaaatttt:::: eeeeuuuurrrrddddaaaatttteeeessssttttrrrr %%%%EEEE which expands to: ////eeeeuuuurrrrddddaaaatttteeeessssttttrrrr ((((99996666////00001111////00008888)))) ddddeeeeffff %%%%HHHHeeeeaaaaddddeeeerrrrHHHHeeeeiiiigggghhhhtttt:::: _h_e_i_g_h_t Allocate _h_e_i_g_h_t points space for the page header. The default header height is 36 points. %%%%FFFFooooooootttteeeerrrrHHHHeeeeiiiigggghhhhtttt:::: _h_e_i_g_h_t Allocate _h_e_i_g_h_t points space for the page footer. The default footer height is 0 points. According to Adobe's Document Structuring Conventions (DSC), all resources needed by a document must be listed in document's prolog. Since user's can create their own headers, eeeennnnssssccccrrrriiiipppptttt don't know what resources those headers use. That's why all headers must contain a standard DSC comment that lists all needed resources. For example, used fonts can be listed with following comment: %%DocumentNeededResources: font _f_o_n_t_n_a_m_e_1 _f_o_n_t_n_a_m_e_2 Comment can be continued to the next line with the standard continuation comment: %%+ font _f_o_n_t_n_a_m_e_3 SSSSPPPPEEEECCCCIIIIAAAALLLL EEEESSSSCCCCAAAAPPPPEEEESSSS EEEEnnnnssssccccrrrriiiipppptttt supports special escape sequences which can be used to add some page formatting commands to ASCII documents. As a default, special escapes interpretation is off, so all ASCII files print out as everyone expects. Special escapes interpretation is activated by giving option ----eeee, --------eeeessssccccaaaappppeeeessss to eeeennnnssssccccrrrriiiipppptttt. All special escapes start with the escape character. The default escape character is ^@ (octal 000); escape character can be changed with option ----eeee, --------eeeessssccccaaaappppeeeessss. Escape character is followed by escape's name and optional options and arguments. Currently eeeennnnssssccccrrrriiiipppptttt supports following escapes: Page 19 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) bbbbggggggggrrrraaaayyyy change the text background color. Escape's syntax is: ^@bggray{_g_r_a_y} where _g_r_a_y is the new text background gray value. The default value is 1.0 (white). ccccoooolllloooorrrr change the text color. Escape's syntax is: ^@color{_r_e_d _g_r_e_e_n _b_l_u_e} where color components _r_e_d, _g_r_e_e_n and _b_l_u_e are given as a decimal numbers between 0 and 1. ccccoooommmmmmmmeeeennnntttt comment the rest of the line including the newline character. Escape's syntax is: ^@comment _t_e_x_t _n_e_w_l_i_n_e__c_h_a_r_a_c_t_e_r eeeessssccccaaaappppeeee change the escape character. Escape's syntax is ^@escape{_c_o_d_e} where _c_o_d_e is the decimal code of the new escape character. eeeeppppssssffff inline EPS file to the document. Escape's syntax is: ^@epsf[_o_p_t_i_o_n_s]{_f_i_l_e_n_a_m_e} where _o_p_t_i_o_n_s is an optional sequence of option characters and values enclosed with brackets and _f_i_l_e_n_a_m_e is the name of the EPS file. If _f_i_l_e_n_a_m_e ends to the `|' character, then _f_i_l_e_n_a_m_e is assumed to name a command that prints EPS data to its standard output. In this case, eeeennnnssssccccrrrriiiipppptttt opens a pipe to the specified command and reads EPS data from pipe. Following options can be given for the eeeeppppssssffff escape: cccc print image centered rrrr print image right justified nnnn do not update current point. Following output is printed to that position where the current point was just before the eeeeppppssssffff escape Page 20 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) nnnnxxxx do not update current point _x coordinate nnnnyyyy do not update current point _y coordinate xxxx_n_u_m move image's top left _x coordinate _n_u_m characters from current point _x coordinate (relative position) xxxx_n_u_maaaa set image's top left _x coordinate to column _n_u_m (absolute position) yyyy_n_u_m move image's top left _y coordinate _n_u_m lines from current line (relative position) yyyy_n_u_maaaa set image's top left _y coordinate to line _n_u_m (absolute position) hhhh_n_u_m set image's height to _n_u_m lines ssss_n_u_m scale image with factor _n_u_m ssssxxxx_n_u_m scale image in _x direction with factor _n_u_m ssssyyyy_n_u_m scale image in _y direction with factor _n_u_m As a default, all dimensions are given in lines (vertical) and characters (horizontal). You can also specify other units by appending an unit specifier after number. Possible unit specifiers and the corresponding units are: cccc centimeters iiii inches llll lines or characters (default) pppp PostScript points For example to print an image one inch high, you can specify height by following options: hhhh1111iiii (1 inch), hhhh2222....55554444cccc (2.54 cm), hhhh77772222pppp (72 points). ffffoooonnnntttt select current font. Escape's syntax is: ^@font{_f_o_n_t_n_a_m_e} where _f_o_n_t_n_a_m_e is a standard font specification. Special font specification ddddeeeeffffaaaauuuulllltttt can be used to select the default body font (eeeennnnssssccccrrrriiiipppptttt's default or the one specified by the command line option ----ffff, --------ffffoooonnnntttt). Page 21 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) ppppssss include raw PostScript code to the output. Escape's syntax is: ^@ps{_c_o_d_e} sssshhhhaaaaddddeeee highlight regions of text by changing the text background color. Escape's syntax is: ^@shade{_g_r_a_y} where _g_r_a_y is the new text background gray value. The default value is 1.0 (white) which disables highlighting. PPPPAAAAGGGGEEEE DDDDEEEEVVVVIIIICCCCEEEE OOOOPPPPTTTTIIIIOOOONNNNSSSS Page device is a PostScript level 2 feature that offers an uniform interface to control printer's output device. EEEEnnnnssssccccrrrriiiipppptttt protects all page device options inside an if block so they have no effect in level 1 interpreters. Although all level 2 interpreters support page device, they do not have to support all page device options. For example some printers can print in duplex mode and some can not. Refer to the documentation of your printer for supported options. Here are some usable page device options which can be selected with the ----DDDD, --------sssseeeettttppppaaaaggggeeeeddddeeeevvvviiiicccceeee option. For a complete listing, see _P_o_s_t_S_c_r_i_p_t _L_a_n_g_u_a_g_e _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l: section 4.11 Device Setup. CCCCoooollllllllaaaatttteeee _b_o_o_l_e_a_n how output is organized when printing multiple copies DDDDuuuupppplllleeeexxxx _b_o_o_l_e_a_n duplex (two side) printing MMMMaaaannnnuuuuaaaallllFFFFeeeeeeeedddd _b_o_o_l_e_a_n manual feed paper tray OOOOuuuuttttppppuuuuttttFFFFaaaacccceeeeUUUUpppp _b_o_o_l_e_a_n print output `face up' or `face down' TTTTuuuummmmbbbblllleeee _b_o_o_l_e_a_n how opposite sides are positioned in duplex printing PPPPRRRRIIIINNNNTTTTIIIINNNNGGGG EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS Following printing examples assume that eeeennnnssssccccrrrriiiipppptttt uses the default configuration. If default actions have been changed from the configuration files, some examples will behave differently. Page 22 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) eeeennnnssssccccrrrriiiipppptttt ffffoooooooo....ttttxxxxtttt Print file ffffoooooooo....ttttxxxxtttt to the default printer. eeeennnnssssccccrrrriiiipppptttt ----PPPPoooossssssssuuuu ffffoooooooo....ttttxxxxtttt Print file ffffoooooooo....ttttxxxxtttt to printer oooossssssssuuuu. eeeennnnssssccccrrrriiiipppptttt ----ppppffffoooooooo....ppppssss ffffoooooooo....ttttxxxxtttt Print file ffffoooooooo....ttttxxxxtttt, but leave PostScript output to file ffffoooooooo....ppppssss. eeeennnnssssccccrrrriiiipppptttt ----2222 ffffoooooooo....ttttxxxxtttt Print file ffffoooooooo....ttttxxxxtttt to two columns. eeeennnnssssccccrrrriiiipppptttt ----2222rrrr ffffoooooooo....ttttxxxxtttt Print file to two columns and rotate output 90 degrees (landscape). eeeennnnssssccccrrrriiiipppptttt ----DDDDDDDDuuuupppplllleeeexxxx::::ttttrrrruuuueeee ffffoooooooo....ttttxxxxtttt Print file in duplex (two side) mode (printer dependant). eeeennnnssssccccrrrriiiipppptttt ----GGGG2222rrrrEEEE ----UUUU2222 ffffoooooooo....cccc My default code printing command: gaudy header, two columns, landscape, code highlighting, 2-up printing. eeeennnnssssccccrrrriiiipppptttt ----EEEE --------ccccoooolllloooorrrr ----WWWWhhhhttttmmmmllll --------ttttoooocccc ----ppppffffoooooooo....hhhhttttmmmmllll ****....hhhh ****....cccc A nice HTML report of your project's C source files. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT VVVVAAAARRRRIIIIAAAABBBBLLLLEEEESSSS The environment variable EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT can be used to pass default options for eeeennnnssssccccrrrriiiipppptttt. For example, to select the default body font to be Times-Roman 7pt, set the following value to the EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT environment variable: ----ffffTTTTiiiimmmmeeeessss----RRRRoooommmmaaaannnn7777 The value of the EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT variable is processed before the command line options, so command line options can be used to overwrite these defaults. Variable EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT____LLLLIIIIBBBBRRRRAAAARRRRYYYY specifies the eeeennnnssssccccrrrriiiipppptttt's library directory. It can be used to overwrite the build-in default `/usr/freeware/share/enscript'. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE EEEEnnnnssssccccrrrriiiipppptttt returns value 1 to the shell if any errors were encountered. On successfull termination, the return code is constucted from the following flags: Page 23 (printed 7/30/98) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT ((((JJJJuuuunnnn 22225555,,,, 1111999999998888)))) EEEENNNNSSSSCCCCRRRRIIIIPPPPTTTT((((1111)))) 0000 no errors or warnings 2222 some lines were truncated or wrapped 4444 some characters were missing from the used fonts 8888 some characters were unprintable FFFFIIIILLLLEEEESSSS /usr/freeware/share/enscript/*.hdr header files /usr/freeware/share/enscript/*.enc input encoding vectors /usr/freeware/share/enscript/enscript.proPostScript prolog /usr/freeware/share/enscript/*.afm AFM files for PostScript fonts /usr/freeware/share/enscript/font.map index for the AFM files /usr/freeware/share/enscript/enscript.ststates definition file /usr/freeware/etc/enscript.cfg system-wide configuration file /usr/freeware/etc/enscriptsite.cfg site configuration file ~/.enscriptrc personal configuration file ~/.enscript/ personal resource directory SSSSEEEEEEEE AAAALLLLSSSSOOOO diffpp(1), ghostview(1), gs(1), lpq(1), lpr(1), lprm(1), states(1) AAAAUUUUTTTTHHHHOOOORRRR Markku Rossi <mtr@iki.fi> <http://www.iki.fi/~mtr/> GNU Enscript WWW home page: <http://www.iki.fi/~mtr/genscript/> Page 24 (printed 7/30/98) 
