tmac.an.repro

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

.\"
.\" @(#)tmac.an.repro	4.4	(ULTRIX)	12/20/90
.\"
.\"------------------------------------------------------------------------
.\"
.\" tmac.an.repro 	- macros for printing, typesetting, and indexing
.\"			  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. To change Reference Pages section names, see .TH macro definition
.\"	2. ULTRIX Documentation Tools(tm) must be installed in order to collect
.\"	   indexing data and to print / typeset it.
.\"	3. To change default Reference Pages Master Index book title, see 
.\"	     .ds BK
.\"	   ahead of .NX macro definition
.\"	4. Crop marks appear only in *troff output
.\"	5. 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.repro:
.\"	   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
.\"	   \(en replaced by \- because \(en is not known to nroff
.\"	   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
.\"	UF macro fixed (parameter passed now sets outer footer, overriding
.\"	  default, or -rp?)
.\"	TH macro:
.\"	  code to set ]T based on -rp? relocated to later location, so last
.\"	    page of a file does not revert back to -rp? or default value if
.\"	    .UF was invoked in the file
.\"	all comments depersonalized
.\"	"ULTRIX-32" shortened to "ULTRIX" for V4.0
.\"
.\" 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.
.\"	deleted extra .yn in .NX macro
.\"
.\" 07/17/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.
.\"	NX macro:
.\"	  replace hyphens with \(en to output en-dash instead of em-dash
.\"	  remove \\% since hyphen replaced by \(en
.\"
.\" 06/08/89
.\"	ULTRIX Documentation Tools(tm) (RISC) T1.0 macros now bundled into
.\"	   ULTRIX and made common on both VAX and RISC platforms, for
.\"	   ULTRIX V4.0
.\"	Including from ULTRIX Documentation Tools(tm) (RISC) T1.0 tmac.an.repro:
.\"	   .NX macro -- for indexing reference pages; for use in conjunction
.\"	      with ULTRIX Documentation Tools(tm) MU macros (tmac.u)
.\"	      and indexing tools
.\"        .ds BK Book Title for default Reference Pages book titles names for
.\"	     book indexes (can be used if ULTRIX Documentation Tools(tm)
.\"	     installed)
.\"			1 -  9 for Supported reference pages
.\"		       11 - 19 for Unsupported reference pages
.\"        revised TH Macro to recognize the "p" register values 11-19 as 1-9
.\"        delayed setting of string ]S within macro TH
.\"        added .ds HH \np for "chapter" number (manpage section reg.)
.\"   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 3-Jul-86  1150
.\"  Removed lowercase translation, now that source files have lowercase
.\"     arguments for TH macro (11-Jun-86)
.\"
.\" tmac.repro -- used for ULTRIX V1.2 manpage production
.\"   13-Jan-86:
.\"  Eliminate section number register and dashes for kit
.\"  Include translation to lowercase for header
.\"  Fix problem with ULTRIX V1.2 version for ditroff (print header in 14pt,
.\"	not 9pt)
.\"  Correct inproper placement of odd-page header caused by translate ev 
.\"  Change font for MS and PN to italic to match old IR and hardcode 
.\"  Change section heads to TB for new look
.\"  
.\" Welcome to   tmac.an
.\"   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\\*(]S\^\-\^~\fP\fH \\*(]T\fP\fH\\*(]W\fP
.if o .tl \fH\\*(]W\fP\fH\\*(]T \fP\f(HB\\*(]S\^\-\^~\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
.de TH
.na
.nh
.PD
.DT
.if n .nr IN .2i
.if t .nr IN 4P
.if n .nr LL 7.4i
.if t .nr LL 36P
.if n .nr PL \\n(.p
.if t .nr PL \\n(}L
.\"
.ds ]H \\$1\|(\^\\$2\^)
.ie \\$3 .ds ]L
.el .ds ]L \\$3
.ie \\$5 .ds ]D
.el .ds ]D \\$5
.wh 0 }H
.if t .wh -4P-32p-0p-1v }F	\" text margin -32 pts -crop mark -1v
.if n .wh -.5i-2v-1v }F
.if t .wh -5p }C		\" bottom page crop mark
.em }M
.if \\n(nl \{\