Return to download.1 CVS log

Up to [Research Unix] / researchv10no / cmd / post.src / download

Annotation of researchv10no/cmd/post.src/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: \*(mBdownload\f1
        !             7: .OP "" options []
        !             8: .OP "" 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: .OP \-
        !            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: .OP \-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: .OP \-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: .OP \-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 will not be downloaded.
        !            59: The
        !            60: .OP \-p
        !            61: option is for use with Unix 4.0 lp.
        !            62: Other spoolers should use the
        !            63: .OP \-r
        !            64: option.
        !            65: .TP 1.0i
        !            66: .OP \-r file
        !            67: Read the list of printer-resident fonts from
        !            68: .I file.
        !            69: Fonts named in this file will not be downloaded.
        !            70: .TP 1.0i
        !            71: .OP \-H dir
        !            72: Use
        !            73: .I dir
        !            74: as the host font directory.
        !            75: The default is
        !            76: .MR \*(dH .
        !            77: .TP 1.0i
        !            78: .OP \-T dir
        !            79: Use
        !            80: .I dir
        !            81: as the temporary file directory.
        !            82: Only used to make a copy of standard input.
        !            83: By default
        !            84: .I dir
        !            85: is set to
        !            86: .MR /tmp .
        !            87: .PP
        !            88: Requested fonts are named in a
        !            89: .MW %%DocumentFonts:
        !            90: comment in the input
        !            91: .IR files .
        !            92: Available fonts are the ones listed in the map table
        !            93: selected using the
        !            94: .OP \-m
        !            95: option.
        !            96: .PP
        !            97: The map table consists of fontname\-filename pairs.
        !            98: The fontname is the full name of the PostScript font,
        !            99: exactly as it would appear in a
        !           100: .MW %%DocumentFonts:
        !           101: comment.
        !           102: The filename is the pathname of the host resident font.
        !           103: A filename that begins with a
        !           104: .MW /
        !           105: is used as is,
        !           106: otherwise the pathname is relative to the host font
        !           107: directory.
        !           108: Comments are introduced by
        !           109: .MW %
        !           110: (as in PostScript) and
        !           111: extend to the end of the line.
        !           112: .PP
        !           113: The only candidates for downloading are fonts listed
        !           114: in the map table that point
        !           115: .B download
        !           116: to readable files.
        !           117: A font is downloaded at most once per job.
        !           118: Requests for unlisted fonts or inaccessible files
        !           119: are ignored.
        !           120: All requests are ignored if the map table can't be read.
        !           121: .SH EXAMPLES
        !           122: A map table used to control the downloading
        !           123: of the Bookman font family might be,
        !           124: .EX -1
        !           125: %
        !           126: % The first string is the full PostScript font name. The second string
        !           127: % is the file name - relative the host font directory unless it begins
        !           128: % with a /.
        !           129: %
        !           130: 
        !           131:   Bookman-Light            KR
        !           132:   Bookman-LightItalic      KI
        !           133:   Bookman-Demi             KB
        !           134:   Bookman-DemiItalic       KX
        !           135: .EE
        !           136: Use file
        !           137: .MW myprinter
        !           138: (in the default host font directory) as the
        !           139: map table:
        !           140: .EX
        !           141: download -m myprinter \f2file
        !           142: .EE
        !           143: Set the host font directory to
        !           144: .MW /tmp/font
        !           145: and use
        !           146: .MW /tmp/font/xxx
        !           147: as the map table:
        !           148: .EX
        !           149: download -H /tmp/font -mxxx \f2file
        !           150: .EE
        !           151: .SH DIAGNOSTICS
        !           152: 0 exit status is returned if
        !           153: .I files
        !           154: were successfully processed.
        !           155: .SH BUGS
        !           156: .B download
        !           157: should be part of a more general program.
        !           158: .PP
        !           159: .B download
        !           160: does not look for
        !           161: .MW %%PageFonts:
        !           162: comments
        !           163: and there is no way to force multiple downloads of
        !           164: a particular font.
        !           165: .PP
        !           166: Using full pathnames, either in map tables or for the map table
        !           167: name, is not often recommended.
        !           168: .SH SEE ALSO
        !           169: .BR dpost (1),
        !           170: .BR postdaisy (1),
        !           171: .BR postdmd (1),
        !           172: .BR postio (1),
        !           173: .BR postmd (1),
        !           174: .BR postprint (1),
        !           175: .BR posttek (1)

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