Return to download.1 CVS log

Up to [Research Unix] / researchv10no / cmd / postscript / download

Annotation of researchv10no/cmd/postscript/download/download.1, revision 1.1

1.1     ! root        1: .ds dH /usr/lib/font/postscript
        !             2: .TH DOWNLOAD 1 "DWB 3.2"
        !             3: .SH NAME
        !             4: download \- host-resident PostScript font download
        !             5: .SH SYNOPSIS
        !             6: \fBdownload\f1
        !             7: .BI "" options []
        !             8: .BI "" files []
        !             9: .SH DESCRIPTION
        !            10: .B download
        !            11: prepends host-resident fonts to
        !            12: .I files
        !            13: and writes the results on the standard output.
        !            14: If no
        !            15: .I files
        !            16: are specified, or if
        !            17: .BI \-
        !            18: is one of the input
        !            19: .IR files ,
        !            20: the standard input is read.
        !            21: .B download
        !            22: assumes the input
        !            23: .I files
        !            24: are a single PostScript job and that requested fonts
        !            25: can be included at the start of each input
        !            26: .IR file .
        !            27: The following
        !            28: .I options
        !            29: are understood:
        !            30: .TP 1.0i
        !            31: .BI \-f
        !            32: Force a complete scan of each input
        !            33: .I file.
        !            34: In the absence of an explicit comment pointing
        !            35: .I download
        !            36: to the end of the file, the default scan stops
        !            37: immediately after the PostScript header comments.
        !            38: .TP 1.0i
        !            39: .BI \-m name
        !            40: Use
        !            41: .I name
        !            42: as the font map table.
        !            43: A
        !            44: .I name
        !            45: that begins with
        !            46: .MW /
        !            47: is the full pathname of the
        !            48: map table.
        !            49: Otherwise
        !            50: .I name
        !            51: is relative to the host font directory.
        !            52: .TP 1.0i
        !            53: .BI \-p printer
        !            54: Read the printer-resident font list from file
        !            55: .br
        !            56: .MI /etc/lp/printers/ printer /residentfonts \f1.
        !            57: .br
        !            58: Fonts named in this file are printer-resident and
        !            59: will not be downloaded.
        !            60: .TP 1.0i
        !            61: .BI \-H dir
        !            62: Use
        !            63: .I dir
        !            64: as the host font directory.
        !            65: The default is
        !            66: .MR \*(dH .
        !            67: .TP 1.0i
        !            68: .BI \-T dir
        !            69: Use
        !            70: .I dir
        !            71: as the temporary file directory.
        !            72: Only used to make a copy of standard input.
        !            73: By default
        !            74: .I dir
        !            75: is set to
        !            76: .MR /tmp .
        !            77: .PP
        !            78: Requested fonts are named in a
        !            79: .MW %%DocumentFonts:
        !            80: comment in the input
        !            81: .IR files .
        !            82: Available fonts are the ones listed in the map table
        !            83: selected using the
        !            84: .BI \-m
        !            85: option.
        !            86: .PP
        !            87: The map table consists of fontname\-filename pairs.
        !            88: The fontname is the full name of the PostScript font,
        !            89: exactly as it would appear in a
        !            90: .MW %%DocumentFonts:
        !            91: comment.
        !            92: The filename is the pathname of the host resident font.
        !            93: A filename that begins with a
        !            94: .MW /
        !            95: is used as is,
        !            96: otherwise the pathname is relative to the host font
        !            97: directory.
        !            98: Comments are introduced by
        !            99: .MW %
        !           100: (as in PostScript) and
        !           101: extend to the end of the line.
        !           102: .PP
        !           103: The only candidates for downloading are fonts listed
        !           104: in the map table that point
        !           105: .B download
        !           106: to readable files.
        !           107: A font is downloaded at most once.
        !           108: Requests for unlisted fonts or inaccessible files
        !           109: are ignored.
        !           110: All requests are ignored if the map table can't be read.
        !           111: .SH EXAMPLES
        !           112: A map table used to control the downloading
        !           113: of the Bookman font family might be,
        !           114: .EX -1
        !           115: %
        !           116: % The first string is the full PostScript font name. The second string
        !           117: % is the file name - relative the host font directory unless it begins
        !           118: % with a /.
        !           119: %
        !           120: 
        !           121:   Bookman-Light            KR
        !           122:   Bookman-LightItalic      KI
        !           123:   Bookman-Demi             KB
        !           124:   Bookman-DemiItalic       KX
        !           125: .EE
        !           126: Use file
        !           127: .MW myprinter
        !           128: (in the default host font directory) as the
        !           129: map table:
        !           130: .EX
        !           131: download -m myprinter \f2file
        !           132: .EE
        !           133: Set the host font directory to
        !           134: .MW /tmp/font
        !           135: and use
        !           136: .MW /tmp/font/xxx
        !           137: as the map table:
        !           138: .EX
        !           139: download -H /tmp/font -mxxx \f2file
        !           140: .EE
        !           141: .SH DIAGNOSTICS
        !           142: 0 exit status is returned if
        !           143: .I files
        !           144: were successfully processed.
        !           145: .SH BUGS
        !           146: .B download
        !           147: should be part of a more general program.
        !           148: .PP
        !           149: .B download
        !           150: does not look for
        !           151: .MW %%PageFonts:
        !           152: comments
        !           153: and there is no way to force multiple downloads of
        !           154: a particular font.
        !           155: .PP
        !           156: Using full pathnames, either in map tables or for the map table
        !           157: name, is not often recommended.
        !           158: .SH SEE ALSO
        !           159: .BR dpost (1),
        !           160: .BR postdaisy (1),
        !           161: .BR postdmd (1),
        !           162: .BR postio (1),
        !           163: .BR postmd (1),
        !           164: .BR postprint (1),
        !           165: .BR posttek (1)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.