Commit | Line | Data |
---|---|---|
c44c8f55 KM |
1 | .\" Copyright (c) 1983 Regents of the University of California. |
2 | .\" All rights reserved. The Berkeley software License Agreement | |
3 | .\" specifies the terms and conditions for redistribution. | |
4 | .\" | |
5 | .\" @(#)ms.diffs 5.1 (Berkeley) %G% | |
6 | .\" | |
7 | .nr LL 6.5i | |
8 | .nr FL 6.0i | |
9 | .if t .nr PD .5v | |
10 | .if t .ds m \u\(ul\dm | |
11 | .if n .ds m -m | |
12 | .AM | |
13 | .OH '\fIThe New -ms Macros\fR''\fIPage %\fR' | |
14 | .EH '\fIPage %\fR''\fIThe New -ms Macros\fR' | |
15 | .TL | |
16 | A Revised Version of \*ms | |
17 | .AU | |
18 | Bill Tuthill | |
19 | .AI | |
20 | Computing Services | |
21 | University of California | |
22 | Berkeley, CA 94720 | |
23 | .PP | |
24 | The \*ms macros have been slightly revised and re\%arranged. | |
25 | Because of the rearrangement, | |
26 | the new macros can be read by the computer | |
27 | in about half the time required by the previous version of \*ms. | |
28 | This means that output will begin to appear between ten seconds | |
29 | and several minutes more quickly, depending on the system load. | |
30 | On long files, however, the savings in total time are not substantial. | |
31 | The old version of \*ms is still available as \*mos. | |
32 | .PP | |
33 | Several bugs in \*ms have been fixed, including | |
34 | a bad problem with the .1C macro, | |
35 | minor difficulties with boxed text, | |
36 | a break induced by .EQ before initialization, | |
37 | the failure to set tab stops in displays, | |
38 | and several bothersome errors in the \fBrefer\fP macros. | |
39 | Macros used only at Bell Laboratories have been removed. | |
40 | There are a few extensions to previous \*ms macros, | |
41 | and a number of new macros, but all the documented \*ms macros | |
42 | still work exactly as they did before, and have the same names as before. | |
43 | Output produced with \*ms should look like output produced with \*mos. | |
44 | .PP | |
45 | One important new feature is automatically numbered footnotes. | |
46 | Footnote numbers are printed by means of a pre-defined string | |
47 | (\e\(**\(**), which you invoke separately from .FS and .FE. | |
48 | Each time it is used, this string increases the footnote number by one, | |
49 | whether or not you use .FS and .FE in your text. | |
50 | Footnote numbers will be superscripted on the phototypesetter | |
51 | and on daisy-wheel terminals, but on low-resolution devices | |
52 | (such as the lpr and a crt), they will be bracketed. | |
53 | If you use \e\(**\(** to indicate numbered footnotes, | |
54 | then the .FS macro will automatically include | |
55 | the footnote number at the bottom of the page. | |
56 | This footnote, for example, was produced as follows:\** | |
57 | .DS | |
58 | This footnote, for example, was produced as follows:\e\(**\(** | |
59 | \&.FS | |
60 | .sp -.2 | |
61 | ... | |
62 | \&.FE | |
63 | .DE | |
64 | .FS | |
65 | If you never use the ``\e\(**\(**'' string, | |
66 | no footnote numbers will appear anywhere in the text, | |
67 | including down here. | |
68 | The output footnotes will look exactly like | |
69 | footnotes produced with \*mos. | |
70 | .FE | |
71 | If you are using \e\(**\(** to number footnotes, | |
72 | but want a particular footnote to be marked with an asterisk or a dagger, | |
73 | then give that mark as the first argument to .FS: \(dg | |
74 | .DS | |
75 | then give that mark as the first argument to .FS: \e(dg | |
76 | \&.FS \e(dg | |
77 | .sp -.2 | |
78 | ... | |
79 | \&.FE | |
80 | .DE | |
81 | .FS \(dg | |
82 | In the footnote, the dagger will appear where the footnote | |
83 | number would otherwise appear, as on the left. | |
84 | .FE | |
85 | Footnote numbering will be temporarily suspended, | |
86 | because the \e\(**\(** string is not used. | |
87 | Instead of a dagger, you could use an asterisk * | |
88 | or double dagger \(dd, represented as \|\e(dd. | |
89 | .PP | |
90 | Another new feature is a macro for printing theses | |
91 | according to Berkeley standards. | |
92 | This macro is called .TM, which stands for thesis mode. | |
93 | (It is much like the .th macro in \*me.) | |
94 | It will put page numbers in the upper right-hand corner; | |
95 | number the first page; suppress the date; | |
96 | and doublespace everything except quotes, displays, and keeps. | |
97 | Use it at the top of each file making up your thesis. | |
98 | Calling .TM defines the .CT macro for chapter titles, | |
99 | which skips to a new page and moves the pagenumber to the center footer. | |
100 | The .P1 (P one) macro can be used even without thesis mode | |
101 | to print the header on page 1, | |
102 | which is suppressed except in thesis mode. | |
103 | If you want roman numeral page numbering, | |
104 | use an ``.af\0PN\0i'' request. | |
105 | .PP | |
106 | There is a new macro especially for bibliography entries, | |
107 | called .XP, which stands for exdented paragraph. | |
108 | It will exdent the first line of the paragraph by \en(PI units, | |
109 | usually 5n (the same as the indent for the first line of a .PP). | |
110 | Most bibliographies are printed this way. | |
111 | Here are some examples of exdented paragraphs: | |
112 | .XP | |
113 | Lumley, Lyle S., \fISex in Crustaceans: Shell Fish Habits,\fP\| | |
114 | Harbinger Press, Tampa Bay and San Diego, October 1979. | |
115 | 243 pages. | |
116 | The pioneering work in this field. | |
117 | .XP | |
118 | Leffadinger, Harry A., ``Mollusk Mating Season: 52 Weeks, or All Year?'' | |
119 | in \fIActa Biologica,\fP\| vol. 42, no. 11, November 1980. | |
120 | A provocative thesis, but the conclusions are wrong. | |
121 | .LP | |
122 | Of course, you will have to take care of | |
123 | italicizing the book title and journal, | |
124 | and quoting the title of the journal article. | |
125 | Indentation or exdentation can be changed | |
126 | by setting the value of number register PI. | |
127 | .PP | |
128 | If you need to produce endnotes rather than footnotes, | |
129 | put the references in a file of their own. | |
130 | This is similar to what you would do if you were | |
131 | typing the paper on a conventional typewriter. | |
132 | Note that you can use automatic footnote numbering | |
133 | without actually having .FS and .FE pairs in your text. | |
134 | If you place footnotes in a separate file, | |
135 | you can use .IP macros with \e\(**\(**\| as a hanging tag; | |
136 | this will give you numbers at the left-hand margin. | |
137 | With some styles of endnotes, | |
138 | you would want to use .PP rather then .IP macros, | |
139 | and specify \e\(**\(** before the reference begins. | |
140 | .PP | |
141 | There are four new macros to help produce a table of contents. | |
142 | Table of contents entries must be enclosed in .XS and .XE pairs, | |
143 | with optional .XA macros for additional entries; | |
144 | arguments to .XS and .XA specify the page number, | |
145 | to be printed at the right. | |
146 | A final .PX macro prints out the table of contents. | |
147 | Here is a sample of typical input and output text: | |
148 | .DS | |
149 | \&.XS ii | |
150 | Introduction | |
151 | \&.XA 1 | |
152 | Chapter 1: Review of the Literature | |
153 | \&.XA 23 | |
154 | Chapter 2: Experimental Evidence | |
155 | \&.XE | |
156 | \&.PX | |
157 | .sp .5 | |
158 | .lt 5.5i | |
159 | .tl ''\fBTable of Contents\fP'' | |
160 | .ta 5i 5.5iR | |
161 | .sp | |
162 | Introduction \ 1 ii\| | |
163 | Chapter 1: Review of the Literature \ 1 1 | |
164 | Chapter 2: Experimental Evidence \ 1 23 | |
165 | .sp .5 | |
166 | .DE | |
167 | The .XS and .XE pairs may also be used in the text, | |
168 | after a section header for instance, | |
169 | in which case page numbers are supplied automatically. | |
170 | However, most documents that require a table of contents | |
171 | are too long to produce in one run, | |
172 | which is necessary if this method is to work. | |
173 | It is recommended that you do a table of contents | |
174 | after finishing your document. | |
175 | To print out the table of contents, use the .PX macro; | |
176 | if you forget it, nothing will happen. | |
177 | .PP | |
178 | As an aid in producing text that will format correctly | |
179 | with both \fBnroff\fP and \fBtroff\fP, | |
180 | there are some new string definitions that define quotation marks | |
181 | and dashes for each of these two formatting programs. | |
182 | The \e\(**\^\u_\d string will yield two hyphens in \fBnroff\fP, | |
183 | but in \fBtroff\fP it will produce an em dash\*- | |
184 | like this one. | |
185 | The \e\(**Q and \e\(**U strings will produce | |
186 | `` and '' in \fBtroff\fP, but " in \fBnroff\fP. | |
187 | (In typesetting, the double quote is traditionally considered bad form.) | |
188 | .PP | |
189 | There are now a large number of optional | |
190 | foreign accent marks defined by the \*ms macros. | |
191 | All the accent marks available in \*mos are present, | |
192 | and they all work just as they always did. | |
193 | However, there are better definitions available | |
194 | by placing .AM at the beginning of your document. | |
195 | Unlike the \*mos accent marks, | |
196 | the accent strings should come \fIafter\fP\| the letter being accented. | |
197 | Here is a list of the diacritical marks, | |
198 | with examples of what they look like. | |
199 | .DS | |
200 | .ta 2i 3i | |
201 | name of accent input output | |
202 | \l'3.5i' | |
203 | acute accent e\e\(**\' e\*' | |
204 | grave accent e\e\(**\` e\*` | |
205 | circumflex o\e\(**\d^\u o\*^ | |
206 | cedilla c\e\(**, c\*, | |
207 | tilde n\e\(**\d~\u n\*~ | |
208 | question \e\(**? \*? | |
209 | exclamation \e\(**! \*! | |
210 | umlaut u\e\(**: u\*: | |
211 | digraph s \e\(**8 \*8 | |
212 | hac\*vek c\e\(**v c\*v | |
213 | macron a\e\(**_ a\*_ | |
214 | underdot s\e\(**. s\*. | |
215 | o-slash o\e\(**/ o\*/ | |
216 | angstrom a\e\(**o a\*o | |
217 | yogh kni\e\(**3t kni\*3t | |
218 | Thorn \e\(**(Th \*(Th | |
219 | thorn \e\(**(th \*(th | |
220 | Eth \e\(**(D- \*(D- | |
221 | eth \e\(**(d- \*(d- | |
222 | hooked o \e\(**q \*q | |
223 | ae ligature \e\(**(ae \*(ae | |
224 | AE ligature \e\(**(Ae \*(Ae | |
225 | oe ligature \e\(**(oe \*(oe | |
226 | OE ligature \e\(**(Oe \*(Oe | |
227 | .DE | |
228 | If you want to use these new diacritical marks, | |
229 | don't forget the .AM at the top of your file. | |
230 | Without it, some will not print at all, | |
231 | and others will be placed on the wrong letter. | |
232 | .PP | |
233 | It is also possible to produce custom headers and footers | |
234 | that are different on even and odd pages. | |
235 | The .OH and .EH macros define odd and even headers, | |
236 | while .OF and .EF define odd and even footers. | |
237 | Arguments to these four macros are specified as with .tl. | |
238 | This document was produced with: | |
239 | .DS | |
240 | \&.OH \'\ef\^IThe -mx Macros\'\'Page %\ef\^P\' | |
241 | \&.EH \'\ef\^IPage %\'\'The -mx Macros\ef\^P\' | |
242 | .DE | |
243 | Note that it would be a error to have an apostrophe in the header text; | |
244 | if you need one, you will have to use a different delimiter | |
245 | around the left, center, and right portions of the title. | |
246 | You can use any character as a delimiter, provided it doesn't appear | |
247 | elsewhere in the argument to .OH, .EH, .OF, or EF. | |
248 | .PP | |
249 | The \*ms macros work in conjunction with | |
250 | the \fBtbl\fR, \fBeqn\fR, and \fBrefer\fR preprocessors. | |
251 | Macros to deal with these items are read in only as needed, | |
252 | as are the thesis macros (.TM), | |
253 | the special accent mark definitions (.AM), | |
254 | table of contents macros (.XS and .XE), | |
255 | and macros to format the optional cover page. | |
256 | The code for the \*ms package lives in /usr/lib/tmac/tmac.s, | |
257 | and sourced files reside in the directory /usr/ucb/lib/ms. | |
258 | .sp | |
259 | .tl '''\*(DY' |