tmac.an

<B>Digital的Unix操作系统VAX 4.2源码</B>

.\"
.\" @(#)tmac.an	4.4	(ULTRIX)	12/20/90
.\"
.\"------------------------------------------------------------------------
.\"
.\" tmac.an		- macros for viewing and printing ULTRIX reference
.\"			  pages
.\"
.\"------------------------------------------------------------------------
.\"
.\"**********************************************************************
.\"*									*
.\"*   Copyright (c) Digital Equipment Corporation, 1987, 1989, 1990	*
.\"*									*
.\"*   All Rights Reserved.  Unpublished rights  reserved  under  the	*
.\"*   copyright laws of the United States.				*
.\"*									*
.\"*   The software contained on this media  is  proprietary  to  and	*
.\"*   embodies  the  confidential  technology  of  Digital Equipment	*
.\"*   Corporation.  Possession, use, duplication or dissemination of	*
.\"*   the  software and media is authorized only pursuant to a valid	*
.\"*   written license from Digital Equipment Corporation.		*
.\"*									*
.\"*   RESTRICTED RIGHTS LEGEND   Use, duplication, or disclosure  by	*
.\"*   the U.S. Government is subject to restrictions as set forth in	*
.\"*   Subparagraph (c)(1)(ii)  of  DFARS  252.227-7013,  or  in  FAR	*
.\"*   52.227-19, as applicable.					*
.\"*									*
.\"*   This software is  derived  from  software  received  from  the	*
.\"*   University    of   California,   Berkeley,   and   from   Bell	*
.\"*   Laboratories.  Use, duplication, or disclosure is  subject  to	*
.\"*   restrictions  under  license  agreements  with  University  of	*
.\"*   California and with AT&T.					*
.\"*									*
.\"**********************************************************************
.\"
.\"------------------------------------------------------------------------
.\"
.\" Notes:
.\"	1. Crop marks appear only in *troff output
.\"	2. No crop marks for 8.5" x 11" pages
.\"
.\"------------------------------------------------------------------------
.\"
.\"                      Modification History
.\"
.\" 12/05/90
.\"	Page Offset (PO) increased from .1i to .3i, and
.\"	LL (overall test image width) for nroff decreased from 7.8i to 7.4i (74
.\"	  characters) in order to permit nroff output to fit on European A4
.\"       paper
.\"	}H, }F internal macros:
.\"	  use tilde (~) instead of default page number indicator (%) in titles
.\"	    for headers/footers in order to permit use of percent (%) in
.\"	    manpages names
.\"
.\" 11/09/90
.\"	Reduced Page Offset (PO) for nroff from .5i to .1i, in order to
.\"	Increase LL (overall test image width) for nroff from 7i to 7.8i (78
.\"	  characters)
.\"	Reduced basic text indent IN for nroff from .5i to .2i
.\"	RS macro:
.\"	  reduced secondary nroff incremental indent from .25i (rounded) to .2i
.\"	  to make all RS secondary indents consistent.
.\"
.\" 09/07/90
.\"	NT macro:
.\"	  changed default header to "Note" instead of "NOTE" to be consistent
.\"	  with ULTRIX Documentation Tools(tm) V1.0 -mu NT macro
.\"
.\" 01/17/90
.\"     }S internal macro and all macros which call it:
.\"	   restored " delmiters around passed parameters so that passed blanks
.\"	      do not get stripped when the .}S internal macro is called.
.\"
.\" 10/30/89
.\"	ULTRIX Documentation Tools(tm) V1.0 FT2 macros now bundled into ULTRIX
.\"	   and made common on both VAX and RISC platforms, for ULTRIX V4.0
.\"	Including from ULTRIX Documentation Tools(tm) V1.0 FT2 tmac.an:
.\"	   registers }W, }L, PO, ]C, ]T: defined to specify basic page
.\"	      dimensions
.\"	   page offsets and lengths set based on page and crop mark specs.
.\"	   all basic dimensions and styles commands conditionalized for
.\"	      nroff and troff
.\"	   headers and footers adjusted for crop marks
.\"	   crop marks (when enabled) are 4-corner style, using +'s, instead of
.\"	      "|-- .... --|"
.\"	   delimiters @, " and ' replaced by ^G's or "'s, else removed, in
.\"	      many macros in order to allow @, \&", and ' in section/
.\"	      subsections/ notes headers, and in manpage headers/footers
.\"	   headers/footers wobblings corrected by removal of parenthesis around
.\"	      expressions controlling vertical/horizontal movements
.\"	   setup of headers/ footers/ crop marks traps adjusted so headers/
.\"	      footers of previous nor following pages trashed by "current"
.\"	      page, and to prevent late footers, text too close to footers,
.\"	      blank and excess pages
.\"	   sections/subsections/notes require at least 4 lines on a page (done
.\"	      with  .ne 4.1 )
.\"	   NT macro "needs" requirement changed from 4 to 4.1.
.\"	   Ds macro: calls font R before exiting
.\"	   reformatting of some if/ie/ei code blocks
.\"	   deletion of some obsolete code and comments
.\"	with additional differences from ULTRIX Documentation Tools(tm) V1.0:
.\"	   basic page dimensions are 8.5x11 for *troff; 75x66 for *nroff
.\"	      with 5-column indent for *nroff (nroff net line length of 70)
.\"	   no crop marks for 8.5x11 pages
.\"	   basic inter-paragragh/ section header/ subheader/ notes spacing
.\"	      is .5v, instead of .4v
.\"	   Examples, by default, are not indented relative to body text
.\"	   Subsection headers have 1 trailing blank line when formatted by
.\"	      *nroff.
.\"	*nroff footer traps corrected for 2-line minimum between text and
.\"	  footer
.\"	-man-style footers restored (replaced -man.repro-style footers)
.\"	all comments depersonalized
.\"
.\" 08/16/89
.\"	restored 4.2BSD-based 4th and 5th fields to TH macro, and
.\"	  revised headers and footers accordingly
.\"		- fields 3 - 5 have NO defaults
.\"		- field 4 is page footer inside [left if odd; right if even]
.\"		- field 5 is under the page header name(Ssubsection)
.\"	EX macro:
.\"	  optional parameter is now labeled as "n" units when saved in
.\"	  EX register; previously it was ignored.
.\"	NT macro:
.\"	  .ne 7 reduced to .ne 4 so 2-line notes will fit on a page.
.\"
.\" 07/10/89
.\"	zero-width space inserted in front of CW font calls to suppress
.\"	  extra-wide spaces when font changes occur
.\"	EX macro:
.\"	  default point size based on current point size.
.\"	  default line lead size based on current line lead size.
.\"
.\" 06/08/89
.\"	ULTRIX-32 (RISC) V3.1 macros now made common on both RISC and VAX
.\"	  platforms for ULTRIX V4.0, with the following additional bug fixes
.\"	  and modifications made:
.\"	TH macro: fix of RISC-only bug
.\"       fixed "if-else overflow" bug; changed .ie => .if
.\"	changed basic page layout to 8.5x11 for *troff processors, from
.\"	  7x9 format, and eliminated crop marks
.\"	changed basic page layout for nroff to 7 inches wide, instead of
.\"	  default 6.5, with .5 inches left margin
.\"	replaced all references to font numbers with names
.\"	replaced all references to Triumvirate fonts with Helvetica fonts
.\"	  for PostScript (tm - Adobe) compatibility
.\"	changes made to point sizes, line spacings, and other stylistic changes
.\"	  made in order to improve appearance when formating for PostScript
.\"	  printers and *troff processors
.\"	output 3rd field of .TH on outside edges of pages if using *troff
.\"	EX macro:
.\"	  no longer requires any minimum no. of lines to fit on a page
.\"	deleted redundant and obsolete coding
.\"	changed all comments from '<tab>#<text> format to
.\"	  .<tab>\"<text> format which is the more conventional notation
.\"
.\" 03/04/89
.\"	Pn macro (Path name with 3 arguments)
.\"	   - similar to .PN macro
.\"	Ds macro ("display without keeps") added
.\"	De macro ("end display, without end keep") added
.\"	   - companion to .Ds macro
.\"	NT macro:
.\"	   fixed compare of no. of arguments with 1 instead of with 1st arg.
.\"
.\" 11/18/88
.\"	added 3rd field to .TH macro, so RISC-only, VAX-only, and other
.\"	  machine-specific reference pages can be identified.  If nothing
.\"	  is specified for the 3rd field, it is ignored.  Nothing in the
.\"	  field means this is a machine-independent reference page
.\"	modified .}H macro to put 3rd field passed to .TH into header title
.\"	disabled the string ]D
.\"
.\" --------------------------- Ancient History ----------------------
.\"
.\" Last revised on 11-Jun-86  2137
.\"  Removed lowercase translation, now that source files have lowercase
.\"     arguments for TH macro (11-Jun-86)
.\"  Eliminate section number register and dashes for kit,
.\"  	fix problem with ULTRIX V1.2 version for ditroff (print header in 12pt,
.\"	 not 9pt) (10-Jan-86)
.\"
.\" Welcome to   tmac.an  for ULTRIX Version 2.0
.\"   nroff/ditroff macros used to print ULTRIX-32/32m manpages
.\"    descended from the original Bell man macros, with fertilization
.\"    by the ULTRIX-32 Version 1.0 crew, along with a few thistles taken
.\"    from the doc. group's mu macros.
.\"
.\"   USE COMMENTS for additions and changes to preserve the sanity
.\"    of those who follow you!
.\"
.\" -----------------------------------------------------------------
.\"
.\" Set Basic Page Dimensions:
.\"
.\"	Set *troff output for ULTRIX 8.5x11 format.
.\"
.\"	Overall Page Dimensions:	8.5i x 11i	( }W x }L )
.\"	Page Offset:			7.5P		( PO )
.\"	  - Left indent from left edge of overall text image area
.\"	  - all text is indented by this amount from the left edge of the image
.\"	    area
.\"	  - Left and Right margins are the same so text is centered
.\"	Crop Mark Offset:		0P		( ]C )
.\"	  - left page offset from physical edge of paper
.\"	  - Left crop marks actually print on outside edge of this position
.\"	  - [No crop marks for 8.5x11 format]
.\"
.if t .nr }W 8.5i		\" Overall page width
.if t .nr }L 11i		\" Overall page length
.if n .nr PO .3i		\" page offset for Nroff ULTRIX 8.5x11 format
.				\"   (set 3 characters in so body text
.				\"   (length set in .TH macro == 74 characters)
.				\"   appears centered on 80-column display)
.if t .nr PO 7.5P		\" page offset for Troff ULTRIX 8.5x11 format
.				\"   (also left & right margin widths)
.				\" [No crop marks for 8.5x11 format]
.if n .nr ]C 0P			\" crop mark offset from Left Margin
.if t .nr ]C 0P
.if n .nr ]T 0i			\" crop mark drop from Top margin
.if t .nr ]T 0i
.\"
.\" Set Page Offset
.\"	In "Old" Troff, the default page offset is 26/27 inch.  This may not
.\"	be the same for other versions of Troff (ex. newer versions may
.\"	default to 1 inch (27/27 inch)).  Therefore, lets make sure its
.\"	explicitly set.  All indents set relative to this.
.\"
.po \n(]Cu+\n(POu		\" set page offset
.\"
.if \nl .ls 2			\" if -rl1 then double-space lines
.\"
.ie n \{\
.	ds lq \&"\"
.	ds rq \&"\"
.\}
.el \{\
.	ds rq ''
.	ds lq ``
.\}
.	\" reset the basic page layout
.de }E
.}f
.in \\n()Ru+\\n(INu
.ll \\n(LLu
.if n .pl \\n(PLu
.if t .pl \\n(PLu+\\n(]Tu+0p	\" page length + crop mark drop
..
.	\" default tabs
.de DT
'ta .5i 1i 1.5i 2i 2.5i 3i 3.5i 4i 4.5i 5i 5.5i 6i 6.5i
..
.	\" set basic (default) type font and size
.	\" For readability with PostScript fonts, use 11 on 12
.de }f
.if n .ps 11
.if t .ps 11
.if n .vs 12
.if t .vs 12
.ft R
..
.	\" handle the head of the page
.de }H
.nr p# +1
.ev 1
.pc ~				\" use ~ for page nums in titles instead of %
.				\"  to allow manpages names containing `%'
.\".if t 'sp |\\n(]Tu		\" top crop mark drop
.\".}C
.if n 'sp |.5i
.if t 'sp |4P+\\n(]Tu		\" header drop + top crop mark drop
.ps 13
.		\" Even and odd page headers
.if t 'sp 4p			\" extra header drop
.ie \\*(]L \{\
.	lt \\n(LLu
.	if e .tl \f(HB\\*(]H\fP
.	if o .tl \f(HB\\*(]H\fP
.\}
.el \{\
.	ie n \{\
.		lt \\n(LLu
.		if e .tl \f(HB\\*(]H\fP\fH\\*(]L\fP
.		if o .tl \fH\\*(]L\fP\f(HB\\*(]H\fP
.	\}
.	el \{\
.		lt \\n(LLu+\w\fH\0\0\0\0\\*(]Lu
.		if e \{\
.			po \\n(.ou-\w\fH\0\0\0\0\\*(]Lu
.			tl \fH\\*(]L\0\0\0\0\fP\f(HB\\*(]H\fP
.			po
.		\}
.		if o .tl \f(HB\\*(]H\fP\fH\0\0\0\0\\*(]L\fP
.	\}
.\}
.if !\\*(]D \{\
.	lt \\n(LLu
.	if n .vs 14
.	if t .vs 14
.	if e .tl \f(HB\\*(]D\fP
.	if o .tl \f(HB\\*(]D\fP
.	if n .vs
.	if t .vs
.\}
.ps
.if n 'sp .5i-1v
.if t 'sp 15p
.pc %				\" restore % for page numbers in titles
.ev
..
.	\" handle the foot of the page
.de }F
.ev 1
.pc ~				\" use ~ for page nums in titles instead of %
.				\"  to allow manpages names containing `%'
.ps 9
.if n 'sp |\\n(.pu-.5i-1v
.if t 'sp |\\n(.pu-4P-1v-0p	\" text margin - 1 line - Bottom crop mark drop
.lt \\n(LLu
.if e .tl \f(HB~\fP\fH\\*(]W\fP
.if o .tl \fH\\*(]W\fP\f(HB~\fP
.ps
.pc %				\" restore % for page numbers in titles
'bp
.ev
..
.\"
.\" The Cut Mark Macros
.\"
.	\" the cut mark
.	\" disabled for 8.5x11 pages
.ig
.\".if n .ig
.de }C
.vs 4
.ft R
.po \\n(]Cu-(\w'\fR\s10+\fP'u/2u)u
.lt \\n(}Wu+\w'\fR\s10+\fP'u+(\w'\fR\s10+\fP'u/5u)u
.tl '\fR\s10+''+\s0\fP'
.lt
.vs
.ft
.po \\n(]Cu+\\n(POu
..
.	\" the final cut mark
.de }M
.}N
.wh -5p }C
.ll \\n(LLu
..
.\"
.	\" no runout unless there was a .TH
.de }K
.}N
.pl 1
.ll \\n(LLu
..
.em }K
.	\" set title and heading