contrib/groff/src/devices/grops/grops.man

   1 .ig
   2 Copyright (C) 1989-2000, 2001, 2002 Free Software Foundation, Inc.
   3
   4 Permission is granted to make and distribute verbatim copies of
   5 this manual provided the copyright notice and this permission notice
   6 are preserved on all copies.
   7
   8 Permission is granted to copy and distribute modified versions of this
   9 manual under the conditions for verbatim copying, provided that the
  10 entire resulting derived work is distributed under the terms of a
  11 permission notice identical to this one.
  12
  13 Permission is granted to copy and distribute translations of this
  14 manual into another language, under the above conditions for modified
  15 versions, except that this permission notice may be included in
  16 translations approved by the Free Software Foundation instead of in
  17 the original English.
  18 ..
  19 .
  20 .mso www.tmac
  21 .
  22 .
  23 .\" Like TP, but if specified indent is more than half
  24 .\" the current line-length - indent, use the default indent.
  25 .de Tp
  26 .ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
  27 .el .TP "\\$1"
  28 ..
  29 .
  30 .
  31 .TH GROPS @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
  32 .
  33 .
  34 .SH NAME
  35 grops \- PostScript driver for groff
  36 .
  37 .
  38 .SH SYNOPSIS
  39 .nr a \n(.j
  40 .ad l
  41 .nr i \n(.i
  42 .in +\w'\fBgrops 'u
  43 .ti \niu
  44 .B grops
  45 .
  46 .de OP
  47 .ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\%\\$2" "\ ]"
  48 .el .RB "[\ " "\\$1" "\ ]"
  49 ..
  50 .
  51 .OP \-glmv
  52 .OP \-b n
  53 .OP \-c n
  54 .OP \-F dir
  55 .OP \-p papersize
  56 .OP \-P prologue
  57 .OP \-w n
  58 .RI "[\ " files\|.\|.\|. "\ ]"
  59 .br
  60 .ad \na
  61 .
  62 .PP
  63 It is possible to have whitespace between a command line option and its
  64 parameter.
  65 .
  66 .
  67 .SH DESCRIPTION
  68 .B grops
  69 translates the output of GNU
  70 .B troff
  71 to PostScript.
  72 .
  73 Normally
  74 .B grops
  75 should be invoked by using the groff command
  76 with a
  77 .B \-Tps
  78 option.
  79 .
  80 .if '@DEVICE@'ps' (Actually, this is the default for groff.)
  81 .
  82 If no files are given,
  83 .B grops
  84 will read the standard input.
  85 .
  86 A filename of
  87 .B \-
  88 will also cause
  89 .B grops
  90 to read the standard input.
  91 .
  92 PostScript output is written to the standard output.
  93 .
  94 When
  95 .B grops
  96 is run by
  97 .B groff
  98 options can be passed to
  99 .B grops
 100 using the
 101 .B groff
 102 .B \-P
 103 option.
 104 .
 105 .
 106 .SH OPTIONS
 107 .TP
 108 .BI \-b n
 109 Workaround broken spoolers and previewers.
 110 .
 111 Normally
 112 .B grops
 113 produces output that conforms
 114 the Document Structuring Conventions version 3.0.
 115 .
 116 Unfortunately some spoolers and previewers can't handle such output.
 117 .
 118 The value of\~\c
 119 .I n
 120 controls what
 121 .B grops
 122 does to its output acceptable to such programs.
 123 .
 124 A value of\~0 will cause grops not to employ any workarounds.
 125 .
 126 Add\~1 if no
 127 .B %%BeginDocumentSetup
 128 and
 129 .B %%EndDocumentSetup
 130 comments should be generated;
 131 this is needed for early versions of TranScript that get confused by
 132 anything between the
 133 .B %%EndProlog
 134 comment and the first
 135 .B %%Page
 136 comment.
 137 .
 138 Add\~2 if lines in included files beginning with
 139 .B %!
 140 should be stripped out; this is needed for Sun's pageview previewer.
 141 .
 142 Add\~4 if
 143 .BR %%Page ,
 144 .BR %%Trailer
 145 and
 146 .B %%EndProlog
 147 comments should be
 148 stripped out of included files; this is needed for spoolers that
 149 don't understand the
 150 .B %%BeginDocument
 151 and
 152 .B %%EndDocument
 153 comments.
 154 .
 155 Add\~8 if the first line of the PostScript output should be
 156 .B %!PS-Adobe-2.0
 157 rather than
 158 .BR %!PS-Adobe-3.0 ;
 159 this is needed when using Sun's Newsprint with a printer that requires
 160 page reversal.
 161 .
 162 The default value can be specified by a
 163 .
 164 .RS
 165 .IP
 166 .BI broken\  n
 167 .
 168 .LP
 169 command in the DESC file.
 170 .
 171 Otherwise the default value is\~0.
 172 .RE
 173 .
 174 .TP
 175 .BI \-c n
 176 Print
 177 .I n
 178 copies of each page.
 179 .
 180 .TP
 181 .BI \-F dir
 182 Prepend directory
 183 .IB dir /dev name
 184 to the search path for prologue, font, and device description files;
 185 .I name
 186 is the name of the device, usually
 187 .BR ps .
 188 .
 189 .TP
 190 .BI \-g
 191 Guess the page length.
 192 .
 193 This generates PostScript code that guesses the page length.
 194 .
 195 The guess will be correct only if the imageable area is vertically
 196 centered on the page.
 197 .
 198 This option allows you to generate documents that can be printed
 199 both on letter (8.5\(mu11) paper and on A4 paper without change.
 200 .
 201 .TP
 202 .B \-l
 203 Print the document in landscape format.
 204 .
 205 .TP
 206 .B \-m
 207 Turn manual feed on for the document.
 208 .
 209 .TP
 210 .BI \-p paper-size
 211 Set physical dimension of output medium.
 212 .
 213 This overrides the
 214 .B papersize
 215 and
 216 .B paperlength
 217 commands in the
 218 .B DESC
 219 file; it accepts the same arguments as the
 220 .B papersize
 221 command.
 222 .
 223 .TP
 224 .BI \-P prologue-file
 225 Use the file
 226 .I prologue-file
 227 (in the font path) as the prologue instead of the default prologue file
 228 .BR prologue .
 229 .
 230 This option overrides the environment variable
 231 .SM GROPS_PROLOGUE.
 232 .
 233 .TP
 234 .BI \-w n
 235 Lines should be drawn using a thickness of
 236 .IR n \~\c
 237 thousandths of an em.
 238 If this option is not given, the line thickness defaults to 0.04\~em.
 239 .
 240 .TP
 241 .B \-v
 242 Print the version number.
 243 .
 244 .
 245 .SH USAGE
 246 There are styles called
 247 .BR R ,
 248 .BR I ,
 249 .BR B ,
 250 and
 251 .B BI
 252 mounted at font positions 1 to\~4.
 253 .
 254 The fonts are grouped into families
 255 .BR A ,
 256 .BR BM ,
 257 .BR C ,
 258 .BR H ,
 259 .BR HN ,
 260 .BR N ,
 261 .B P
 262 and\~\c
 263 .B T
 264 having members in each of these styles:
 265 .
 266 .de FT
 267 .if '\\*(.T'ps' .ft \\$1
 268 ..
 269 .
 270 .RS
 271 .TP
 272 .B AR
 273 .FT AR
 274 AvantGarde-Book
 275 .FT
 276 .
 277 .TP
 278 .B AI
 279 .FT AI
 280 AvantGarde-BookOblique
 281 .FT
 282 .
 283 .TP
 284 .B AB
 285 .FT AB
 286 AvantGarde-Demi
 287 .FT
 288 .
 289 .TP
 290 .B ABI
 291 .FT ABI
 292 AvantGarde-DemiOblique
 293 .FT
 294 .
 295 .TP
 296 .B BMR
 297 .FT BMR
 298 Bookman-Light
 299 .FT
 300 .
 301 .TP
 302 .B BMI
 303 .FT BMI
 304 Bookman-LightItalic
 305 .FT
 306 .
 307 .TP
 308 .B BMB
 309 .FT BMB
 310 Bookman-Demi
 311 .FT
 312 .
 313 .TP
 314 .B BMBI
 315 .FT BMBI
 316 Bookman-DemiItalic
 317 .FT
 318 .
 319 .TP
 320 .B CR
 321 .FT CR
 322 Courier
 323 .FT
 324 .
 325 .TP
 326 .B CI
 327 .FT CI
 328 Courier-Oblique
 329 .FT
 330 .
 331 .TP
 332 .B CB
 333 .FT CB
 334 Courier-Bold
 335 .FT
 336 .
 337 .TP
 338 .B CBI
 339 .FT CBI
 340 Courier-BoldOblique
 341 .FT
 342 .
 343 .TP
 344 .B HR
 345 .FT HR
 346 Helvetica
 347 .FT
 348 .
 349 .TP
 350 .B HI
 351 .FT HI
 352 Helvetica-Oblique
 353 .FT
 354 .
 355 .TP
 356 .B HB
 357 .FT HB
 358 Helvetica-Bold
 359 .FT
 360 .
 361 .TP
 362 .B HBI
 363 .FT HBI
 364 Helvetica-BoldOblique
 365 .FT
 366 .
 367 .TP
 368 .B HNR
 369 .FT HNR
 370 Helvetica-Narrow
 371 .FT
 372 .
 373 .TP
 374 .B HNI
 375 .FT HNI
 376 Helvetica-Narrow-Oblique
 377 .FT
 378 .
 379 .TP
 380 .B HNB
 381 .FT HNB
 382 Helvetica-Narrow-Bold
 383 .FT
 384 .
 385 .TP
 386 .B HNBI
 387 .FT HNBI
 388 Helvetica-Narrow-BoldOblique
 389 .FT
 390 .
 391 .TP
 392 .B NR
 393 .FT NR
 394 NewCenturySchlbk-Roman
 395 .FT
 396 .
 397 .TP
 398 .B NI
 399 .FT NI
 400 NewCenturySchlbk-Italic
 401 .FT
 402 .
 403 .TP
 404 .B NB
 405 .FT NB
 406 NewCenturySchlbk-Bold
 407 .FT
 408 .
 409 .TP
 410 .B NBI
 411 .FT NBI
 412 NewCenturySchlbk-BoldItalic
 413 .FT
 414 .
 415 .TP
 416 .B PR
 417 .FT PR
 418 Palatino-Roman
 419 .FT
 420 .
 421 .TP
 422 .B PI
 423 .FT PI
 424 Palatino-Italic
 425 .FT
 426 .
 427 .TP
 428 .B PB
 429 .FT PB
 430 Palatino-Bold
 431 .FT
 432 .
 433 .TP
 434 .B PBI
 435 .FT PBI
 436 Palatino-BoldItalic
 437 .FT
 438 .
 439 .TP
 440 .B TR
 441 .FT TR
 442 Times-Roman
 443 .FT
 444 .
 445 .TP
 446 .B TI
 447 .FT TI
 448 Times-Italic
 449 .FT
 450 .
 451 .TP
 452 .B TB
 453 .FT TB
 454 Times-Bold
 455 .FT
 456 .
 457 .TP
 458 .B TBI
 459 .FT TBI
 460 Times-BoldItalic
 461 .FT
 462 .RE
 463 .
 464 .LP
 465 There is also the following font which is not a member of a family:
 466 .
 467 .RS
 468 .TP
 469 .B ZCMI
 470 .FT ZCMI
 471 ZapfChancery-MediumItalic
 472 .FT
 473 .RE
 474 .
 475 .LP
 476 There are also some special fonts called
 477 .B SS
 478 and\~\c
 479 .BR S .
 480 .
 481 Zapf Dingbats is available as
 482 .BR ZD
 483 and a reversed version of ZapfDingbats (with symbols pointing in the opposite
 484 direction) is available as
 485 .BR ZDR ;
 486 most characters in these fonts are unnamed and must be accessed using
 487 .BR \[rs]N .
 488 .
 489 .LP
 490 The default color for
 491 .B \[rs]m
 492 and
 493 .B \[rs]M
 494 is black; for colors defined in the `rgb' color space,
 495 .B setrgbcolor
 496 is used, for `cmy' and `cmyk'
 497 .BR setcmykcolor ,
 498 and for `gray'
 499 .BR setgray .
 500 .
 501 .LP
 502 .B grops
 503 understands various X\~commands produced using the
 504 .B \[rs]X
 505 escape sequence;
 506 .B grops
 507 will only interpret commands that begin with a
 508 .B ps:
 509 tag.
 510 .
 511 .TP
 512 .BI \[rs]X'ps:\ exec\  code '
 513 This executes the arbitrary PostScript commands in
 514 .IR code .
 515 .
 516 The PostScript currentpoint will be set to the position of the
 517 .B \[rs]X
 518 command before executing
 519 .IR code .
 520 .
 521 The origin will be at the top left corner of the page,
 522 and y\~coordinates will increase down the page.
 523 .
 524 A procedure\~\c
 525 .B u
 526 will be defined that converts groff units
 527 to the coordinate system in effect.
 528 .
 529 For example,
 530 .
 531 .RS
 532 .IP
 533 .B
 534 \&.nr x 1i
 535 .br
 536 .B
 537 \[rs]X'ps: exec \[rs]nx u 0 rlineto stroke'
 538 .br
 539 .RE
 540 .
 541 .IP
 542 will draw a horizontal line one inch long.
 543 .
 544 .I code
 545 may make changes to the graphics state,
 546 but any changes will persist only to the
 547 end of the page.
 548 .
 549 A dictionary containing the definitions specified by the
 550 .B def
 551 and
 552 .B mdef
 553 will be on top of the dictionary stack.
 554 .
 555 If your code adds definitions to this dictionary,
 556 you should allocate space for them using
 557 .BI \[rs]X'ps\ mdef \ n '\fR.
 558 .
 559 Any definitions will persist only until the end of the page.
 560 .
 561 If you use the
 562 .B \[rs]Y
 563 escape sequence with an argument that names a macro,
 564 .I code
 565 can extend over multiple lines.
 566 .
 567 For example,
 568 .
 569 .RS
 570 .IP
 571 .nf
 572 .ft B
 573 \&.nr x 1i
 574 \&.de y
 575 \&ps: exec
 576 \&\[rs]nx u 0 rlineto
 577 \&stroke
 578 \&..
 579 \&\[rs]Yy
 580 .fi
 581 .ft R
 582 .
 583 .LP
 584 is another way to draw a horizontal line one inch long.
 585 .RE
 586 .
 587 .TP
 588 .BI \[rs]X'ps:\ file\  name '
 589 This is the same as the
 590 .B exec
 591 command except that the PostScript code is read from file
 592 .IR name .
 593 .
 594 .TP
 595 .BI \[rs]X'ps:\ def\  code '
 596 Place a PostScript definition contained in
 597 .I code
 598 in the prologue.
 599 .
 600 There should be at most one definition per
 601 .B \[rs]X
 602 command.
 603 .
 604 Long definitions can be split over several
 605 .B \[rs]X
 606 commands;
 607 all the
 608 .I code
 609 arguments are simply joined together separated by newlines.
 610 .
 611 The definitions are placed in a dictionary which is automatically
 612 pushed on the dictionary stack when an
 613 .B exec
 614 command is executed.
 615 .
 616 If you use the
 617 .B \[rs]Y
 618 escape sequence with an argument that names a macro,
 619 .I code
 620 can extend over multiple lines.
 621 .
 622 .TP
 623 .BI \[rs]X'ps:\ mdef\  n\ code  '
 624 Like
 625 .BR def ,
 626 except that
 627 .I code
 628 may contain up to
 629 .IR n \~\c
 630 definitions.
 631 .
 632 .B grops
 633 needs to know how many definitions
 634 .I code
 635 contains
 636 so that it can create an appropriately sized PostScript dictionary
 637 to contain them.
 638 .
 639 .TP
 640 .BI \[rs]X'ps:\ import\  file\ llx\ lly\ urx\ ury\ width\ \fR[\fP\ height\ \fR]\fP '
 641 Import a PostScript graphic from
 642 .IR file .
 643 .
 644 The arguments
 645 .IR llx ,
 646 .IR lly ,
 647 .IR urx ,
 648 and
 649 .I ury
 650 give the bounding box of the graphic in the default PostScript
 651 coordinate system; they should all be integers;
 652 .I llx
 653 and
 654 .I lly
 655 are the x and y\~coordinates of the lower left
 656 corner of the graphic;
 657 .I urx
 658 and
 659 .I ury
 660 are the x and y\~coordinates of the upper right corner of the graphic;
 661 .I width
 662 and
 663 .I height
 664 are integers that give the desired width and height in groff
 665 units of the graphic.
 666 .
 667 The graphic will be scaled so that it has this width and height
 668 and translated so that the lower left corner of the graphic is
 669 located at the position associated with
 670 .B \[rs]X
 671 command.
 672 .
 673 If the height argument is omitted it will be scaled uniformly in the
 674 x and y\~directions so that it has the specified width.
 675 .
 676 Note that the contents of the
 677 .B \[rs]X
 678 command are not interpreted by
 679 .BR troff ;
 680 so vertical space for the graphic is not automatically added,
 681 and the
 682 .I width
 683 and
 684 .I height
 685 arguments are not allowed to have attached scaling indicators.
 686 .
 687 If the PostScript file complies with the Adobe Document Structuring
 688 Conventions and contains a
 689 .B %%BoundingBox
 690 comment, then the bounding box can be automatically
 691 extracted from within groff by using the
 692 .B psbb
 693 request.
 694 .
 695 .RS
 696 .LP
 697 The
 698 .B \-mps
 699 macros (which are automatically loaded when
 700 .B grops
 701 is run by the groff command) include a
 702 .B PSPIC
 703 macro which allows a picture to be easily imported.
 704 .
 705 This has the format
 706 .IP
 707 \&\fB.PSPIC\fP [\fB\-L\fP|\fB-R\fP|\fB\-I\fP \fIn\fP]\ \fI\|file\fP [\fIwidth\fP [\fIheight\fP]]
 708 .
 709 .LP
 710 .I file
 711 is the name of the file containing the illustration;
 712 .I width
 713 and
 714 .I height
 715 give the desired width and height of the graphic.
 716 .
 717 The
 718 .I width
 719 and
 720 .I height
 721 arguments may have scaling indicators attached;
 722 the default scaling indicator is\~\c
 723 .BR i .
 724 .
 725 This macro will scale the graphic uniformly
 726 in the x and y\~directions so that it is no more than
 727 .I width
 728 wide
 729 and
 730 .I height
 731 high.
 732 .
 733 By default, the graphic will be horizontally centered.
 734 .
 735 The
 736 .BI \-L
 737 and
 738 .BI \-R
 739 cause the graphic to be left-aligned and right-aligned
 740 respectively.
 741 .
 742 The
 743 .B \-I
 744 option causes the graphic to be indented by\~\c
 745 .IR n .
 746 .RE
 747 .
 748 .TP
 749 .B \[rs]X'ps:\ invis'
 750 .br
 751 .ns
 752 .TP
 753 .B \[rs]X'ps:\ endinvis'
 754 No output will be generated for text and drawing commands
 755 that are bracketed with these
 756 .B \[rs]X
 757 commands.
 758 .
 759 These commands are intended for use when output from
 760 .B troff
 761 will be previewed before being processed with
 762 .BR grops ;
 763 if the previewer is unable to display certain characters
 764 or other constructs, then other substitute characters or constructs
 765 can be used for previewing by bracketing them with these
 766 .B \[rs]X
 767 commands.
 768 .
 769 .RS
 770 .LP
 771 For example,
 772 .B gxditview
 773 is not able to display a proper
 774 .B \[rs](em
 775 character because the standard X11 fonts do not provide it;
 776 this problem can be overcome by executing the following
 777 request
 778 .
 779 .IP
 780 .ft B
 781 .nf
 782 \&.char \[rs](em \[rs]X'ps: invis'\[rs]
 783 \[rs]Z'\[rs]v'-.25m'\[rs]h'.05m'\[rs]D'l .9m 0'\[rs]h'.05m''\[rs]
 784 \[rs]X'ps: endinvis'\[rs](em
 785 .ft
 786 .fi
 787 .
 788 .LP
 789 In this case,
 790 .B gxditview
 791 will be unable to display the
 792 .B \[rs](em
 793 character and will draw the line,
 794 whereas
 795 .B grops
 796 will print the
 797 .B \[rs](em
 798 character
 799 and ignore the line.
 800 .RE
 801 .
 802 .LP
 803 The input to
 804 .B grops
 805 must be in the format output by
 806 .BR @g@troff (@MAN1EXT@).
 807 .
 808 This is described in
 809 .BR groff_out (@MAN5EXT@).
 810 .
 811 In addition the device and font description files for the device used
 812 must meet certain requirements.
 813 .
 814 The device and font description files supplied for
 815 .B ps
 816 device meet all these requirements.
 817 .
 818 .BR afmtodit (@MAN1EXT@)
 819 can be used to create font files from AFM files.
 820 .
 821 The resolution must be an integer multiple of\~72 times the
 822 .BR sizescale .
 823 .
 824 The
 825 .B ps
 826 device uses a resolution of 72000 and a sizescale of 1000.
 827 .
 828 The device description file should contain a command
 829 .IP
 830 .BI paperlength\  n
 831 .LP
 832 which says that output should be generated which is suitable for
 833 printing on a page whose length is
 834 .IR n \~\c
 835 machine units.
 836 .
 837 Common values are 792000 for letter paper and 841890 for paper in A4 format.
 838 .
 839 Alternatively, it can contain
 840 .IP
 841 .BI papersize\  string
 842 .LP
 843 to specify a paper size; see
 844 .BR groff_font (@MAN5EXT@)
 845 for more information.
 846 .
 847 Each font description file must contain a command
 848 .IP
 849 .BI internalname\  psname
 850 .LP
 851 which says that the PostScript name of the font is
 852 .IR psname .
 853 .
 854 It may also contain a command
 855 .IP
 856 .BI encoding\  enc_file
 857 .LP
 858 which says that
 859 the PostScript font should be reencoded using the encoding described in
 860 .IR enc_file ;
 861 this file should consist of a sequence of lines of the form:
 862 .IP
 863 .I
 864 pschar code
 865 .LP
 866 where
 867 .I pschar
 868 is the PostScript name of the character,
 869 and
 870 .I code
 871 is its position in the encoding expressed as a decimal integer.
 872 .
 873 Lines starting with
 874 .B #
 875 and blank lines are ignored.
 876 .
 877 The code for each character given in the font file must correspond
 878 to the code for the character in encoding file, or to the code in the default
 879 encoding for the font if the PostScript font is not to be reencoded.
 880 .
 881 This code can be used with the
 882 .B \[rs]N
 883 escape sequence in
 884 .B troff
 885 to select the character,
 886 even if the character does not have a groff name.
 887 .
 888 Every character in the font file must exist in the PostScript font, and
 889 the widths given in the font file must match the widths used
 890 in the PostScript font.
 891 .
 892 .B grops
 893 will assume that a character with a groff name of
 894 .B space
 895 is blank (makes no marks on the page);
 896 it can make use of such a character to generate more efficient and
 897 compact PostScript output.
 898 .
 899 .LP
 900 .B grops
 901 can automatically include the downloadable fonts necessary
 902 to print the document.
 903 .
 904 Any downloadable fonts which should, when required, be included by
 905 .B grops
 906 must be listed in the file
 907 .BR @FONTDIR@/devps/download ;
 908 this should consist of lines of the form
 909 .
 910 .IP
 911 .I
 912 font filename
 913 .
 914 .LP
 915 where
 916 .I font
 917 is the PostScript name of the font,
 918 and
 919 .I filename
 920 is the name of the file containing the font;
 921 lines beginning with
 922 .B #
 923 and blank lines are ignored;
 924 fields may be separated by tabs or spaces;
 925 .I filename
 926 will be searched for using the same mechanism that is used
 927 for groff font metric files.
 928 .
 929 The
 930 .B download
 931 file itself will also be searched for using this mechanism;
 932 currently, only the first found file in the font path is used.
 933 .
 934 .LP
 935 If the file containing a downloadable font or imported document
 936 conforms to the Adobe Document Structuring Conventions,
 937 then
 938 .B grops
 939 will interpret any comments in the files sufficiently to ensure that its
 940 own output is conforming.
 941 .
 942 It will also supply any needed font resources that are listed in the
 943 .B download
 944 file
 945 as well as any needed file resources.
 946 .
 947 It is also able to handle inter-resource dependencies.
 948 .
 949 For example, suppose that you have a downloadable font called Garamond,
 950 and also a downloadable font called Garamond-Outline
 951 which depends on Garamond
 952 (typically it would be defined to copy Garamond's font dictionary,
 953 and change the PaintType),
 954 then it is necessary for Garamond to be appear before Garamond-Outline
 955 in the PostScript document.
 956 .
 957 .B grops
 958 will handle this automatically
 959 provided that the downloadable font file for Garamond-Outline
 960 indicates its dependence on Garamond by means of
 961 the Document Structuring Conventions,
 962 for example by beginning with the following lines
 963 .
 964 .IP
 965 .B
 966 %!PS-Adobe-3.0 Resource-Font
 967 .br
 968 .B
 969 %%DocumentNeededResources: font Garamond
 970 .br
 971 .B
 972 %%EndComments
 973 .br
 974 .B
 975 %%IncludeResource: font Garamond
 976 .
 977 .LP
 978 In this case both Garamond and Garamond-Outline would need to be listed
 979 in the
 980 .B download
 981 file.
 982 .
 983 A downloadable font should not include its own name in a
 984 .B %%DocumentSuppliedResources
 985 comment.
 986 .
 987 .LP
 988 .B grops
 989 will not interpret
 990 .B %%DocumentFonts
 991 comments.
 992 .
 993 The
 994 .BR %%DocumentNeededResources ,
 995 .BR %%DocumentSuppliedResources ,
 996 .BR %%IncludeResource ,
 997 .BR %%BeginResource
 998 and
 999 .BR %%EndResource
1000 comments
1001 (or possibly the old
1002 .BR %%DocumentNeededFonts ,
1003 .BR %%DocumentSuppliedFonts ,
1004 .BR %%IncludeFont ,
1005 .BR %%BeginFont
1006 and
1007 .BR %%EndFont
1008 comments)
1009 should be used.
1010 .
1011 .
1012 .SS TrueType fonts
1013 TrueType fonts can be used with
1014 .B grops
1015 if converted first to
1016 .B "Type 42"
1017 format, an especial PostScript wrapper equivalent to the
1018 PFA format mentioned in
1019 .BR pfbtops (@MAN1EXT@).
1020 There are several different methods to generate a type42
1021 wrapper and most of them involve the use of a PostScript
1022 interpreter such as Ghostscript \(em see
1023 .BR gs (1).
1024 Yet, the easiest method involves the use of the application
1025 .BR ttftot42 .
1026 This program uses
1027 .BR freetype (3)
1028 (version 1.3.1) to generate type42
1029 font wrappers and well-formed AFM files that can be fed to
1030 the
1031 .BR afmtodit (@MAN1EXT@)
1032 script to create appropriate metric files.
1033 The resulting font wrappers should be added to the
1034 .B download
1035 file.
1036 .B ttftot42
1037 source code can be downloaded from
1038 .URL ftp://\:www.giga.or.at/\:pub/\:nih/\:ttftot42/ \
1039      ftp://\:www.giga.or.at/\:pub/\:nih/\:ttftot42/ .
1040 .
1041 .
1042 .SH ENVIRONMENT
1043 .TP
1044 .SM
1045 .B GROPS_PROLOGUE
1046 If this is set to
1047 .IR foo ,
1048 then
1049 .B grops
1050 will use the file
1051 .I foo
1052 (in the font path) instead of the default prologue file
1053 .BR prologue .
1054 .
1055 The option
1056 .B \-P
1057 overrides this environment variable.
1058 .
1059 .
1060 .SH FILES
1061 .Tp \w'\fB@FONTDIR@/devps/download'u+2n
1062 .B @FONTDIR@/devps/DESC
1063 Device description file.
1064 .
1065 .TP
1066 .BI @FONTDIR@/devps/ F
1067 Font description file for font
1068 .IR F .
1069 .
1070 .TP
1071 .B @FONTDIR@/devps/download
1072 List of downloadable fonts.
1073 .
1074 .TP
1075 .B @FONTDIR@/devps/text.enc
1076 Encoding used for text fonts.
1077 .
1078 .TP
1079 .B @MACRODIR@/ps.tmac
1080 Macros for use with
1081 .BR grops ;
1082 automatically loaded by
1083 .BR troffrc
1084 .
1085 .TP
1086 .B @MACRODIR@/pspic.tmac
1087 Definition of
1088 .B PSPIC
1089 macro,
1090 automatically loaded by
1091 .BR ps.tmac .
1092 .
1093 .TP
1094 .B @MACRODIR@/psold.tmac
1095 Macros to disable use of characters not present in older
1096 PostScript printers (e.g. `eth' or `thorn').
1097 .
1098 .TP
1099 .BI /tmp/grops XXXXXX
1100 Temporary file.
1101 .
1102 .
1103 .SH "SEE ALSO"
1104 .BR afmtodit (@MAN1EXT@),
1105 .BR groff (@MAN1EXT@),
1106 .BR @g@troff (@MAN1EXT@),
1107 .BR psbb (@MAN1EXT@),
1108 .BR groff_out (@MAN5EXT@),
1109 .BR groff_font (@MAN5EXT@),
1110 .BR groff_char (@MAN7EXT@)
1111 .
1112 .\" Local Variables:
1113 .\" mode: nroff
1114 .\" End: