Return to mpictures.6 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man6

Annotation of researchv10dc/man/adm/man6/mpictures.6, revision 1.1

1.1     ! root        1: .TH MPICTURES 6
        !             2: .CT 1 writing_troff
        !             3: .SH NAME
        !             4: mpictures \- picture inclusion macros
        !             5: .SH SYNOPSIS
        !             6: .B troff -mpictures
        !             7: [
        !             8: .I options
        !             9: ]
        !            10: .I file ...
        !            11: .SH DESCRIPTION
        !            12: .I Mpictures
        !            13: macros insert PostScript pictures into
        !            14: .IR troff (1)
        !            15: documents.
        !            16: The macros are:
        !            17: .TP
        !            18: .BI .BP " source height width position offset flags label
        !            19: Define a frame and place a picture in it.
        !            20: Null arguments, represented by \f5""\fR,
        !            21: are interpreted as defaults.
        !            22: The arguments are:
        !            23: .RS
        !            24: .TP
        !            25: .I source
        !            26: Name of a PostScript picture file, optionally
        !            27: suffixed with
        !            28: .RI ( n )
        !            29: to select page number
        !            30: .I n
        !            31: from the file (first page by default).
        !            32: .PD0
        !            33: .TP
        !            34: .I height
        !            35: Vertical size of the frame, default
        !            36: .BR 3.0i .
        !            37: .TP
        !            38: .I width
        !            39: Horizontal size of the frame, current line length by default.
        !            40: .TP
        !            41: .I position
        !            42: .L l
        !            43: (default),
        !            44: .LR c ,
        !            45: or
        !            46: .L r
        !            47: to left-justify, center, or right-justify the frame.
        !            48: .TP
        !            49: .I offset
        !            50: Move the frame horizontally from the original
        !            51: .I position
        !            52: by this amount, default
        !            53: .BR 0i .
        !            54: .TP
        !            55: .I flags
        !            56: One or more of:
        !            57: .RS
        !            58: .PD 0v
        !            59: .TP
        !            60: .BI a d 
        !            61: Rotate the picture clockwise
        !            62: .I d
        !            63: degrees, default 
        !            64: .IR d =90.
        !            65: .TP
        !            66: .B o
        !            67: Outline the picture with a box.
        !            68: .TP
        !            69: .B s
        !            70: Freely scale both picture dimensions.
        !            71: .TP
        !            72: .B w
        !            73: White out the area to be occupied by the picture.
        !            74: .TP
        !            75: .BR l , r , t ,\fPb
        !            76: Attach the picture to the left right, top, or bottom of the frame.
        !            77: .RE
        !            78: .TP
        !            79: .I label
        !            80: Place
        !            81: .I label
        !            82: at distance
        !            83: .B 1.5v
        !            84: below the frame.
        !            85: .PD
        !            86: .PP
        !            87: If there's room,
        !            88: .B .BP
        !            89: fills text around the frame.
        !            90: Everything destined for either side of the frame
        !            91: goes into a diversion to be retrieved when the accumulated
        !            92: text sweeps past the trap set by 
        !            93: .B .BP
        !            94: or when the diversion is explicitly closed
        !            95: by 
        !            96: .BR .EP .
        !            97: .RE
        !            98: .TP
        !            99: .BI .PI " source height" , width , "yoffset\fB,\fPxoffset flags.
        !           100: This low-level macro, used by
        !           101: .BR .BP ,
        !           102: can help do more complex things.
        !           103: The two arguments not already described are:
        !           104: .RS
        !           105: .TP
        !           106: .I xoffset
        !           107: Offset the frame from the left margin by this amount, default
        !           108: .BR 0i .
        !           109: .PD0
        !           110: .TP
        !           111: .I yoffset
        !           112: Offset the frame from the current baseline,
        !           113: measuring positive downward, default
        !           114: .BR 0i .
        !           115: .PD
        !           116: .RE
        !           117: .TP
        !           118: .B .EP
        !           119: End a picture started by
        !           120: .BR .BP ;
        !           121: .B .EP
        !           122: is usually called implicitly by a trap
        !           123: at frame bottom.
        !           124: .PP
        !           125: If a PostScript file lacks page-delimiting comments,
        !           126: the entire file is included.
        !           127: If no
        !           128: .B %%BoundingBox
        !           129: comment is present, the picture is
        !           130: assumed to fill an 8.5\(mu11-inch page.
        !           131: Nothing prevents the picture from being placed off the page.
        !           132: .SH FILES
        !           133: .F /usr/lib/tmac/tmac.pictures
        !           134: .SH SEE ALSO
        !           135: .IR troff (1)
        !           136: .SH DIAGNOSTICS
        !           137: A picture file that can't be read by the PostScript
        !           138: postprocessor is replaced by white space.
        !           139: .SH BUGS
        !           140: A picture and associated text silently disappear if
        !           141: a diversion trap set by
        !           142: .B .BP
        !           143: isn't reached.
        !           144: Call
        !           145: .B .EP
        !           146: at the end of the document to retrieve it.
        !           147: .br
        !           148: Macros in other packages may break the adjustments
        !           149: made to the line length and indent when text is being placed
        !           150: around a picture.
        !           151: .br
        !           152: A missing or improper
        !           153: .B %%BoundingBox
        !           154: comment may cause the frame to be filled incorrectly.

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