Debian Codegraph @

upstream/debian-unstable/man1/grops.1

raw
1 .TH grops 1 "2026-04-22" "groff 1.24.1"
2 .SH Name
3 grops \-
4 .I groff
5 output driver for PostScript
6 .
7 .
8 .\" ====================================================================
9 .\" Legal Terms
10 .\" ====================================================================
11 .\"
12 .\" Copyright 1989-2014 Free Software Foundation, Inc.
13 .\" 2020-2024 G. Branden Robinson
14 .\"
15 .\" Permission is granted to make and distribute verbatim copies of this
16 .\" manual provided the copyright notice and this permission notice are
17 .\" preserved on all copies.
18 .\"
19 .\" Permission is granted to copy and distribute modified versions of
20 .\" this manual under the conditions for verbatim copying, provided that
21 .\" the entire resulting derived work is distributed under the terms of
22 .\" a permission notice identical to this one.
23 .\"
24 .\" Permission is granted to copy and distribute translations of this
25 .\" manual into another language, under the above conditions for
26 .\" modified versions, except that this permission notice may be
27 .\" included in translations approved by the Free Software Foundation
28 .\" instead of in the original English.
29 .
30 .
31 .\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
32 .do nr *groff_grops_1_man_C \n[.cp]
33 .cp 0
34 .
35 .\" Define fallback for groff 1.23's MR macro if the system lacks it.
36 .nr do-fallback 0
37 .if !\n(.f .nr do-fallback 1 \" mandoc
38 .if \n(.g .if !d MR .nr do-fallback 1 \" older groff
39 .if !\n(.g .nr do-fallback 1 \" non-groff *roff
40 .if \n[do-fallback] \{\
41 . de MR
42 . ie \\n(.$=1 \
43 . I \%\\$1
44 . el \
45 . IR \%\\$1 (\\$2)\\$3
46 . .
47 .\}
48 .rr do-fallback
49 .
50 .
51 .\" This macro definition is poor style from a portability standpoint,
52 .\" but it's a good test and demonstration of the standard font
53 .\" repertoire for the devices where it has any effect at all, and so
54 .\" should be retained.
55 .de FT
56 . if \\n[.$] .if !F \\$1 .ftr \\$1 R
57 . if '\\*(.T'ps' .ft \\$1
58 . if '\\*(.T'pdf' .ft \\$1
59 ..
60 .
61 .\" ====================================================================
62 .SH Synopsis
63 .\" ====================================================================
64 .
65 .SY grops
66 .RB [ \-glm ]
67 .RB [ \-b\~\c
68 .IR brokenness-flags ]
69 .RB [ \-c\~\c
70 .IR num-copies ]
71 .RB [ \-F\~\c
72 .IR font-directory ]
73 .RB [ \-I\~\c
74 .IR inclusion-directory ]
75 .RB [ \-p\~\c
76 .IR paper-format ]
77 .RB [ \-P\~\c
78 .IR prologue-file ]
79 .RB [ \-w\~\c
80 .IR rule-thickness ]
81 .RI [ file\~ .\|.\|.]
82 .YS
83 .
84 .
85 .P
86 .SY grops
87 .B \-\-help
88 .YS
89 .
90 .
91 .P
92 .SY grops
93 .B \-v
94 .YS
95 .
96 .SY grops
97 .B \%\-\-version
98 .YS
99 .
100 .
101 .\" ====================================================================
102 .SH Description
103 .\" ====================================================================
104 .
105 The GNU
106 .I roff
107 PostScript output driver translates the output of
108 .MR \%troff 1
109 into PostScript.
110 .
111 Normally,
112 .I grops
113 is invoked by
114 .MR groff 1
115 when the latter is given the
116 .RB \[lq] \-T\~ps \[rq]
117 option.
118 .
119 (In this installation,
120 .B \%ps
121 is the default output device.)
122 .
123 Use
124 .IR groff 's
125 .B \-P
126 option to pass any options shown above to
127 .IR grops .
128 .
129 If no
130 .I file
131 arguments are given,
132 or if
133 .I file
134 is \[lq]\-\[rq],
135 .I grotty
136 reads the standard input stream.
137 .
138 It writes to the standard output stream.
139 .
140 .
141 .P
142 When called with multiple
143 .I file
144 arguments,
145 .I grops
146 doesn't produce a valid document structure
147 (one conforming to the Document Structuring Conventions).
148 .
149 To print such catenated output,
150 it is necessary to deactivate DSC handling in the printing program or
151 previewer.
152 .
153 .
154 .P
155 See section \[lq]Font installation\[rq] below for a guide to installing
156 fonts for
157 .IR grops .
158 .
159 .
160 .\" ====================================================================
161 .SH Options
162 .\" ====================================================================
163 .
164 .B \-\-help
165 displays a usage message,
166 while
167 .B \-v
168 and
169 .B \%\-\-version
170 show version information;
171 all exit afterward.
172 .
173 .
174 .TP 8n \" "-F dir" + 2n
175 .BI \-b\~ n
176 Work around problems with spoolers,
177 previewers,
178 and older printers.
179 .
180 Normally,
181 .I grops
182 produces output at PostScript \%LanguageLevel\~2 that conforms to
183 version 3.0 of the Document Structuring Conventions.
184 .
185 Some software and devices can't handle such a data stream.
186 .
187 The value
188 .RI of\~ n
189 determines what
190 .I grops
191 does to make its output acceptable to such consumers.
192 .
193 If
194 .I n
195 is
196 .BR 0 ,
197 .I grops
198 employs no workarounds,
199 which is the default;
200 it can be changed by modifying the
201 .B broken
202 directive in
203 .IR grops 's
204 .I DESC
205 file.
206 .
207 .
208 .IP
209 Add\~1 to suppress generation of
210 .B %%Begin\%Document\%Setup
211 and
212 .B %%End\%Document\%Setup
213 comments;
214 this is needed for early versions of TranScript that get confused by
215 anything between the
216 .B %%End\%Prolog
217 comment and the first
218 .B %%Page
219 comment.
220 .
221 .
222 .IP
223 Add\~2 to omit lines in included files beginning with
224 .BR %!\& ,
225 which confuse Sun's
226 .I pageview
227 previewer.
228 .
229 .
230 .IP
231 Add\~4 to omit lines in included files beginning with
232 .BR %%Page ,
233 .B %%Trailer
234 and
235 .BR %%End\%Prolog ;
236 this is needed for spoolers that don't understand
237 .B %%Begin\%Document
238 and
239 .B %%End\%Document
240 comments.
241 .
242 .
243 .IP
244 Add\~8 to write
245 .B %!PS\-Adobe\-2.0
246 rather than
247 .B %!PS\-Adobe\-3.0
248 as the first line of the PostScript output;
249 this is needed when using Sun's Newsprint with a printer that requires
250 page reversal.
251 .
252 .
253 .IP
254 Add\~16 to omit media size information
255 (that is,
256 output neither a
257 .B %%Document\%Media
258 comment nor the
259 .B setpagedevice
260 PostScript command).
261 .
262 This was the behavior of
263 .I groff
264 1.18.1 and earlier;
265 it is
266 needed for older printers that don't understand PostScript
267 \%LanguageLevel\~2,
268 and is also necessary if the output is further processed to produce an
269 EPS file;
270 see subsection \[lq]Escapsulated PostScript\[rq] below.
271 .
272 .
273 .TP
274 .BI \-c\~ n
275 Output
276 .I n
277 copies of each page.
278 .
279 .
280 .TP
281 .BI \-F\~ dir
282 Prepend directory
283 .RI dir /dev name
284 to the search path for
285 font and device description and PostScript prologue files;
286 .I name
287 is the name of the device,
288 usually
289 .BR ps .
290 .
291 .
292 .TP
293 .B \-g
294 Generate PostScript code to guess the page length.
295 .
296 The guess is correct only if the imageable area is vertically centered
297 on the page.
298 .
299 This option allows you to generate documents that can be printed on both
300 U.S.\& letter and A4 paper formats without change.
301 .
302 .
303 .TP
304 .BI \-I\~ dir
305 Search the directory
306 .I dir
307 for files named in
308 .B \[rs]X\[aq]ps: file\[aq]
309 and
310 .B \[rs]X\[aq]ps: import\[aq]
311 escape sequences.
312 .
313 .B \-I
314 may be specified more than once;
315 each
316 .I dir
317 is searched in the given order.
318 .
319 To search the current working directory before others,
320 add
321 .RB \[lq] "\-I .\&" \[rq]
322 at the desired place;
323 it is otherwise searched last.
324 .
325 .
326 .TP
327 .B \-l
328 Use landscape orientation rather than portrait.
329 .
330 .
331 .TP
332 .B \-m
333 Turn on manual feed for the document.
334 .
335 .
336 .TP
337 .BI \-p\~ fmt
338 Set physical dimensions of output medium,
339 overriding the
340 .BR \%papersize ,
341 .BR \%paperlength ,
342 and
343 .B \%paperwidth
344 directives in the
345 .I DESC
346 file.
347 .
348 .I fmt
349 can be any argument accepted by the
350 .B \%papersize
351 directive;
352 see
353 .MR groff_font 5 .
354 .
355 .
356 .TP
357 .BI \-P\~ prologue
358 Use the file
359 .IR prologue ,
360 sought in the
361 .I groff
362 font search path,
363 as the PostScript prologue,
364 overriding the default
365 (see section \[lq]Files\[rq] below)
366 and the environment variable
367 .I GROPS_PROLOGUE.
368 .
369 .
370 .TP
371 .BI \-w\~ n
372 Draw rules (lines) with a thickness of
373 .IR n \~thousandths
374 of an em.
375 .
376 The default thickness is
377 .B 40
378 (0.04\~em).
379 .
380 .
381 .\" ====================================================================
382 .SH Usage
383 .\" ====================================================================
384 .
385 The input to
386 .I grops
387 must be in the format output by
388 .MR \%troff 1 ,
389 described in
390 .MR groff_out 5 .
391 .
392 In addition,
393 the device and font description files for the device used must meet
394 certain requirements.
395 .
396 The device resolution must be an integer multiple of\~72 times the
397 .BR sizescale .
398 .
399 The device description file must contain a valid paper format;
400 see
401 .MR groff_font 5 .
402 .
403 Each font description file must contain a directive
404 .
405 .RS
406 .EX
407 .RI internalname\~ psname
408 .EE
409 .RE
410 .
411 which says that the PostScript name of the font is
412 .IR psname .
413 .
414 .
415 .P
416 A font description file may also contain a directive
417 .
418 .RS
419 .EX
420 .RI encoding\~ enc-file
421 .EE
422 .RE
423 .
424 which says that
425 the PostScript font should be reencoded using the encoding described in
426 .IR enc-file ;
427 this file should consist of a sequence of lines of the form
428 .
429 .
430 .RS
431 .EX
432 .I pschar code
433 .EE
434 .RE
435 .
436 where
437 .I pschar
438 is the PostScript name of the character,
439 and
440 .I code
441 is its position in the encoding expressed as a decimal integer;
442 valid values are in the range 0 to\~255.
443 .
444 Lines starting with
445 .B #
446 and blank lines are ignored.
447 .
448 The code for each character given in the font description file must
449 correspond to the code for the character in encoding file,
450 or to the code in the default encoding for the font if the PostScript
451 font is not to be reencoded.
452 .
453 This code can be used with the
454 .B \[rs]N
455 escape sequence in
456 .I \%troff
457 to select the character,
458 even if it does not have a
459 .I groff
460 glyph name.
461 .
462 Every character in the font description file must exist in the
463 PostScript font,
464 and the widths given in the font description file must match the widths
465 used in the PostScript font.
466 .
467 .I grops
468 assumes that a character with a
469 .I groff
470 name of
471 .B space
472 is blank
473 (makes no marks on the page);
474 it can make use of such a character to generate more efficient and
475 compact PostScript output.
476 .
477 .
478 .P
479 .I grops
480 is able to display all glyphs in a PostScript font;
481 it is not limited to 256 of them.
482 .
483 .I enc-file
484 (or the default encoding if no encoding file is specified)
485 just defines the
486 order of glyphs for the first 256 characters;
487 all other glyphs are accessed with additional encoding vectors which
488 .I grops
489 produces on the fly.
490 .
491 .
492 .P
493 .I grops
494 can embed fonts in a document that are necessary to render it;
495 this is called \[lq]downloading\[rq].
496 .
497 Such fonts must be in PFA format.
498 .
499 Use
500 .MR pfbtops 1
501 to convert a Type\~1 font in PFB format.
502 .
503 Downloadable fonts must be listed a
504 .I download
505 file containing lines of the form
506 .
507 .RS
508 .EX
509 .I psname file
510 .EE
511 .RE
512 .
513 where
514 .I psname
515 is the PostScript name of the font,
516 and
517 .I file
518 is the name of the file containing it.
519 .
520 Blank lines and those
521 beginning with
522 .B #
523 are ignored;
524 fields are separated by tabs.
525 .
526 .I file
527 is sought using the same mechanism as for
528 .I groff
529 font description files.
530 .
531 The
532 .I download
533 file itself is as well;
534 currently,
535 the first matching file found in the device and font description search
536 path is used.
537 .
538 .
539 .P
540 If the file containing a downloadable font or imported document
541 conforms to the Adobe Document Structuring Conventions,
542 then
543 .I grops
544 interprets any comments in the files sufficiently to ensure that its
545 own output is conforming.
546 .
547 It also supplies any needed font resources that are listed in the
548 .I download
549 file
550 as well as any needed file resources.
551 .
552 It is also able to handle inter-resource dependencies.
553 .
554 For example,
555 suppose that you have a downloadable font called Garamond,
556 and also a downloadable font called Garamond-Outline which depends on
557 Garamond
558 (typically it would be defined to copy Garamond's font dictionary,
559 and change the PaintType),
560 then it is necessary for Garamond to appear before Garamond-Outline in
561 the PostScript document.
562 .
563 .I grops
564 handles this automatically provided that the downloadable font file
565 for Garamond-Outline indicates its dependence on Garamond by means of
566 the Document Structuring Conventions,
567 for example by beginning with the following lines.
568 .
569 .RS
570 .EX
571 %!PS\-Adobe\-3.0 Resource\-Font
572 %%DocumentNeededResources: font Garamond
573 %%EndComments
574 %%IncludeResource: font Garamond
575 .EE
576 .RE
577 .
578 In this case,
579 both Garamond and Garamond-Outline would need to be listed
580 in the
581 .I download
582 file.
583 .
584 A downloadable font should not include its own name in a
585 .B %%Document\%Supplied\%Resources
586 comment.
587 .
588 .
589 .P
590 .I grops
591 does not interpret
592 .B %%Document\%Fonts
593 comments.
594 .
595 The
596 .BR %%Document\%Needed\%Resources ,
597 .BR %%Document\%Supplied\%Resources ,
598 .BR %%Include\%Resource ,
599 .BR %%Begin\%Resource ,
600 and
601 .B %%End\%Resource
602 comments
603 (or possibly the old
604 .BR %%Document\%Needed\%Fonts ,
605 .BR %%Document\%Supplied\%Fonts ,
606 .BR %%Include\%Font ,
607 .BR %%Begin\%Font ,
608 and
609 .B %%End\%Font
610 comments)
611 should be used.
612 .
613 .
614 .P
615 The default stroke and fill colors are black.
616 .
617 For colors defined in the \[lq]rgb\[rq] color space,
618 .B setrgbcolor
619 is used;
620 for \[lq]cmy\[rq] and \[lq]cmyk\[rq],
621 .BR setcmykcolor ;
622 and for \[lq]gray\[rq],
623 .BR setgray .
624 .
625 .B setcmykcolor
626 is a PostScript \%LanguageLevel\~2 command and thus not available on
627 some older printers.
628 .
629 .
630 .\" ====================================================================
631 .SS Typefaces
632 .\" ====================================================================
633 .
634 Styles called
635 .BR R ,
636 .BR I ,
637 .BR B ,
638 and
639 .B BI
640 mounted at font positions 1 to\~4.
641 .
642 Text fonts are grouped into families
643 .BR A ,
644 .BR BM ,
645 .BR C ,
646 .BR H ,
647 .BR HN ,
648 .BR N ,
649 .BR P ,
650 .RB and\~ T ,
651 each having members in each of these styles.
652 .
653 .
654 .RS
655 .TP 8n \" BMBI + 2n + hand-tuned for PDF
656 .B AR
657 .FT AR
658 AvantGarde-Book
659 .FT
660 .
661 .TQ
662 .B AI
663 .FT AI
664 AvantGarde-BookOblique
665 .FT
666 .
667 .TQ
668 .B AB
669 .FT AB
670 AvantGarde-Demi
671 .FT
672 .
673 .TQ
674 .B ABI
675 .FT ABI
676 AvantGarde-DemiOblique
677 .FT
678 .
679 .TQ
680 .B BMR
681 .FT BMR
682 Bookman-Light
683 .FT
684 .
685 .TQ
686 .B BMI
687 .FT BMI
688 Bookman-LightItalic
689 .FT
690 .
691 .TQ
692 .B BMB
693 .FT BMB
694 Bookman-Demi
695 .FT
696 .
697 .TQ
698 .B BMBI
699 .FT BMBI
700 Bookman-DemiItalic
701 .FT
702 .
703 .TQ
704 .B CR
705 .FT CR
706 Courier
707 .FT
708 .
709 .TQ
710 .B CI
711 .FT CI
712 Courier-Oblique
713 .FT
714 .
715 .TQ
716 .B CB
717 .FT CB
718 Courier-Bold
719 .FT
720 .
721 .TQ
722 .B CBI
723 .FT CBI
724 Courier-BoldOblique
725 .FT
726 .
727 .TQ
728 .B HR
729 .FT HR
730 Helvetica
731 .FT
732 .
733 .TQ
734 .B HI
735 .FT HI
736 Helvetica-Oblique
737 .FT
738 .
739 .TQ
740 .B HB
741 .FT HB
742 Helvetica-Bold
743 .FT
744 .
745 .TQ
746 .B HBI
747 .FT HBI
748 Helvetica-BoldOblique
749 .FT
750 .
751 .TQ
752 .B HNR
753 .FT HNR
754 Helvetica-Narrow
755 .FT
756 .
757 .TQ
758 .B HNI
759 .FT HNI
760 Helvetica-Narrow-Oblique
761 .FT
762 .
763 .TQ
764 .B HNB
765 .FT HNB
766 Helvetica-Narrow-Bold
767 .FT
768 .
769 .TQ
770 .B HNBI
771 .FT HNBI
772 Helvetica-Narrow-BoldOblique
773 .FT
774 .
775 .TQ
776 .B NR
777 .FT NR
778 NewCenturySchlbk-Roman
779 .FT
780 .
781 .TQ
782 .B NI
783 .FT NI
784 NewCenturySchlbk-Italic
785 .FT
786 .
787 .TQ
788 .B NB
789 .FT NB
790 NewCenturySchlbk-Bold
791 .FT
792 .
793 .TQ
794 .B NBI
795 .FT NBI
796 NewCenturySchlbk-BoldItalic
797 .FT
798 .
799 .TQ
800 .B PR
801 .FT PR
802 Palatino-Roman
803 .FT
804 .
805 .TQ
806 .B PI
807 .FT PI
808 Palatino-Italic
809 .FT
810 .
811 .TQ
812 .B PB
813 .FT PB
814 Palatino-Bold
815 .FT
816 .
817 .TQ
818 .B PBI
819 .FT PBI
820 Palatino-BoldItalic
821 .FT
822 .
823 .TQ
824 .B TR
825 .FT TR
826 Times-Roman
827 .FT
828 .
829 .TQ
830 .B TI
831 .FT TI
832 Times-Italic
833 .FT
834 .
835 .TQ
836 .B TB
837 .FT TB
838 Times-Bold
839 .FT
840 .
841 .TQ
842 .B TBI
843 .FT TBI
844 Times-BoldItalic
845 .FT
846 .RE
847 .
848 .
849 .br
850 .ne 3v
851 .P
852 Another text font is not a member of a family.
853 .
854 .
855 .RS
856 .TP 8n \" BMBI (above) + 2n + hand-tuned for PDF
857 .B ZCMI
858 .FT ZCMI
859 ZapfChancery-MediumItalic
860 .FT
861 .RE
862 .
863 .
864 .P
865 Special fonts include
866 .BR S ,
867 the PostScript Symbol font;
868 .BR ZD ,
869 Zapf Dingbats;
870 .B SS
871 (slanted symbol),
872 which contains oblique forms of lowercase Greek letters derived from
873 Symbol;
874 .BR EURO ,
875 which offers a Euro glyph for use with old devices lacking it;
876 and
877 .BR ZDR ,
878 a reversed version of Zapf Dingbats
879 (with symbols flipped about the vertical axis).
880 .
881 Most glyphs in these fonts are unnamed and must be accessed using
882 .BR \[rs]N .
883 .
884 The last three are not standard PostScript fonts,
885 but supplied by
886 .I groff
887 and therefore included in the default
888 .I download
889 file.
890 .
891 .
892 .P
893 .I grops
894 furthermore supports a naming scheme for East Asian typefaces
895 shared with
896 .MR grohtml 1 ,
897 .MR gropdf 1 ,
898 and
899 .MR grotty 1 .
900 .
901 .
902 .RS
903 .TP
904 .B CSH
905 Simplified Chinese,
906 Hei style
907 .
908 .TQ
909 .B CSS
910 Simplified Chinese,
911 Song style
912 .
913 .TQ
914 .B CTH
915 Traditional Chinese,
916 Hei style
917 .
918 .TQ
919 .B CTS
920 Traditional Chinese,
921 Song style
922 .
923 .TQ
924 .B JPG
925 Japanese,
926 Gothic style
927 .
928 .TQ
929 .B JPM
930 Japanese,
931 Mincho style
932 .
933 .TQ
934 .B KOG
935 Korean,
936 Gothic style
937 .
938 .TQ
939 .B KOM
940 Korean,
941 Mincho style
942 .RE
943 .
944 .
945 .\" ====================================================================
946 .SS "Device extension commands"
947 .\" ====================================================================
948 .
949 .I grops
950 recognizes device extension commands produced by the
951 .I groff
952 request
953 .B \%device
954 or
955 .I roff
956 .B \[rs]X
957 escape sequence,
958 but interprets only those that begin with a
959 .RB \[lq] ps: \[rq]
960 tag.
961 .
962 .
963 .TP
964 .BI "\[rs]X\[aq]ps: exec\~" code \[aq]
965 .RS
966 Execute the arbitrary PostScript commands
967 .IR code .
968 .
969 The PostScript
970 .I \%currentpoint
971 is set to the
972 .I groff
973 drawing position when the
974 .B \[rs]X
975 escape sequence is interpreted before executing
976 .IR code .
977 .
978 The origin is at the top left corner of the page;
979 .IR x \~coordinates
980 increase to the right,
981 and
982 .IR y \~coordinates
983 down the page.
984 .
985 A
986 .RB procedure\~ u
987 is defined that converts
988 .I groff
989 basic units to the coordinate system in effect
990 (provided the user doesn't change the scale).
991 .
992 For example,
993 .
994 .RS
995 .EX
996 \&.nr x 1i
997 \[rs]X\[aq]ps: exec \[rs]nx u 0 rlineto stroke\[aq]
998 .EE
999 .RE
1000 .
1001 draws a horizontal line one inch long.
1002 .
1003 .I code
1004 may make changes to the graphics state,
1005 but any changes persist only to the end of the page.
1006 .
1007 A dictionary containing the definitions specified by the
1008 .B def
1009 and
1010 .B mdef
1011 commands is on top of the dictionary stack.
1012 .
1013 If your code adds definitions to this dictionary,
1014 you should allocate space for them using
1015 .RB \[lq] "\[rs]X\[aq]ps:\~mdef\~"
1016 .IB n \[aq]\c
1017 \[rq].
1018 .
1019 Any definitions persist only until the end of the page.
1020 .
1021 If you use the
1022 .B \[rs]Y
1023 escape sequence with an argument that names a macro,
1024 .I code
1025 can extend over multiple lines.
1026 .
1027 For example,
1028 .
1029 .RS
1030 .EX
1031 \&.nr x 1i
1032 \&.de y
1033 \&ps: exec
1034 \&\[rs]nx u 0 rlineto
1035 \&stroke
1036 \&..
1037 \&\[rs]Yy
1038 .EE
1039 .RE
1040 .
1041 is another way to draw a horizontal line one inch long.
1042 .
1043 The single backslash before
1044 .RB \[lq] nx \[rq]\[em]the
1045 only reason to use a register while defining the macro
1046 .RB \[lq] y \[rq]\[em]is
1047 to convert a user-specified dimension
1048 .RB \[lq] 1i \[rq]
1049 to
1050 .I groff
1051 basic units which are in turn converted to PostScript units with the
1052 .B u
1053 procedure.
1054 .
1055 .
1056 .br
1057 .ne 3v
1058 .P
1059 .I grops
1060 wraps user-specified PostScript code into a dictionary,
1061 nothing more.
1062 .
1063 In particular,
1064 it doesn't start and end the inserted code with
1065 .B save
1066 and
1067 .BR restore ,
1068 respectively.
1069 .
1070 This must be supplied by the user,
1071 if necessary.
1072 .RE
1073 .
1074 .
1075 .TP
1076 .BI "\[rs]X\[aq]ps: file\~" name \[aq]
1077 This is the same as the
1078 .B exec
1079 command except that the PostScript code is read from file
1080 .IR name .
1081 .
1082 .
1083 .TP
1084 .BI "\[rs]X\[aq]ps: def\~" code \[aq]
1085 Place a PostScript definition contained in
1086 .I code
1087 in the prologue.
1088 .
1089 There should be at most one definition per
1090 .B \[rs]X
1091 command.
1092 .
1093 Long definitions can be split over several
1094 .B \[rs]X
1095 commands;
1096 all the
1097 .I code
1098 arguments are simply joined together separated by newlines.
1099 .
1100 The definitions are placed in a dictionary which is automatically
1101 pushed on the dictionary stack when an
1102 .B exec
1103 command is executed.
1104 .
1105 If you use the
1106 .B \[rs]Y
1107 escape sequence with an argument that names a macro,
1108 .I code
1109 can extend over multiple lines.
1110 .
1111 .
1112 .TP
1113 .BI "\[rs]X\[aq]ps: mdef\~" "n code" \[aq]
1114 Like
1115 .BR def ,
1116 except that
1117 .I code
1118 may contain up to
1119 .IR n \~definitions.
1120 .
1121 .I grops
1122 needs to know how many definitions
1123 .I code
1124 contains
1125 so that it can create an appropriately sized PostScript dictionary
1126 to contain them.
1127 .
1128 .
1129 .TP
1130 .BI "\[rs]X\[aq]ps: import\~" "file llx lly urx ury width\~"\c
1131 .RI [ height ]\c
1132 .B \[aq]
1133 Import a PostScript graphic from
1134 .IR file .
1135 .
1136 The arguments
1137 .IR llx ,
1138 .IR lly ,
1139 .IR urx ,
1140 and
1141 .I ury
1142 give the bounding box of the graphic in the default PostScript
1143 coordinate system.
1144 .
1145 They should all be integers:
1146 .I llx
1147 and
1148 .I lly
1149 are the
1150 .I x
1151 and
1152 .IR y \~coordinates
1153 of the lower left corner of the graphic;
1154 .I urx
1155 and
1156 .I ury
1157 are the
1158 .I x
1159 and
1160 .IR y \~coordinates
1161 of the upper right corner of the graphic;
1162 .I width
1163 and
1164 .I height
1165 are integers that give the desired width and height in
1166 .I groff
1167 basic units of the graphic.
1168 .
1169 .
1170 .IP
1171 The graphic is scaled so that it has this width and height
1172 and translated so that the lower left corner of the graphic is
1173 located at the position associated with
1174 .B \[rs]X
1175 command.
1176 .
1177 If the height argument is omitted it is scaled uniformly in the
1178 .I x
1179 and
1180 .IR y \~axes
1181 so that it has the specified width.
1182 .
1183 .
1184 .IP
1185 The contents of the
1186 .B \[rs]X
1187 command are not interpreted by
1188 .IR \%troff ,
1189 so vertical space for the graphic is not automatically added,
1190 and the
1191 .I width
1192 and
1193 .I height
1194 arguments are not allowed to have attached scaling indicators.
1195 .
1196 .
1197 .IP
1198 If the PostScript file complies with the Adobe Document Structuring
1199 Conventions and contains a
1200 .B %%Bounding\%Box
1201 comment,
1202 then the bounding box can be automatically extracted from within
1203 .I groff
1204 input by using the
1205 .B psbb
1206 request.
1207 .
1208 .
1209 .IP
1210 See
1211 .MR groff_tmac 5
1212 for a description of the
1213 .B PSPIC
1214 macro which provides a convenient high-level interface for inclusion of
1215 PostScript graphics.
1216 .
1217 .
1218 .TP
1219 .B \[rs]X\[aq]ps: invis\[aq]
1220 .TQ
1221 .B \[rs]X\[aq]ps: endinvis\[aq]
1222 No output is generated for text and drawing commands
1223 that are bracketed with these
1224 .B \[rs]X
1225 commands.
1226 .
1227 These commands are intended for use when output from
1228 .I \%troff
1229 is previewed before being processed with
1230 .IR grops ;
1231 if the previewer is unable to display certain characters
1232 or other constructs,
1233 then other substitute characters or constructs can be used for
1234 previewing by bracketing them with these
1235 .B \[rs]X
1236 commands.
1237 .
1238 .
1239 .RS
1240 .P
1241 For example,
1242 .I \%gxditview
1243 is not able to display a proper
1244 .B \[rs][em]
1245 character because the standard X11 fonts do not provide it;
1246 this problem can be overcome with the following request.
1247 .
1248 .
1249 .IP
1250 .EX
1251 \&.char \[rs][em] \[rs]X\[aq]ps: invis\[aq]\[rs]
1252 \[rs]Z\[aq]\[rs]v\[aq]-.25m\[aq]\[rs]h\[aq].05m\[aq]\c
1253 \[rs]D\[aq]l .9m 0\[aq]\[rs]h\[aq].05m\[aq]\[aq]\[rs]
1254 \[rs]X\[aq]ps: endinvis\[aq]\[rs][em]
1255 .EE
1256 .
1257 .
1258 .P
1259 In this case,
1260 .I \%gxditview
1261 is unable to display the
1262 .B \[rs][em]
1263 character and draws the line,
1264 whereas
1265 .I grops
1266 prints the
1267 .B \[rs][em]
1268 character
1269 and ignores the line
1270 (this code is already in file
1271 .IR Xps.tmac ,
1272 which is loaded if a document intended for
1273 .I grops
1274 is previewed with
1275 .IR \%gxditview ).
1276 .RE
1277 .
1278 .
1279 .br
1280 .ne 3v
1281 .P
1282 If a PostScript procedure
1283 .B BPhook
1284 has been defined via a
1285 .RB \[lq] "ps:\~def" \[rq]
1286 or
1287 .RB \[lq] "ps:\~mdef" \[rq]
1288 device extension command,
1289 it is executed at the beginning of every page
1290 (before anything is drawn or written by
1291 .IR groff ).
1292 .
1293 For example,
1294 to underlay the page contents with the word \[lq]DRAFT\[rq] in light
1295 gray,
1296 you might use the following.
1297 .
1298 .RS
1299 .EX
1300 \&.de XX
1301 ps: def
1302 /BPhook
1303 { gsave .9 setgray clippath pathbbox exch 2 copy
1304 .5 mul exch .5 mul translate atan rotate pop pop
1305 /NewCenturySchlbk-Roman findfont 200 scalefont setfont
1306 (DRAFT) dup stringwidth pop \-.5 mul \-70 moveto show
1307 grestore }
1308 def
1309 \&..
1310 \&.devicem XX
1311 .EE
1312 .RE
1313 .
1314 .
1315 .P
1316 Or,
1317 to cause lines and polygons to be drawn with square linecaps and mitered
1318 linejoins instead of the round linecaps and linejoins normally used by
1319 .IR grops ,
1320 use the following.
1321 .
1322 .RS
1323 .EX
1324 \&.de XX
1325 ps: def
1326 /BPhook { 2 setlinecap 0 setlinejoin } def
1327 \&..
1328 \&.devicem XX
1329 .EE
1330 .RE
1331 .
1332 (Square linecaps,
1333 as opposed to butt linecaps
1334 .RB (\[lq] "0 setlinecap" \[rq]),
1335 give true corners in boxed tables even though the lines are drawn
1336 unconnected.)
1337 .
1338 .
1339 .\" ====================================================================
1340 .SS "Encapsulated PostScript"
1341 .\" ====================================================================
1342 .
1343 .I grops
1344 itself doesn't emit bounding box information.
1345 .
1346 The following script,
1347 .IR groff2eps ,
1348 produces an EPS file.
1349 .
1350 .
1351 .RS
1352 .P
1353 .EX
1354 #!/bin/sh
1355 groff \-P\-b16 "$1" > "$1".ps
1356 gs \-dNOPAUSE \-sDEVICE=bbox \-\- "$1".ps 2> "$1".bbox
1357 sed \-e "/\[ha]%%Orientation/r $1.bbox" \[rs]
1358 \-e "/\[ha]%!PS\-Adobe\-3.0/s/$/ EPSF\-3.0/" "$1".ps > "$1".eps
1359 rm "$1".ps "$1".bbox
1360 .EE
1361 .RE
1362 .
1363 .
1364 .P
1365 You can then use
1366 .RB \[lq] "groff2eps foo" \[rq]
1367 to convert file
1368 .I foo
1369 to
1370 .IR foo.eps .
1371 .
1372 .
1373 .\" ====================================================================
1374 .SS "TrueType and other font formats"
1375 .\" ====================================================================
1376 .
1377 To use TrueType fonts with
1378 .IR grops ,
1379 convert them first to Type\~42 format,
1380 a PostScript wrapper equivalent to the PFA format described in
1381 .MR pfbtops 1 .
1382 .
1383 Several methods exist to generate a Type\~42 wrapper;
1384 some of them involve the use of a PostScript interpreter such as
1385 Ghostscript\[em]see
1386 .MR gs 1 .
1387 .
1388 .
1389 .P
1390 .UR https://fontforge.org/
1391 FontForge
1392 .UE
1393 converts most outline font formats.
1394 .
1395 Here's how we'd set up Roboto Slab Serif for use with
1396 .IR groff .
1397 .
1398 .
1399 .RS 4
1400 .P
1401 .EX
1402 MAP=/usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%font/devps/generate/text.map
1403 TTF=/usr/share/fonts/truetype/roboto/slab/RobotoSlab\-Regular.ttf
1404 BASE=$(basename \[dq]$TTF\[dq])
1405 INT=${BASE%.ttf}
1406 PFA=$INT.pfa
1407 AFM=$INT.afm
1408 GFN=RSR
1409 DIR=$HOME/.local/groff/font
1410 mkdir \-p \[dq]$DIR\[dq]/devps
1411 fontforge \-lang=ff \-c \[dq]Open(\[rs]\[dq]$TTF\[rs]\[dq]);\[rs]
1412 \tGenerate(\[rs]\[dq]$DIR/devps/$PFA\[rs]\[dq]);\[dq]
1413 afmtodit \[dq]$DIR/devps/$AFM\[dq] \[dq]$MAP\[dq] \
1414 \[dq]$DIR/devps/$GFN\[dq]
1415 printf \[dq]$BASE\[rs]t$PFA\[rs]n\[dq] >> \[dq]$DIR/devps/download\[dq]
1416 .EE
1417 .RE
1418 .
1419 .
1420 .P
1421 .I fontforge
1422 and
1423 .I afmtodit
1424 may produce warnings depending on font file attributes.
1425 .
1426 Test the font as follows.
1427 .
1428 .
1429 .RS 4
1430 .P
1431 .EX
1432 printf \[dq].ft RSR\[rs]nHello, world!\[rs]n\[dq] | groff \-F \
1433 \[dq]$DIR\[dq] > hello.ps
1434 .EE
1435 .RE
1436 .
1437 .
1438 .P
1439 Once you're satisfied that the font works,
1440 you may want to generate any available related styles
1441 (for instance,
1442 Roboto Slab
1443 also has \[lq]Bold\[rq],
1444 \[lq]Light\[rq],
1445 and
1446 \[lq]Thin\[rq]
1447 styles)
1448 and set up
1449 .I GROFF_FONT_PATH
1450 in your environment to include the directory you keep the generated
1451 fonts in so that you don't have to use the
1452 .B \-F
1453 option.
1454 .
1455 .
1456 .\" ====================================================================
1457 .SH "Font installation"
1458 .\" ====================================================================
1459 .
1460 For your convenience,
1461 .I groff
1462 offers
1463 .IR install\-font.bash ,
1464 a shell script that interactively assists
1465 the configuration of fonts for use with the
1466 GNU
1467 .I troff \" GNU
1468 formatter
1469 and the
1470 .I grops
1471 output driver.
1472 .
1473 See section \[lq]Files\[rq] below.
1474 .
1475 .
1476 .P
1477 The following is a step-by-step font installation guide for
1478 .I grops.
1479 .
1480 .
1481 .IP \[bu] 3n
1482 Convert your font to something
1483 .I groff
1484 understands.
1485 .
1486 This is a PostScript Type\~1 font in PFA format or a PostScript
1487 Type\~42 font,
1488 together with an AFM file.
1489 .
1490 A PFA file begins as follows.
1491 .
1492 .RS
1493 .RS \" two RS calls to get inboard of IP indentation
1494 .EX
1495 %!PS\-AdobeFont\-1.0:
1496 .EE
1497 .RE
1498 .
1499 A PFB file contains this string as well,
1500 preceded by some non-printing bytes.
1501 .
1502 If your font is in PFB format,
1503 use
1504 .IR groff 's
1505 .MR pfbtops 1
1506 program to convert it to PFA.
1507 .
1508 For TrueType and other font formats,
1509 we recommend
1510 .IR fontforge ,
1511 which can convert most outline font formats.
1512 .
1513 A Type\~42 font file begins as follows.
1514 .
1515 .RS
1516 .EX
1517 %!PS\-TrueTypeFont
1518 .EE
1519 .RE
1520 .
1521 This is a wrapper format for TrueType fonts.
1522 .
1523 Old PostScript printers might not support them
1524 (that is,
1525 they might not have a built-in TrueType font interpreter).
1526 .
1527 In the following steps,
1528 we will consider the use of CTAN's
1529 .UR https://\:ctan.org/\:tex\-archive/\:fonts/\:brushscr
1530 BrushScriptX-Italic
1531 .UE
1532 font in PFA format.
1533 .RE \" now restore left margin
1534 .
1535 .
1536 .IP \[bu]
1537 Convert the AFM file to a
1538 .I groff
1539 font description file with the
1540 .MR afmtodit 1
1541 program.
1542 .
1543 For instance,
1544 .
1545 .RS
1546 .RS \" two RS calls to get inboard of IP indentation
1547 .EX
1548 $ \c
1549 .B afmtodit BrushScriptX\-Italic.afm text.map BSI
1550 .EE
1551 .RE
1552 .
1553 converts the Adobe Font Metric file
1554 .I BrushScriptX\-Italic.afm
1555 to the
1556 .I groff
1557 font description file
1558 .IR BSI .
1559 .RE \" now restore left margin
1560 .
1561 .
1562 .IP
1563 If you have a font family which provides regular upright (roman),
1564 bold,
1565 italic,
1566 and
1567 bold-italic styles
1568 (where \[lq]italic\[rq] may be \[lq]oblique\[rq] or \[lq]slanted\[rq]),
1569 we recommend using the letters
1570 .BR R ,
1571 .BR B ,
1572 .BR I ,
1573 and
1574 .BR BI ,
1575 respectively,
1576 as suffixes to the
1577 .I groff
1578 font family name to enable
1579 .IR groff 's
1580 font family and style selection features.
1581 .
1582 An example is
1583 .IR groff 's
1584 built-in support for Times:
1585 the font family
1586 name is abbreviated as
1587 .BR T ,
1588 and the
1589 .I groff
1590 font names are therefore
1591 .BR TR ,
1592 .BR TB ,
1593 .BR TI ,
1594 and
1595 .BR TBI .
1596 .
1597 In our example,
1598 however,
1599 the BrushScriptX font is available in a single style only,
1600 italic.
1601 .
1602 .
1603 .IP \[bu]
1604 Install the
1605 .I groff
1606 font description file(s) in a
1607 .I devps
1608 subdirectory in the search path that
1609 .I groff
1610 uses for device and font file descriptions.
1611 .
1612 See the
1613 .I GROFF_FONT_PATH
1614 entry in section \[lq]Environment\[rq] of
1615 .MR \%troff 1
1616 for the current value of the font search path.
1617 .
1618 While
1619 .I groff
1620 doesn't directly use AFM files,
1621 it is a good idea to store them alongside its font description files.
1622 .
1623 .
1624 .IP \[bu]
1625 Register fonts in the
1626 .I devps/download
1627 file so they can be located for embedding in PostScript files
1628 .I grops
1629 generates.
1630 .
1631 Only the first
1632 .I download
1633 file encountered in the font search path is read.
1634 .
1635 If in doubt,
1636 copy the default
1637 .I download
1638 file
1639 (see section \[lq]Files\[rq] below)
1640 to the first directory in the font search path and add your fonts there.
1641 .
1642 The PostScript font name used by
1643 .I grops
1644 is stored in the
1645 .B internalname
1646 field in the
1647 .I groff
1648 font description file.
1649 .
1650 (This name does not necessarily resemble the font's file name.)
1651 .
1652 We add the following line to
1653 .IR download .
1654 .
1655 .RS
1656 .RS \" two RS calls to get inboard of IP indentation
1657 .EX
1658 BrushScriptX\-Italic\[->]BrushScriptX\-Italic.pfa
1659 .EE
1660 .RE \" but only one to get back to it
1661 .
1662 A tab character,
1663 depicted as \[->],
1664 separates the fields.
1665 .RE \" now restore left margin
1666 .
1667 .
1668 .IP \[bu]
1669 Test the selection and embedding of the new font.
1670 .
1671 .RS
1672 .RS \" two RS calls to get inboard of IP indentation
1673 .EX
1674 printf "\[rs]\[rs]f[BSI]Hello, world!\[rs]n" \
1675 | groff \-T ps >hello.ps
1676 see hello.pdf
1677 .EE
1678 .RE
1679 .RE \" now restore left margin
1680 .
1681 .
1682 .\" ====================================================================
1683 .SH "Old fonts"
1684 .\" ====================================================================
1685 .
1686 .I groff
1687 versions 1.19.2 and earlier contained descriptions of a slightly
1688 different set of the base 35 PostScript level 2 fonts defined by Adobe.
1689 .
1690 The older set has 314 glyphs and a larger set of kerning pairs;
1691 the newer one has only 229 glyphs,
1692 but includes the Euro sign.
1693 .
1694 For backward compatibility,
1695 these old font descriptions are also installed in the
1696 .I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%oldfont/\:\%devps
1697 directory.
1698 .
1699 .
1700 .P
1701 To use them,
1702 make sure that
1703 .I grops
1704 finds the fonts before the default system fonts
1705 (with the same names):
1706 either give
1707 .I grops
1708 the
1709 .B \-F
1710 command-line option,
1711 .
1712 .RS
1713 .EX
1714 $ \c
1715 .B groff \-Tps \-P\-F \-P/usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%oldfont \c
1716 \&.\|.\|.
1717 .EE
1718 .RE
1719 .
1720 or add the directory to
1721 .IR groff 's
1722 font and device description search path environment variable,
1723 .
1724 .RS
1725 .EX
1726 $ \c
1727 .B GROFF_FONT_PATH=\:/usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%oldfont \[rs]
1728 .RS
1729 .B groff \-Tps \c
1730 \&.\|.\|.
1731 .RE
1732 .EE
1733 .RE
1734 .
1735 when the command runs.
1736 .
1737 .
1738 .\" ====================================================================
1739 .SH "Exit status"
1740 .\" ====================================================================
1741 .
1742 .I \%grops
1743 exits with
1744 .RB status\~ 0
1745 on successful operation,
1746 .RB status\~ 2
1747 if the program cannot interpret its command-line arguments,
1748 and
1749 .RB status\~ 1
1750 if it encounters an error during operation.
1751 .
1752 .
1753 .br
1754 .ne 3v
1755 .\" ====================================================================
1756 .SH Environment
1757 .\" ====================================================================
1758 .
1759 .TP
1760 .I GROFF_FONT_PATH
1761 A list of directories in which to seek the selected output device's
1762 directory of device and font description files.
1763 .
1764 See
1765 .MR \%troff 1
1766 and
1767 .MR groff_font 5 .
1768 .
1769 .
1770 .TP
1771 .I GROPS_PROLOGUE
1772 If this is set to
1773 .IR foo ,
1774 then
1775 .I grops
1776 uses the file
1777 .I foo
1778 (in the font path) instead of the default prologue file
1779 .IR prologue .
1780 .
1781 The option
1782 .B \-P
1783 overrides this environment variable.
1784 .
1785 .
1786 .TP
1787 .I SOURCE_DATE_EPOCH
1788 A timestamp
1789 (expressed as seconds since the Unix epoch)
1790 to use as the output creation timestamp in place of the current time.
1791 .
1792 The time is converted to human-readable form using
1793 .MR gmtime 3
1794 and
1795 .MR asctime 3 ,
1796 and recorded in a PostScript comment.
1797 .
1798 .
1799 .TP
1800 .I TZ
1801 The time zone to use when converting the current time to human-readable form;
1802 see
1803 .MR tzset 3 .
1804 If
1805 .I SOURCE_DATE_EPOCH
1806 is used, it is always converted to human-readable form using UTC.
1807 .
1808 .
1809 .\" ====================================================================
1810 .SH Files
1811 .\" ====================================================================
1812 .
1813 .TP
1814 .I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%font/\:\%devps/\:DESC
1815 describes the
1816 .B ps
1817 output device.
1818 .
1819 .
1820 .TP
1821 .IR /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%font/\:\%devps/ F
1822 describes the font known
1823 .RI as\~ F
1824 on device
1825 .BR ps .
1826 .
1827 .
1828 .TP
1829 .I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%font/\:\%devps/\:\%download
1830 lists fonts available for embedding within the PostScript document
1831 (or download to the device).
1832 .
1833 .
1834 .TP
1835 .I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%font/\:\%devps/\:\%prologue
1836 is the default PostScript prologue prefixed to every output file.
1837 .
1838 .
1839 .TP
1840 .I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%font/\:\%devps/\:text.enc
1841 describes the encoding scheme used by most PostScript Type\~1 fonts;
1842 the
1843 .B \%encoding
1844 directive of
1845 font description files for the
1846 .B ps
1847 device refers to it.
1848 .
1849 .
1850 .TP
1851 .I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%tmac/\:ps.tmac
1852 defines macros for use with the
1853 .B ps
1854 output device.
1855 .
1856 It is automatically loaded by
1857 .I troffrc
1858 when the
1859 .B ps
1860 output device is selected.
1861 .
1862 .
1863 .TP
1864 .I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%tmac/\:pspic.tmac
1865 defines the
1866 .B PSPIC
1867 macro for embedding images in a document;
1868 see
1869 .MR groff_tmac 5 .
1870 .
1871 It is automatically loaded by
1872 .I troffrc.
1873 .
1874 .
1875 .TP
1876 .I /usr/\:\%share/\:\%groff/\:\%1.24.1/\:\%tmac/psold.tmac
1877 provides replacement glyphs for text fonts that lack complete coverage
1878 of the ISO\~Latin-1 character set;
1879 using it,
1880 .I groff
1881 can produce glyphs like eth (\[Sd]) and thorn (\[Tp]) that older
1882 PostScript printers do not natively support.
1883 .
1884 .
1885 .TP
1886 .I /usr/\:\%share/\:\%doc/\:\%groff\-base/\:\%examples/\:install\-font\:.bash
1887 This script,
1888 contributed by
1889 .I mom
1890 macro package author Peter Schaffter
1891 and long available at his web site,
1892 assists with making
1893 TrueType
1894 .RI ( .ttf ),
1895 OpenType
1896 .RI ( .otf ),
1897 and PostScript Type\~1
1898 .RI ( .pfa ,
1899 .IR .pfb )
1900 fonts available to
1901 .IR groff .
1902 .
1903 .IP
1904 Change to its directory and run
1905 .RB \[lq] "bash install\-font.bash \-H" \[rq]
1906 for a man page-like description of its features and operation.
1907 .
1908 .
1909 .P
1910 .I grops
1911 creates temporary files using the template
1912 .RI \[lq] grops XXXXXX\[rq];
1913 see
1914 .MR groff 1 .
1915 .
1916 .
1917 .\" ====================================================================
1918 .SH "See also"
1919 .\" ====================================================================
1920 .
1921 .UR http://\:partners\:.adobe\:.com/\:public/\:developer/\:en/\:ps/\
1922 \:5001\:.DSC_Spec\:.pdf
1923 PostScript Language Document Structuring Conventions Specification
1924 .UE
1925 .
1926 .
1927 .P
1928 .MR afmtodit 1 ,
1929 .MR groff 1 ,
1930 .MR \%troff 1 ,
1931 .MR pfbtops 1 ,
1932 .MR groff_char 7 ,
1933 .MR groff_font 5 ,
1934 .MR groff_out 5 ,
1935 .MR groff_tmac 5
1936 .
1937 .
1938 .\" Clean up.
1939 .rm FT
1940 .
1941 .\" Restore compatibility mode (for, e.g., Solaris 10/11).
1942 .cp \n[*groff_grops_1_man_C]
1943 .do rr *groff_grops_1_man_C
1944 .
1945 .
1946 .\" Local Variables:
1947 .\" fill-column: 72
1948 .\" mode: nroff
1949 .\" End:
1950 .\" vim: set filetype=groff textwidth=72: