diff options
Diffstat (limited to 'src/devices/grops/grops.man')
| -rw-r--r-- | src/devices/grops/grops.man | 165 |
1 files changed, 97 insertions, 68 deletions
diff --git a/src/devices/grops/grops.man b/src/devices/grops/grops.man index e7e40fd3..25acfb27 100644 --- a/src/devices/grops/grops.man +++ b/src/devices/grops/grops.man @@ -23,8 +23,18 @@ the original English. .\" Like TP, but if specified indent is more than half .\" the current line-length - indent, use the default indent. .de Tp -.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP -.el .TP "\\$1" +. ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP +. el .TP "\\$1" +.. +. +.de TQ +. br +. ns +. TP \$1 +.. +. +.de FT +. if '\\*(.T'ps' .ft \\$1 .. . . @@ -125,13 +135,13 @@ A value of\~0 will cause grops not to employ any workarounds. . .IP Add\~1 if no -.B %%BeginDocumentSetup +.B %%Begin\%Document\%Setup and -.B %%EndDocumentSetup +.B %%End\%Document\%Setup comments should be generated; this is needed for early versions of TranScript that get confused by anything between the -.B %%EndProlog +.B %%End\%Prolog comment and the first .B %%Page comment. @@ -146,13 +156,13 @@ Add\~4 if .BR %%Page , .BR %%Trailer and -.B %%EndProlog +.B %%End\%Prolog comments should be stripped out of included files; this is needed for spoolers that don't understand the -.B %%BeginDocument +.B %%Begin\%Document and -.B %%EndDocument +.B %%End\%Document comments. . .IP @@ -166,7 +176,7 @@ page reversal. .IP Add\~16 if no media size information should be included in the document (this is, neither use -.B %%DocumentMedia +.B %%Document\%Media nor the .B setpagedevice PostScript command). @@ -274,15 +284,11 @@ The fonts are grouped into families .BR H , .BR HN , .BR N , -.B P +.BR P , and\~\c .B T having members in each of these styles: . -.de FT -.if '\\*(.T'ps' .ft \\$1 -.. -. .RS .TP .B AR @@ -290,187 +296,187 @@ having members in each of these styles: AvantGarde-Book .FT . -.TP +.TQ .B AI .FT AI AvantGarde-BookOblique .FT . -.TP +.TQ .B AB .FT AB AvantGarde-Demi .FT . -.TP +.TQ .B ABI .FT ABI AvantGarde-DemiOblique .FT . -.TP +.TQ .B BMR .FT BMR Bookman-Light .FT . -.TP +.TQ .B BMI .FT BMI Bookman-LightItalic .FT . -.TP +.TQ .B BMB .FT BMB Bookman-Demi .FT . -.TP +.TQ .B BMBI .FT BMBI Bookman-DemiItalic .FT . -.TP +.TQ .B CR .FT CR Courier .FT . -.TP +.TQ .B CI .FT CI Courier-Oblique .FT . -.TP +.TQ .B CB .FT CB Courier-Bold .FT . -.TP +.TQ .B CBI .FT CBI Courier-BoldOblique .FT . -.TP +.TQ .B HR .FT HR Helvetica .FT . -.TP +.TQ .B HI .FT HI Helvetica-Oblique .FT . -.TP +.TQ .B HB .FT HB Helvetica-Bold .FT . -.TP +.TQ .B HBI .FT HBI Helvetica-BoldOblique .FT . -.TP +.TQ .B HNR .FT HNR Helvetica-Narrow .FT . -.TP +.TQ .B HNI .FT HNI Helvetica-Narrow-Oblique .FT . -.TP +.TQ .B HNB .FT HNB Helvetica-Narrow-Bold .FT . -.TP +.TQ .B HNBI .FT HNBI Helvetica-Narrow-BoldOblique .FT . -.TP +.TQ .B NR .FT NR NewCenturySchlbk-Roman .FT . -.TP +.TQ .B NI .FT NI NewCenturySchlbk-Italic .FT . -.TP +.TQ .B NB .FT NB NewCenturySchlbk-Bold .FT . -.TP +.TQ .B NBI .FT NBI NewCenturySchlbk-BoldItalic .FT . -.TP +.TQ .B PR .FT PR Palatino-Roman .FT . -.TP +.TQ .B PI .FT PI Palatino-Italic .FT . -.TP +.TQ .B PB .FT PB Palatino-Bold .FT . -.TP +.TQ .B PBI .FT PBI Palatino-BoldItalic .FT . -.TP +.TQ .B TR .FT TR Times-Roman .FT . -.TP +.TQ .B TI .FT TI Times-Italic .FT . -.TP +.TQ .B TB .FT TB Times-Bold .FT . -.TP +.TQ .B TBI .FT TBI Times-BoldItalic @@ -490,9 +496,10 @@ ZapfChancery-MediumItalic . .LP There are also some special fonts called -.B SS -and\~\c -.BR S . +.B S +for the PS Symbol font, and +.BR SS , +containing slanted lowercase Greek letters taken from PS Symbol. . Zapf Dingbats is available as .BR ZD @@ -513,6 +520,10 @@ is used, for `cmy' and `cmyk' .BR setcmykcolor , and for `gray' .BR setgray . +Note that +.B setcmykcolor +is a PostScript LanguageLevel\~2 command and thus not available on some +older printers. . .LP .B grops @@ -702,7 +713,7 @@ arguments are not allowed to have attached scaling indicators. . If the PostScript file complies with the Adobe Document Structuring Conventions and contains a -.B %%BoundingBox +.B %%Bounding\%Box comment, then the bounding box can be automatically extracted from within groff by using the .B psbb @@ -763,9 +774,7 @@ option causes the graphic to be indented by\~\c . .TP .B \[rs]X'ps:\ invis' -.br -.ns -.TP +.TQ .B \[rs]X'ps:\ endinvis' No output will be generated for text and drawing commands that are bracketed with these @@ -812,7 +821,12 @@ whereas will print the .B \[rs](em character -and ignore the line. +and ignore the line (this code is already in file +.B Xps.tmac +which will be loaded if a documented intended for +.B grops +is previewed with +.BR gxditview ). .RE . .LP @@ -884,7 +898,8 @@ where is the PostScript name of the character, and .I code -is its position in the encoding expressed as a decimal integer. +is its position in the encoding expressed as a decimal integer; valid +values are in the range 0 to\~255. . Lines starting with .B # @@ -913,10 +928,24 @@ it can make use of such a character to generate more efficient and compact PostScript output. . .LP +Note that +.B grops +is able to display all glyphs in a PostScript font, not only 256. +.I enc_file +(or the default encoding if no encoding file specified) just defines the +order of glyphs for the first 256 characters; all other glyphs are +accessed with additional encoding vectors which +.B grops +produces on the fly. +. +.LP .B grops can automatically include the downloadable fonts necessary to print the document. -. +Such fonts must be in PFA format. +Use +.BR pfbtops (@MAN1EXT@) +to convert a Type\~1 font in PFB format. Any downloadable fonts which should, when required, be included by .B grops must be listed in the file @@ -997,30 +1026,30 @@ in the file. . A downloadable font should not include its own name in a -.B %%DocumentSuppliedResources +.B %%Document\%Supplied\%Resources comment. . .LP .B grops will not interpret -.B %%DocumentFonts +.B %%Document\%Fonts comments. . The -.BR %%DocumentNeededResources , -.BR %%DocumentSuppliedResources , -.BR %%IncludeResource , -.BR %%BeginResource +.BR %%Document\%Needed\%Resources , +.BR %%Document\%Supplied\%Resources , +.BR %%Include\%Resource , +.BR %%Begin\%Resource , and -.BR %%EndResource +.BR %%End\%Resource comments (or possibly the old -.BR %%DocumentNeededFonts , -.BR %%DocumentSuppliedFonts , -.BR %%IncludeFont , -.BR %%BeginFont +.BR %%Document\%Needed\%Fonts , +.BR %%Document\%Supplied\%Fonts , +.BR %%Include\%Font , +.BR %%Begin\%Font , and -.BR %%EndFont +.BR %%End\%Font comments) should be used. . @@ -1120,7 +1149,7 @@ Temporary file. .BR afmtodit (@MAN1EXT@), .BR groff (@MAN1EXT@), .BR @g@troff (@MAN1EXT@), -.BR psbb (@MAN1EXT@), +.BR pfbtops (@MAN1EXT@), .BR groff_out (@MAN5EXT@), .BR groff_font (@MAN5EXT@), .BR groff_char (@MAN7EXT@) |