![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to xxmonk.m CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / vol2 / monk|
Return to xxmonk.m CVS log | Up to [Research Unix] / researchv10dc / vol2 / monk |
1.1 root 1: |make(rp)
2:
3: |insert(monk.mac)
4:
5: |comment(VOL2HEADER)|set_counter(page 239-1)|set_string(page_headers "'''")|set_string(even_headers "'Typing Documents on the UNIX System: Using Monk 0.6''\f(NImonk\fP'")|set_string(odd_headers "'\f(NImonk\fP''Typing Documents on the UNIX System: Using Monk 0.6'")|set_string(even_footers "_\\nP__UNIX Papers_")|set_string(odd_footers "'Research Tenth Edition''\\nP'")
6:
7: |environment(cwfigure;
8: new.line, verbatim on, file.information, line.spacing 1,
9: fill off, inline off, size -2, font cw, inline on, space -2,
10: blank.lines 1;
11: SPACE)
12: |comment<summary: cwfigure (a constant-width figure)>
13:
14: |environment(computeroutput;
15: new.line, verbatim on, file.information, line.spacing 1,
16: fill off, inline off, size -1, font cw, inline on, space -1,
17: blank.lines 1,
18: tab.stops "\w' 'u 2u*\w' 'u 3u*\w' 'u 4u*\w' 'u 5u*\w' 'u 6u*\w' 'u 7u*\w' 'u 8u*\w' 'u 9u*\w' 'u 10u*\w' 'u 11u*\w' 'u";
19:
20: tab.stops, blank.lines 1, SPACE)
21:
22: |author(name "S. L. Murrel", initials SLM, location MH, department 11229,
23: extension x5772, room 2C-578)
24:
25: .Tm Typing Documents on the |small(UNIX) System: Using Monk g
26: |author(name "T. J. Kowalski", initials TJK, location MH, department 11229,
27: extension x2771, room 2C-568)
28:
29: |document(number 11229-851210-11TMS, file_case 25952, work_program 311401-2299)
30:
31: |document(number 11229-851210-11TMS, file_case 25952, work_program 311401-2199)
32:
33: |date(December 10, 1985)
34:
35: |title(Typing Documents on the |small(UNIX) System:
36: Using Monk 0.6)
37:
38: .CD "comment_section" "5.1"
39: .CD "special_section" "5.6"
40: .CD "table_example" "5.14"
41: .CD "picture_example" "5.16"
42: .CD "save_section" "5.18"
43: .CD "this_section" "5.18"
44: .CD "foobar" "251"
45: .CD "style_section" "5.4"
46: .CD "special_appendix" "B"
47: .CD "table_appendix" "C.1"
48: .Tm text-formatting program g
49: .CD "The alphabet in common type families" "1"
50:
51: |begin(abstract)
52: |i<Monk> is a text-formatting program that produces high-quality
53: typeset output.
54: .Tm Letters s
55: .Tm Release Papers s
56: .Tm Technical Memoranda s
57: This paper, printed using |i<monk>,
58: describes how to produce letters, memos, release papers,
59: and technical memoranda complete with cover sheets.
60: We provide extensive details on the three easy steps
61: needed to prepare a document with |i<monk>:
62:
63: |begin(number_list)
64:
65: |item
66: Use the |i<monksample> command to get a copy of a sample document.
67:
68: |item
69: Edit the copy, replacing the sample title, author, and the text body.
70: .Tm Figures
71: .Tm tables
72: .Tm equations
73: Add sections, appendices, captioned figures, tables, and equations.
74: .Tm Spacing s
75: Select the document style:
76: character size and type, page width and length, line spacing,
77: and number of columns.
78:
79: |item
80: Format the document using the |i<monk> command,
81: sending the output to a 5620 or 630MTG
82: terminal or a printer.
83: |i<Monk> will automatically invoke
84: the table, picture, equation, graph,
85: |comment{index,}
86: and reference pre-processors in the correct order.
87: .Tm Figures
88:
89: |end(number_list)
90:
91: |end(abstract)
92:
93: |titlebox
94:
95: |style(two_column)
96:
97: |section(Introduction)
98:
99: Preparing any document involves positioning words and figures on each page.
100: .Tm Spacing s
101: Using a typewriter,
102: the margins, line spacing, and tab positions are selected by moving levers.
103: Text is positioned by moving the sheet of paper left, right, up or down.
104: Using a computer, the text is interspersed with commands that tell a
105: formatting program what to do.
106: .Tm Letters s
107: .Tm Technical Memoranda s
108: |p
109: |i<Monk> is a new package of commands for producing
110: |s(AT&T) letters, memos, technical memoranda, and their cover sheets.
111: This paper will enable you to prepare documents using
112: |i<monk>.|reference<monk high-level text compiler>|reference<monk database>
113: |reference<using monk 1985>
114: You need to know how to log onto a computer and how to use an editor.
115: .Tm typesetting g
116: If you don't, see the |small(UNIX) Text Editing and Phototypesetting
117: .Tm typesetting g
118: .Tm Mixing Text and Commands s
119: Starter Package.|reference(Editing Phototypesetting Starter Package)
120: |blank_space(-1p)|comment{ZZZ: spacing kludge}
121: |section(Mixing Text and Commands)
122: |blank_space(-6p)
123: |p
124: Using any text editor,
125: type normally.
126: However,
127: instead of skipping a line before paragraphs
128: type |cw(|sp(|)paragraph) or |cw(|sp(|)p).
129: |index(paragraphs)
130: This command will produce a blank line.
131: To indent,
132: use |cw<|sp(|)p(i)> or |cw<|sp(|)paragraph(indented)>;
133: to number,
134: use |cw<|sp(|)p(n)> or |cw<|sp(|)paragraph(num|sp(hyphenation)bered)>.
135: |p
136: There are other commands that let you select document style and character type
137: .Tm Spacing s
138: (e.g., double spacing and italics)
139: .Tm tables
140: and include various sections and displays (e.g., chapters and tables).
141: .Tm Command Scope s
142: .Tm delimiters s
143:
144: |section(Command Scope)
145:
146: |comment{|index(command delimiters)|index(italics)}
147:
148: Using |i<monk>,
149: the sentence ``Italicize the words in |sp(|s)italics(parentheses)'' produces
150: ``Italicize the words in |i(parentheses).''
151: All |i<monk> commands begin with the character `|sp(|s)'.
152: The command |cw(|sp(|)italics) selects the operation and
153: the parentheses delimit the words to be italicized.
154: .Tm delimiters s
155: There are seven pairs of delimiters:
156:
157: |begin(center)
158: .Tm delimiters s
159: |cw<(>...|cw<)>, |cw([)...|cw(]), |cw(<)...|cw(>), |cw({)...|cw(}), |cw(")...|cw("), |cw(')...|cw('), |cw(`)...|cw(')
160: |end(center)
161:
162: |p
163: Always choose delimiters so that the closing delimiter does not appear in the
164: text.
165: ``Italicize the equation |sp(|s)i(a = (b + c) / number)'' produces
166: ``Italicize the equation |i(a = (b + c) / number).''
167: The closing delimiter ')' is found after the letter `c',
168: so that the rest of the equation is not italicized.
169: The input ``Italicize the equation |sp(|s)i<a = (b + c) / number>'' will
170: correctly italicize the entire equation, |i<a = (b + c) / number>.
171: In contrast, when |i<monk> commands are inside other |i<monk> commands,
172: the delimiter pairs are not ambiguous.
173: ``Italicize and shrink this |sp(|s)small(|sp(|s)i(word) but only shrink the rest)''
174: produces
175: ``Italicize and shrink this |small(|i(word) but only shrink the rest).''
176: |p
177: There is a second form of delimiter |sp(Em dash)
178: when a command operates on a long text segment,
179: the commands |cw(|sp(|)begin) and |cw(|sp(|)end)
180: are used instead of brackets or quotes.
181: The text fragment
182:
183: |begin(cwfigure)
184: |sp(|s)begin(italics)
185: Four score and seven years ago our fathers
186: brought forth to this continent a new
187: nation, conceived in liberty and ...
188: |sp(|s)end(italics)
189: |end(cwfigure)
190:
191: appears in the final document as
192:
193: |begin(italics)
194: Four score and seven years ago our fathers brought forth to this continent
195: a new nation, conceived in liberty and ...
196: |end(italics)
197:
198: The commands |cw(|sp(|)begin) and |cw(|sp(|)end) delimit
199: the text operated on by the
200: command |cw(|sp(|)italics).
201: .Tm Document Commands s
202: .Tm Letters s
203: .Tm Memoranda s
204: .Tm Technical Memoranda s
205: .Tm Release Papers s
206:
207: |section(Document Commands)
208:
209: This section describes the commands that are specific to formatting
210: four types of documents:
211: letters, |small(AT&T) Bell Laboratories memoranda, technical memoranda,
212: and release papers.
213: .Tm Typesetting a Letter s
214:
215: |environment(ret_address;
216: verbatim on, indent \n(U0u+\n(O0u-6n, fill off, here on;
217: minimum.lines)
218:
219: |subsection(Typesetting a Letter)
220:
221: For a letter, the input should begin as follows:
222:
223: |begin(cwfigure)
224: |sp(|)make(letter)
225: |sp(|)begin(ret_address)
226: |sp(|)s(AT&T) Bell Labs 2C-501
227: Murray Hill, N. J. 07974
228: |sp(|)end(ret_address)
229: |end(cwfigure)
230:
231: The first line specifies that the standard format for a letter should be used.
232: Then the return address, labeled |cw(ret_address), is delimited
233: by |cw(|sp(|)begin) and |cw(|sp(|)end) commands.
234: The formatter skips a couple of lines, indents, single spaces the address
235: itself, skips more lines, and then returns to the left hand margin
236: producing:
237:
238: |begin(figure)
239: |begin(ret_address)
240: |s(AT&T) Bell Labs 2C-501
241: Murray Hill, N. J. 07974
242: |end(ret_address)
243: |end(figure)
244:
245: The return address itself is not modified.
246: If the city, state, and zip code are input as separate lines,
247: they will appear that way in the final output:
248:
249: |begin(figure)
250: |begin(ret_address)
251: |s(AT&T) Bell Labs 2C-501
252: Murray Hill
253: N. J.
254: 07974
255: |end(ret_address)
256: |end(figure)
257:
258: |p
259: A letter consists of a sequence of standard groups:
260: a return address, date, recipient's address, greeting, body,
261: closing, and signature.
262: Accordingly,
263: the following prototype letter is available.
264:
265: |begin(cwfigure)
266: |comment<inserting samples/letter.nx starting here>
267: |sp(|)make(letter)
268: |blank_space(.5)
269: |sp(|)begin(ret_address)
270: |sp(|)s(AT&T) Bell Laboratories 2C-501
271: Murray Hill, New Jersey 07974
272: |sp(|)end(ret_address)
273: |blank_space(.5)
274: |sp(|)date(April 1, 1985)
275: |blank_space(.5)
276: |sp(|)begin(address)
277: G. H. Reiber
278: |sp(|)s(AT&T) Communications
279: Room 3C-110
280: Bedminster, |sp(|)s(NJ) 07921
281: |sp(|)end(address)
282: |blank_space(.5)
283: |sp(|)greeting(George Reiber:)
284: |blank_space(.5)
285: |sp(|)begin(body)
286: Yes, I would like to hire a painter for the
287: night of Monday, September 16, 1985.
288: Thank you very much.
289: |sp(|)end(body)
290: |blank_space(.5)
291: |sp(|)closing(Sincerely,)
292: |blank_space(.5)
293: |sp(|)signature(G. R. Emlin)
294: |comment<inserting samples/letter.nx ending here>
295: |end(cwfigure)
296:
297: |p
298: To copy this letter into a file named |cw<myfile> in your current directory,
299: type the |small(UNIX) command
300:
301: |begin(cwfigure)
302: monksample letter > myfile
303: |end(cwfigure)
304:
305: Using this prototype, it is not necessary for you to remember that
306: the label for return address is |cw(ret_address).
307: You need only recognize the English-like descriptions and
308: replace the sample text as appropriate.
309: Although any text editor will suffice, the large display of a visual editor
310: allows you to glance at the file and spot sample text.
311: |p
312: It is convenient to tailor the samples by entering your
313: address, closing, and signature and then saving the modified file.
314: .Tm Letters s
315: This new file can then be used for all your letters simply
316: by adding an appropriate greeting, the recipient's address, and the body.
317: .Tm Letters s
318: If you prepare letters for more than one person, you might want to maintain
319: a directory of tailored prototypes rather than begin with the
320: standard |i<monk> sample.
321:
322: |begin(cwfigure)
323: |comment<inserting samples/tailor.nx starting here>
324: |sp(|)make(letter)
325: |blank_space(.5)
326: |sp(|)begin(ret_address)
327: |sp(|)s(AT&T) Bell Laboratories 2C-524
328: Murray Hill, New Jersey 07974
329: |sp(|)end(ret_address)
330: |blank_space(.5)
331: |sp(|)date(April 1, 1985)
332: |blank_space(.5)
333: |sp(|)begin(address)
334: G. H. Reiber
335: |sp(|)s(AT&T) Communications
336: Room 3C-110
337: Bedminster, |sp(|)s(NJ) 07921
338: |sp(|)end(address)
339: |blank_space(.5)
340: |sp(|)greeting(To Whom It May Concern:)
341: |blank_space(.5)
342: |sp(|)begin(body)
343: Thank you very much.
344: |sp(|)end(body)
345: |blank_space(.5)
346: |sp(|)closing(Sincerely,)
347: |sp(|)signature(Sam)
348: |comment<inserting samples/tailor.nx ending here>
349: |end(cwfigure)
350:
351: |p
352: When installed,
353: |i<monk> is configured to use local printers as standard output
354: devices.|dagnote{Specify the printer that you have permission to use
355: by defining |s<LPDEST> in your |i<.profile>,
356: e.g., |cw<LPDEST=crete; export LPDEST>.}
357: You will need to talk to someone using or maintaining your computer system
358: to find out what and where your local standard printer is.
359: |p
360: To run off this memo on the standard printing device,
361: type |cw(monk myfile).
362: To send your output to a printing device other than the standard,
363: use the |cw<|sp(minus)S>|i<dest> and |cw<|sp(minus)T>|i<font> options.
364: To preview postscript output on a |s(AT&T) 5620 or 630MTG terminal, type
365: |cw(monk |sp(minus)Tpost |sp(minus)Sproof myfile).
366: .Tm Fonts s
367: Devices and fonts will vary with your location,
368: but commonly available types include:
369:
370: |begin(figure)
371: |begin(table)
372: center;
373: c1FCW lfB
374: l1FCWp-2 l.
375: .sp .5
376: |sp(minus)S|i(dest) Sends Output To Device |i(dest)
377: .sp .25
378: _
379: .sp .25
380: |sp(minus)Sapsend Linotronic 200P, see |i(apsend)(1)
381: |sp(minus)Sd202 Mergenthaler Linotronic 202, see |i(d202)(1)
382: |sp(minus)Si300 Spooling for |s(EXPTOOLS), see |i(i300)(1)
383: |sp(minus)Slp Spooling mechanism, see |i(lp)(1) (default)
384: |sp(minus)Slpr Spooling at Allentown, see |i(lpr)(1)
385: |sp(minus)Sproof 5620 or 630MTG terminal, see |i(proof)(9.1)
386: |sp(minus)Sprt Spooling at computer centers, see |i(prt)(1)
387: |sp(minus)Sthink Thinkjet, see |i(thinkblt)(9.1)
388: |sp(minus)S|sp(minus) Standard output
389: .sp
390: .T&
391: c1FCW lfB
392: l1FCWp-2 l.
393: .sp .5
394: |sp(minus)T|i(fonts) Selects Typesetter Or Terminal |i(fonts)
395: .sp .25
396: _
397: .sp .25
398: |sp(minus)T202 Mergenthaler Linotronic 202
399: |sp(minus)Taps Autologic |s(APS-5)
400: |sp(minus)Ti10 Imagen 10 printer
401: |sp(minus)Ti300 Imagen 300 printer
402: |sp(minus)Tim300 Imagen 300 printer at Liberty Corner
403: |sp(minus)Tpost PostScript|sp(registered) printer (default)
404: |sp(minus)Tthink Think jet printer
405: |end(table)
406: |end(figure)
407: .Tm Fonts s
408: .Tm Fonts s
409: .Tm Fonts s
410:
411: |p
412: If |s(TYPESETTER) is set and exported, then it determines the typesetter
413: or terminal fonts used in preparing the output.
414: Be careful to type |cw(monk |sp(minus)Tpost |sp(minus)Sapsend myfile)
415: or |cw(monk |sp(minus)Taps |sp(minus)Sprt myfile)
416: |b(only) when you intend to send
417: final copy to the high-quality, high-priced phototypesetter.
418:
419: |p
420: When |i<monk> is run, the individualized prototype letter will appear as
421: a full size version of the page below.
422: This is an excerpt of the sample's output,
423: scaled and included using PostScript.
424: .br
425: |comment< to make the postscript output the column width: x 3.1i, y 7i >
426: .ne 14v
427: |begin(ruled.display)
428: |postscript(file "samples/tailor.ps",
429: x 4.2i, y 7i, xoffset -.5i, yoffset -1i)
430: |blank_space(13v)
431: |end(ruled.display)
432: |blank_space(1v)
433: ..........
434: .Tm Typesetting a Memorandum s
435:
436: |subsection(Typesetting a Memorandum)
437:
438: Preparing a memorandum is similar to preparing a letter.
439: .Tm Memoranda s
440: Memoranda require a title, more information about the author,
441: and the document itself.
442: The information you provide is automatically arranged at the top of the page.
443: |p
444: Type
445:
446: |begin(cwfigure)
447: monksample memo > myfile
448: |end(cwfigure)
449:
450: to get the following prototype:
451:
452: |begin(cwfigure)
453: |comment<inserting samples/memo.nx starting here>
454: |sp(|)make(memo)
455: |blank_space(.5)
456: |sp(|)author(name "W. H. MacWilliams",
457: initials WHM, location WH, room 2E-221,
458: extension x511, department 1344)
459: |sp(|)document(number 1344-561210-09,
460: file_case 25952, work_program 311401-0199)
461: |blank_space(.5)
462: |sp(|)date(December 10, 1956)
463: |blank_space(.5)
464: |sp(|)title(|sp(|)s(MTS) Employment: Dr. J. L. Flanagan)
465: |blank_space(.5)
466: |sp(|)titlebox
467: |blank_space(.5)
468: F. D. Leamer:
469: |sp(|)p
470: This is to propose an offer of regular
471: |sp(|)s(MTS) employment to Dr. J. L. Flanagan
472: commencing on February 18, 1957.
473: |blank_space(.5)
474: |sp(|)signature(WH-1344-WHM-hhs)
475: |blank_space(.5)
476: |sp(|)notation[Copy (with att.) to:
477: E. E. David Jr.
478: A. G. Jensen]
479: |blank_space(.5)
480: |sp(|)approved(J. R. Pierce)
481: |comment<inserting samples/memo.nx ending here>
482: |end(cwfigure)
483: |blank_space(-1)|blank_space(-4p)|comment<ZZZ kludge - blankline at top of
484: column - trailing size change after cwfigure >
485: |p
486: The |cw<|sp(|)make> command asks |i<monk> to format the document as a memo.
487: The information about each author is given in a
488: separate |cw<|sp(|)author> command:
489: name, initials, location, department, extension, and room number.
490: Each instance of |cw<|sp(|)document> gives the document information for
491: the corresponding author.
492: Author, document, title, and date may appear in any order,
493: but must precede the command |cw<|sp(|)titlebox>,
494: which organizes, formats, and outputs all this information.
495: .Tm Figures
496: |p
497: After the titlebox comes the body of the memo,
498: which consists of paragraphs
499: separated by |cw<|sp(|)p>, simple font changes, and figures.
500: After the body comes the signature, any necessary notations,
501: and approvals.
502: This sample produces the following memo:
503: .br
504: .ne 20v
505: |begin(ruled.display)
506: |postscript(file "samples/memo.ps",
507: x 4.2i, y 7i, xoffset -.5i, yoffset -.9i)
508: |blank_space(19v)
509: |end(ruled.display)
510: |blank_space(1v)
511: ...........
512: |p
513: To omit information, simply delete the appropriate |i<monk> command.
514: Delete the entire line to omit notations or approvals.
515: To omit an author's location, omit the relevant labels and associated numbers,
516: e.g., |cw{|sp(|)author(name "W. H. MacWilliams", initials WHM, department 1344)}.
517: .Tm Typesetting a Technical Memorandum s
518:
519: |subsection(Typesetting a Technical Memorandum)
520:
521: This section describes how to prepare a technical memorandum.
522: The example below is the skeleton of the file that produced the previous |i(tm) version
523: of this document, excluding cover sheet information.
524: .Tm References s
525: This prototype consists of the declaration of the document type,
526: document numbers,
527: date,
528: authors, title, abstract, document body, appendices, and references.
529: It can be copied with the command |cw(monksample tm > myfile).
530:
531: |comment{entire tm here or simply body, ending before cover sheet info}
532:
533: |begin(cwfigure)
534: |comment<inserting samples/tmbody.nx starting here>
535: |sp(|)make(tm)
536: |blank_space(.5)
537: |sp(|)author(name "S. L. Murrel", initials SLM,
538: location MH, department 11229,
539: extension x5772, room 2C-578)
540: |sp(|)document(number 11229-851210-11TMS,
541: file_case 25952,
542: work_program 311401-2299)
543: |sp(|)author(name "T. J. Kowalski", initials TJK,
544: location MH, department 11229,
545: extension x2771, room 2C-568)
546: |sp(|)document(number 11229-851210-11TMS,
547: file_case 25952,
548: work_program 311401-2199)
549: |blank_space(.5)
550: |sp(|)date(December 10, 1985)
551: |blank_space(.5)
552: |sp(|)title(Typing Documents on the UNIX System:
553: Using Monk 0.3)
554: .Tm text-formatting program g
555: |blank_space(.5)
556: |sp(|)begin(abstract)
557: |sp(|)i(Monk) is a text-formatting program that
558: produces high-quality printed text.
559: |sp(|)end(abstract)
560: |blank_space(.5)
561: |sp(|)titlebox
562: |blank_space(.5)
563: |sp(|)unnumbered_section(INTRODUCTION)
564: |blank_space(.5)
565: A reference example.|sp(|)|sp(zero width space)reference(
566: Murrel Kowalski Using Monk 0.3 1985)
567: .Tm Mixing Text and Commands s
568: |blank_space(.5)
569: |sp(|)section(MIXING TEXT AND COMMANDS)
570: .Tm Typesetting a Technical Memorandum s
571: |blank_space(.5)
572: |sp(|)subsection(Typesetting a Technical Memorandum)
573: .Tm Unnumbered headings s
574: |blank_space(.5)
575: |sp(|)subsubsection(Unnumbered headings.)
576: |blank_space(.5)
577: |sp(|)signature(MH-11229-SLM/TJK-slm/tjk)
578: |blank_space(.5)
579: |sp(|)notation(Att.
580: .Tm References s
581: References)
582: |blank_space(.5)
583: |sp(|)other
584: |blank_space(.5)
585: |sp(|)|sp(zero width space)reference_placement
586: |comment<inserting samples/tmbody.nx ending here>
587: |end(cwfigure)
588: |p
589: The first line should specify the document type.
590: After that the order is flexible,
591: with the one restriction that all the
592: component information be available when larger units, such as the
593: titlebox, are printed.
594: .Tm Technical Memoranda s
595: Thus the author, date, and document information must be specified
596: before the command
597: |cw(|sp(|)titlebox), because it uses that information to produce
598: the standard header at the top of technical memoranda.
599: Note that the same |cw<|sp(|)titlebox> command produces different output
600: depending on the document type specified.
601: |p
602: The title is not filled, so that newlines entered by the author are preserved:
603: here |cw<Using Monk 0.3> appears as
604: the second line of the title.|dagnote<In unfilled text,
605: input lines are reproduced unchanged in the output;
606: in filled text, words from successive input lines may be combined to ensure
607: maximum length lines in the output.>
608: This is the first page produced by the |i<tm> input sample, scaled
609: to fit into the column.
610: The second page of the output provides the formatted reference list.
611: .br
612: .ne 25v
613: |begin(ruled.display)
614: |postscript(file "samples/tmbody.ps",
615: x 4.2i, y 7i, xoffset -.5i, yoffset -.9i)
616: |blank_space(24v)
617: |end(ruled.display)
618: |blank_space(1v)
619: ...........
620: |p
621: The commands |cw(|sp(|)author) and |cw(|sp(|)document)
622: belong to a type we have not previously discussed.
623: They allow you to specify a collection of information about a given item.
624: The first instance of |cw(|sp(|)author) specifies the name, initials,
625: location, department, extension, and room number of the first author.
626: The first instance of |cw(|sp(|)document) gives the document information
627: for the first author.
628: Authors and documents are linked as they appear, so that
629:
630: |begin(cwfigure)
631: |sp(|)author(name "S. L. Murrel", initials SLM,
632: location MH, department 11229)
633: |sp(|)author(name "T. J. Kowalski", location MH,
634: initials TJK, department 11229)
635: |sp(|)document(number 11229-851210-11TMS,
636: file_case 25952, work_program 311401-2299)
637: |sp(|)document(number 11229-851210-11TMS,
638: file_case 25952, work_program 311401-2199)
639: |end(cwfigure)
640:
641: is equivalent to the ordering given in the |i(tm) above.
642: Note that in these examples only part of the author information is included:
643: the room and extension numbers were omitted.
644: Any information can be omitted simply by deleting the corresponding |i<monk>
645: labels, e.g., |cw<room> and |cw<extension>.
646: Monk will try to format the information given gracefully.
647: |p
648: Additional information is needed to produce a standard |s<AT&T> cover sheet:
649:
650: |begin(cwfigure)
651: |comment<inserting samples/tmcs.nx starting here>
652: |sp(|)keywords(Word Processing,
653: Text Processing,
654: Formatting)
655: |blank_space(.5)
656: |sp(|)mercury(cmp, elc)
657: |blank_space(.5)
658: |sp(|)att(is_release yes)
659: |blank_space(.5)
660: |sp(|)distribute_complete_memo(Exec Directors 112
661: Directors 112
662: Department Heads 1122)
663: |blank_space(.5)
664: |sp(|)distribute_cover_sheet(A. A. Penzias
665: 1122 MTS)
666: |blank_space(.5)
667: |sp(|)cover_sheet
668: |comment<inserting samples/tmcs.nx ending here>
669: |end(cwfigure)
670:
671: Again, this information can appear anywhere in the document as long as it
672: precedes the command |cw(|sp(|)cover_sheet).
673: .Tm Lists s
674: Following local convention, keywords are filled, while the distribution lists
675: are not.
676: Although the title was not filled in the titlebox,
677: it is filled on the cover sheet because of space limitations.
678: .Tm tables
679: .Tm Figures
680: .Tm References s
681: |p
682: In producing the cover sheet, |i<monk> automatically calculates the numbers of
683: tables, figures, references,
684: as well as text pages, other pages, and total pages.
685: Use the command |cw<|sp(|)other> to mark the end of the text body and the
686: beginning of attachments.
687: |i<Monk> needs it to correctly distinguish text from other pages.
688: If there are any pages that are not included in this input file, you
689: can add to the counts using the command |cw<|sp(|)add_totals>.
690: For example,
691: if there is an additional attachment page that is not a table or figure,
692: then the command |cw<|sp(|)add_totals(other 1)> suffices.
693: .Tm tables
694: .Tm Figures
695: .Tm References s
696: You should never have to use the complete form of the command:
697: |cw<|sp(|)add_totals(text 0, tables 0, figures 1, references 11,
698: other 2)>.
699: .Tm References s
700: This command means that you are adding 2 additional pages by hand,
701: which include one figure and eleven references.
702: .Tm tables
703: The counts of text pages and tables are untouched.
704: |p
705: There are six commands specific to the |s(AT&T B)ell |s(L)abs cover sheet
706: that provide distribution information.
707: Use |cw<|sp(|)mercury> to specify the company-wide announcements
708: that should include
709: the abstract of this document:
710: |cw<chm>, |cw<cmm>, |cw<cmp>, |cw<elc>, |cw<lfs>, |cw<man>, |cw<mas>, |cw<mkt>,
711: and |cw<phy>.
712: Use the |i<monk> command |cw<|sp(|)distribute_complete_memo> to
713: list individu\%als who should receive the complete memo and
714: |cw<|sp(|)distribute_cover_sheet>
715: to list those who should receive only the cover sheet.
716: The command |cw<|sp(|)att> gives relevant |s(AT&T) release information:
717: |cw<is_release> marks the |i<yes> or |i<no> box
718: as specified by its argument.
719: |cw<|sp(|)director_name> identifies the director of the first author.
720: Finally, the command |cw<|sp(|)cover_sheet> prints the following cover sheet.
721: .Tm References s
722: Note that this sample produces four pages:
723: one page of text, one page of references, and two pages of cover sheet.
724: .br
725: .ne 26v
726: |begin(ruled.display)
727: |postscript(file "samples/tmcs.ps",
728: x 3.4i, y 7i, xoffset -.1i, yoffset -1.1i)
729: |blank_space(25v)
730: |end(ruled.display)
731: |blank_space(1v)
732: ...........
733: .Tm Typesetting a Release Paper s
734: .Tm Release Papers s
735:
736: |subsection(Typesetting a Release Paper)
737:
738: There is a |i<monk> sample for release papers, which can be modified
739: in the same way as
740: the documents already discussed.
741: However, you may often want to convert a technical memorandum
742: into a release paper.
743: .Tm Content Formatting Commands s
744: .Tm Footnotes
745: To do so, change the first line from
746: |cw<|sp(|)make(tm)> to |cw<|sp(|)make(rp)>
747: and then remove or comment out (see Section |remember(comment_section))
748: the information specific to the
749: |i<tm> style:
750:
751: |begin(bullet_list)
752: |item |cw<other>
753: |item |cw<add_totals>
754: |item |cw<mercury>
755: |item |cw<distribute_cover_sheet>
756: |item |cw<distribute_complete_memo>
757: |item |cw<cover_sheet>
758: |item |cw<att>
759: |item |cw<signature>
760: |item |cw<director_name>
761: |end(bullet_list)
762:
763: |section(Content Formatting Commands)
764:
765: For any document type, it is possible to format section titles,
766: figure captions, footnotes, and two-column output.
767: It is possible to store page numbers, section numbers or figure numbers
768: for later use.
769: .Tm equations
770: .Tm Citations
771: .Tm Lists s
772: An interface is provided to existing routines that produce
773: tabular output, equations, citations, and reference lists.
774: This section describes the relevant commands.
775: .Tm Comments s
776: .Tm Comments s
777:
778: |subsection(Comments)
779: |save(comment_section)
780:
781: Comments are valuable notations by and for the person preparing a document.
782: They can be used
783: to temporarily omit a section,
784: to mark a section that needs work or information,
785: and to retain an alternative word or phrase.
786: .Tm delimiters s
787: Anything that appears within the delimiters of a |cw<|sp(|)comment>
788: is not processed as part of the document:
789: |i<monk> commands are ignored, and text does not appear in the final output.
790: .Tm Spacing s
791: .Tm Spacing s
792:
793: |subsection(Spacing)
794:
795:
796: You can start a new page or leave vertical blank space using these commands.
797:
798: |begin(table)
799: center;
800: lf5 2 l.
801: |sp(|s)new_page begins a new page
802: |sp(|s)new_column begins a new column
803: |sp(|s)blank_space leaves a blank line
804: |sp(|s)blank_space(3) leaves 3 blank lines
805: |sp(|s)blank_space(1.5i) leaves 1.5 inches
806: |sp(|s)blank_space(|sp(minus)1) moves back one line
807: |end(table)
808: .Tm Positioning Text: Indenting and Centering s
809:
810: |subsection(Positioning Text: Indenting and Centering)
811:
812: Indenting and centering are the most common ways of positioning text.
813: The input text
814:
815: |begin(cwfigure)
816: |sp(|)indent(begins a new line and indents
817: the left hand margin as long as it applies
818: for a single line, a group of lines,
819: or an entire paper.
820: |sp(|)indent<Multiple commands will
821: indent progressively.>)
822: |end(cwfigure)
823:
824: produces the following output:
825:
826: |indent(begins a new line and indents
827: the left hand margin as long as it applies
828: for a single line, a group of lines,
829: or an entire paper.
830: |indent<Multiple commands will
831: .Tm delimiters s
832: indent progressively.>)
833: |p
834: The command |cw<|sp(|)center> begins a new line and
835: centers each line of text within its delimiters.
836: The input, taken from Monty Python,
837:
838: |begin(cwfigure)
839: |sp(|)begin(center)
840: I'm a lumberjack and I'm okay,
841: I sleep all night and I work all day.
842: I cut down trees, I eat my lunch,
843: I go to the lavat'ry,
844: On Wednesdays I go shopping and have
845: buttered scones for tea.
846: |sp(|)end(center)
847: |end(cwfigure)
848:
849: produces
850:
851: |begin(figure)
852: |begin(center)
853: I'm a lumberjack and I'm okay,
854: I sleep all night and I work all day.
855: I cut down trees, I eat my lunch,
856: I go to the lavat'ry,
857: On Wednesdays I go shopping and have
858: buttered scones for tea.
859: |end(center)
860: |end(figure)
861:
862: |p
863: In contrast, the command |cw<|sp(|)center_block> centers the entire figure
864: as a block.
865: All the lines are left-justified and
866: the figure is centered based on the width of the longest line.
867: It produces
868:
869: |begin(figure)
870: |begin(center_block)
871: I'm a lumberjack and I'm okay,
872: I sleep all night and I work all day.
873: I cut down trees, I eat my lunch,
874: I go to the lavat'ry,
875: On Wednesdays I go shopping and have
876: buttered scones for tea.
877: |end(center_block)
878: |end(figure)
879:
880: |p
881: Multi-line quotations are appropriately indented and offset by the
882: command |cw<|sp(|)quotation>.
883:
884: |quotation<Four score and seven years ago our fathers brought forth
885: to this continent a new nation, conceived in liberty and dedicated to
886: .Tm Document Styles s
887: the proposition that all men are created equal.>
888:
889: |subsection(Document Styles)|save(style_section)
890:
891: By default,
892: all documents are single-spaced and single column.
893: Page width is 6 inches; length is 11 inches.
894: .Tm Spacing s
895: The font family is |i{times};
896: the font size is 10p on a vertical spacing of 12p.
897: Paragraphs skip a line and begin the text flush with the left margin.
898: |p
899: You can change any of these defaults using the |cw(|sp(|)style) command.
900: The command |cw<|sp(|)style( page_width 7i)> sets the page width to 7 inches.
901: To get the maximum page width on most output devices, type:
902: |cw<|sp(|)style(page_offset 0, page_width 8.5i)>.
903: The |cw(page_length) and |cw(font_size) can be set in a similar manner.
904: |p
905: |cw<|sp(|)style(font_size 14)> changes the default font to size 14 to print
906: out your papers for your grandparents or to prepare invitations to a party.
907: |cw(|sp(|)big) or |cw(|sp(|)small)
908: will still provide one size bigger or smaller, respectively.
909: |table_caption(The alphabet in common type families)
910: |save(The alphabet in common type families)
911: |begin(table)
912: l l l
913: lfI lfI lfI
914: lfB lfB lfB
915: l l l
916: lf2 lf2 lf2
917: lf3 lf3 lf3
918: l l l
919: lf2 lf2 lf2
920: lf3 lf3 lf3 .
921: times roman abcdefghijklm...uvwxyz
922: italics abcdefghijklm...uvwxyz
923: bold abcdefghijklm...uvwxyz
924: |style(font_family palatino)
925: palatino roman abcdefghijklm...uvwxyz
926: italics abcdefghijklm...uvwxyz
927: bold abcdefghijklm...uvwxyz
928: |style(font_family helvetica)
929: helvetica roman abcdefghijklm...uvwxyz
930: italics abcdefghijklm...uvwxyz
931: bold abcdefghijklm...uvwxyz
932: |end(table)
933: .Tm Fonts s
934: |style(font_family times)
935: |p
936: Font families provide complementary styles for each of the four fonts:
937: bold, italics, roman, and cw.
938: The standard font family is times.
939: Alternative font families include
940: palatino, helvetica, bembo, optima, souvenir, and cw,
941: but not all families are available on all output devices.
942: Some examples are shown in Table |remember(The alphabet in common type families).
943: To select helvetica, type |cw<|sp(|)style( font_family helvetica)>.
944: .Tm Spacing s
945: |p
946:
947: |style(double_space)
948:
949: |cw<|sp(|)style(double_space)> double spaces the text, while
950: |cw<|sp(|)style( single_space)> restores single spacing.
951:
952: |style(single_space)
953:
954: You can change the paragraph style throughout the rest of your document
955: by typing the command |cw<|sp(|)style(paragraph_style indented)> or
956: |cw<|sp(|)style(paragraph_style numbered)>,
957: after which the simple command |cw<|sp(|)p>
958: will produce indented or numbered paragraphs.
959: To indent or number a single paragraph,
960: use |cw<|sp(|)p(i)> or |cw<|sp(|)p(n)>, respectively.
961: To restore the original style paragraph,
962: type |cw<|sp(|)style( paragraph_style flushed)>.
963: |p
964: The command |cw<|sp(|)style(one_column)> begins formatting text in one column.
965: The command |cw<|sp(|)style(two_column)> restores two column formatting.
966: .Tm Fonts s
967:
968: |subsection(Fonts)
969:
970: |i<Monk> currently provides abbreviated commands for
971: four type faces and two type sizes.
972: |cw(|sp(|)bold) or |cw(|sp(|)b) makes the enclosed text |b(bold).
973: |cw(|sp(|)italics) or |cw(|sp(|)i) produces |italics(italicized text),
974: while |cw(|sp(|)roman) or |cw(|sp(|)r) restores the roman character set.
975: The command |cw<|sp(|)constant_width> or |cw<|sp(|)cw>
976: |cw(selects a font that resembles low quality line printer
977: output and is intended only for examples of such output).
978: .Tm Fonts s
979: |p
980: When fonts are embedded, the innermost dominates.
981: For example,
982: |cw(|sp(|)italics<Italics flourish around the |sp(|)roman[roman] text>) produces
983: |italics<Italics flourish around the |roman[roman] text>.
984: If an output device is not able to italicize, then it will underline.
985: Because italics look better, it is always preferable to request them
986: so that the document will look its best on the available printing device.
987: However, it is possible to specify underlining using |cw(|sp(|)underline) or |cw(|sp(|)u).
988: |p
989: |cw(|sp(|)big) makes the font size |big(bigger),
990: while |cw(|sp(|)small) makes the font size |small(smaller).
991: These can be nested, so that |cw<|sp(|)big(|sp(|)big(this is big))> produces
992: |big(|big(this is big)).
993: .Tm Spacing s
994: However, |cw<|sp(|)big> and |cw<|sp(|)small> are designed for in-line font changes;
995: they do not change the vertical spacing.
996: To change the size of a block of text, use the |cw<|sp(|)style> command
997: (see Section |remember(style_section)).
998: .Tm Special characters s
999: .Tm Special characters s
1000:
1001: |subsection(Special characters)
1002: |save(special_section)
1003:
1004: |i<Monk> provides a long list of special characters, the appearance of which
1005: is ultimately determined by the output device.
1006: .Tm Letters s
1007: .Tm Mathematical Symbols s
1008:
1009: With the command |cw<|sp(|)sp>,
1010: the user can print out the |i<monk> command character |cw(|sp(|s)),
1011: Greek letters, and mathematical symbols.
1012: |p
1013: Here is a partial list of the fancy symbols
1014: that appear in Appendix |remember(special_appendix):
1015: |sp{/} |sp{minus} |sp{\}
1016: |sp{.} |sp{degree} |sp{bullet}
1017: |sp{copyright} |sp{registered} |sp{TM}
1018: |sp{|} |sp{bold vertical}
1019: |sp{dagger} |sp{section}
1020: |sp{rhand} |sp{lhand}
1021: |sp{hyphen} |sp{underrule}
1022: |sp{open quote} |sp{close quote}
1023: |sp{grave} |sp{cedilla} |sp{lower case umlaut} |sp{upper case umlaut}
1024: |sp{alpha} |sp{beta} |sp{gamma} |sp{delta} |sp{epsilon}
1025: |sp{+-} |sp{>=} |sp{<=} |sp{!=} |sp{-wig} |sp{wig}
1026: |sp{times} |sp{divide} |sp{prop}
1027: |sp{integral} |sp{partial}
1028: |sp{not} |sp{or} |sp{rceil}
1029: |sp{square} |sp{del} |sp{empty} |sp{member}
1030: |sp{isuperset} |sp{cap}
1031: |sp{->} |sp{uarrow} |sp{darrow}
1032: |sp{cent} |sp{quarter} |sp{3quarter}
1033: |sp{mu} |sp{nu} |sp{xi} |sp{omicron}
1034: |sp{pi} |sp{ff} |sp{ffi} |sp{ffl} |sp{TEX} |sp{LATEX}.
1035: .Tm Spacing s
1036: |p
1037: |cw<|sp(|)sp> can also be used to control spacing and carriage movement
1038: precisely.
1039: There are spaces of five different widths,
1040: shown below opposite the commands that produce them.
1041:
1042: |comment[|begin(verbatim)
1043: |cw<|sp(|)sp{zero width space}> `|sp{zero width space}'
1044: ]
1045: |begin(cwfigure)
1046: .ta 1.6i
1047: |sp(|)sp{space} |r<|big<|big<`|sp{space}'>>>
1048: |sp(|)sp{digit space} |r<|big<|big<`|sp{digit space}'>>>
1049: |sp(|)sp{narrow space} |r<|big<|big<`|sp{narrow space}'>>>
1050: |sp(|)sp{half narrow space} |r<|big<|big<`|sp{half narrow space}'>>>
1051: |sp(|)sp{zero width space} |r<|big<|big<`|sp{zero width space}'>>>
1052: .ta
1053: |end(cwfigure)
1054:
1055: |p
1056:
1057: |style(double_space)
1058:
1059: The carriage can be moved up and down:
1060: |cw<|sp(|)sp{up}> moves |sp{up}up,|sp{down}
1061: while |cw<|sp(|)sp{reverse}> moves
1062: |sp{reverse}up|sp{down}|sp{down}by twice as much.
1063: The command |cw<|sp(|)sp{down}> moves |sp{down}down.|sp{up}
1064:
1065: |style(single_space)
1066:
1067: |p
1068: |cw<|sp(|)sp{break and spread}> pads the current line according to the document
1069: style and breaks to the next line.
1070: .Tm hyphenation s
1071: To force hyphenation at a particular position in a word, use
1072: |cw<|sp(|)sp{hyphenation}>.
1073: |cw<|sp(|)sp{tab}> generates horizontal motion to the next tab stop;
1074: |cw<|sp(|)sp{leader}> generates a string of periods to the next tab stop.
1075: .Tm Headings s
1076: .Tm Section headings s
1077: .Tm Headings s
1078:
1079: |subsection(Headings)
1080:
1081: |comment<|subsection(Section headings)>
1082:
1083: |subsubsection(Numbered headings.)
1084:
1085: |cw<|sp(|)chapter> starts a new page; leaves a blank space;
1086: puts ``Chapter |i<n>'' against the right hand margin;
1087: skips more space;
1088: puts the title against the right hand margin;
1089: and skips more space before beginning the text body.
1090: No chapters appear in this document.
1091: .Tm Content Formatting Commands s
1092: .Tm Headings s
1093: .Tm Headings s
1094: The commands
1095: to declare the current section, subsection, and subsubsection include:
1096:
1097: |begin(cwfigure)
1098: |sp(|)section(Content Formatting Commands)
1099: |sp(|)subsection(Headings)
1100: .Tm List of Commands s
1101: |sp(|)subsubsection(Numbered headings.)
1102: |end(cwfigure)
1103:
1104: The first appendix at the end was produced by
1105: |cw<|sp(|)appendix(List of Commands)>.
1106: |paragraph(numbered)
1107: This numbered paragraph is produced by the command
1108: |cw<|sp(|)paragraph(numbered)>,
1109: which may be abbreviated as |cw<|sp(|)paragraph(n)> or |cw<|sp(|)p(n)>.
1110: .Tm Unnumbered headings s
1111:
1112: .Tm Unnumbered headings s
1113: .Tm Spacing s
1114: |subsubsection(Unnumbered headings.)
1115:
1116: The analogous unnumbered headings produce the same spacing but omit
1117: heading names, e.g. chapter, and numerical labels.
1118: Chapter titles remain right justified,
1119: and appendix titles are still centered;
1120: but the various section titles are now flush with the left margin.
1121: |cw<|sp(|)unnumbered_chapter> is useful for preface and acknowledgement
1122: pages.
1123: Available commands include:
1124:
1125: |begin(cwfigure)
1126: |sp(|)unnumbered_chapter(Preface)
1127: |sp(|)unnumbered_section(|small[SECTION])
1128: |sp(|)unnumbered_subsection(Subsection)
1129: |sp(|)unnumbered_subsubsection(Subsubsection.)
1130: |sp(|)unnumbered_appendix(|small[APPENDIX])
1131: |end(cwfigure)
1132:
1133: |p(f)
1134: There are flushed and indented unnumbered paragraphs.
1135: The indented paragraphs are used throughout this paper,
1136: except for this paragraph,
1137: which is produced using the command |cw<|sp(|)p(f)>.
1138: .Tm Spacing s
1139: The commands to skip a line and begin the text flush with the left margin
1140: include:
1141:
1142: |begin(cwfigure)
1143: |sp(|)paragraph(f)
1144: |sp(|)p(f)
1145: |sp(|)paragraph(flushed)
1146: |sp(|)p(flushed)
1147: |end(cwfigure)
1148:
1149: The commands to indent the first line of the paragraph and
1150: produce spacing identical to the flushed paragraph include:
1151:
1152: |begin(cwfigure)
1153: |sp(|)paragraph(i)
1154: |sp(|)p(i)
1155: |sp(|)paragraph(indented)
1156: |sp(|)p(indented)
1157: |end(cwfigure)
1158: |blank_space(-1)
1159:
1160: |subsubsection(Paragraphs.)
1161:
1162: The command |cw(|sp(|)paragraph) or its abbreviation |cw(|sp(|)p)
1163: is used throughout this paper to produce the default paragraph style.
1164: In this paper the normal default,
1165: |cw(flushed), was changed through use of the |cw<|sp(|)style> command to |cw(indented)
1166: (see Section |remember(style_section)).
1167: .Tm Setting page, heading and figure numbers s
1168:
1169: |subsection(Setting page, heading and figure numbers)
1170:
1171: Page, heading, figure, and table numbers can be changed by the authors.
1172: |index(set page numbers)|index(page numbers)
1173: |index(section numbers)|index(section counters)
1174: Set the current page counter to three using
1175: the command |cw<|sp(|)set_counter(page 3)>.
1176: At the next page boundary the page number will be incremented to four.
1177: The command |cw<|sp(|)set_counter( table 12)>
1178: sets the current table number to 12.
1179: Multiple counters can be set with a single command:
1180: |cw<|sp(|)set_counter(page 10, chapter 4, section 3, subsection 1)>.
1181: Available commands include:
1182:
1183: |begin(cwfigure)
1184: |sp(|)set_counter(page 3)
1185: |sp(|)set_counter(chapter 4)
1186: |sp(|)set_counter(section 1)
1187: |sp(|)set_counter(subsection 9)
1188: |sp(|)set_counter(subsubsection 3)
1189: |sp(|)set_counter(paragraph 0)
1190: |sp(|)set_counter(appendix 3)
1191: |sp(|)set_counter(footnote 17)
1192: |sp(|)set_counter(note 122)
1193: |sp(|)set_counter(figure 8)
1194: |sp(|)set_counter(table 0)
1195: |end(cwfigure)
1196:
1197: |p
1198: Care must be taken in positioning all these commands:
1199: if you want to change a section number, then you must position the
1200: |cw<|sp(|)set_counter> command before the section itself
1201: so that the numbered title will be correct.
1202: To number the next section four, you must type
1203: |cw<|sp(|)set_counter(section 3)> before the |cw<|sp(|)section> command,
1204: because the section number will be incremented
1205: when the |cw<|sp(|)section> command itself is read.
1206: Similarly,
1207: if you want the page number in headers and footers to display a new value,
1208: then the value must be changed before the break to the new page occurs.
1209: To set the next page to page number three,
1210: the command |cw<|sp(|)set_counter(page 2)> must appear on the current page.
1211: |p
1212: Once a value is set, the computer will use that number and increment it
1213: appropriately; but if it is set wrong, it will remain wrong.
1214: If you change counters, you are responsible for
1215: insuring consistency and correctness.
1216: .Tm Setting page headers and footers s
1217:
1218: |subsection(Setting page headers and footers)
1219:
1220: Both page headers and footers can be set using the |cw<|sp(|)set_string> command
1221: as follows:
1222:
1223: |begin(cwfigure)
1224: |sp(|)set_string(page_headers "'left'center'right'")
1225: |sp(|)set_string(even_headers "'left'center'right'")
1226: |sp(|)set_string(odd_headers "'left'center'right'")
1227: |sp(|)set_string(page_footers "'left'center'right'")
1228: |sp(|)set_string(even_footers "'left'center'right'")
1229: |sp(|)set_string(odd_footers "'left'center'right'")
1230: |end(cwfigure)
1231:
1232: |cw<Page_headers>, |cw<even_headers>, and |cw<odd_headers> set the headers
1233: on all pages, even pages, and odd pages, respectively.
1234: |index(headers)|index(page headers)
1235: Page headers appear above the even and odd headers.
1236: .Tm Strings s
1237: All headers consist of three strings, any of which may be blank or long
1238: enough to overlap.
1239: .Tm Strings s
1240: Any character, can be used to delimit the strings.
1241: .Tm Strings s
1242: The strings |i(left), |i(center), and |i(right) are left-justified, centered,
1243: and right-justified, respectively.
1244: Parallel commands serve
1245: .Tm Lists s
1246: .Tm Lists s
1247: .Tm Letters s
1248: to specify page footers.|index(footers)|index(page footers)
1249:
1250: |comment<|subsection(Grouping text - Displays)>
1251:
1252: |subsection(Lists)
1253:
1254: There are nine types of lists, which differ only in the labeling of list items:
1255:
1256: |begin(cwfigure)
1257: |sp(|)number_list
1258: |sp(|)A_list
1259: |sp(|)a_list
1260: |sp(|)I_list
1261: |sp(|)i_list
1262: |sp(|)p_number_list
1263: |sp(|)p_a_list
1264: |sp(|)dash_list
1265: |sp(|)bullet_list
1266: |end(cwfigure)
1267:
1268: A simple numbered list is created by the following commands:
1269:
1270: |begin(cwfigure)
1271: |sp(|)begin(number_list)
1272: |sp(|)item first item
1273: |sp(|)item second item is on two lines in the
1274: input, but will be filled in the output
1275: |sp(|)item third
1276: |sp(|)end(number_list)
1277: |end(cwfigure)
1278:
1279: |p
1280: |cw<|sp(|)A_list> items are marked with capital letters;
1281: |cw<|sp(|)a_list> with lower-case letters followed by '|cw<)>'.
1282: |cw<|sp(|)I_list> items are marked with upper-case roman numerals;
1283: |cw<|sp(|)i_list> with lower-case roman numerals followed by '|cw<)>'.
1284: Number and lower-case letter labels are enclosed in parentheses in
1285: |cw<|sp(|)p_number_list> and |cw<|sp(|)p_a_list>, respectively.
1286: Bullets or dashes label the items in a |cw<|sp(|)bullet_list>
1287: or a |cw<|sp(|)dash_list>, respectively.
1288: .Tm Lists s
1289: .Tm Lists s
1290: .Tm Lists s
1291: |p
1292: Multi-level lists of up to six levels can be built by putting lists inside
1293: lists.
1294: A standard outline format of six levels consists of an outer |cw<|sp(|)I_list>,
1295: an |cw<|sp(|)A_list>, a |cw<|sp(|)number_list>, an |cw<|sp(|)a_list>,
1296: an inner |cw<|sp(|)number_list>, and a |cw<|sp(|)p_a_list>.
1297: The following produces, in outline format, a description of two kingdoms.
1298: .Tm Inserting other files s
1299:
1300: |begin(cwfigure)
1301: |sp(|)begin(I_list)
1302: |sp(|)item Animal Kingdom
1303: |sp(|)begin(A_list)
1304: |sp(|)item Arthropods
1305: |sp(|)begin(number_list)
1306: |sp(|)item Trilobites
1307: |sp(|)item Insects
1308: |sp(|)end(number_list)
1309: |sp(|)item Chordates
1310: |sp(|)begin(number_list)
1311: |sp(|)item Vertebrates
1312: |sp(|)begin(a_list)
1313: |sp(|)item Birds
1314: |sp(|)item Reptiles
1315: |sp(|)item Mammals
1316: |sp(|)begin(number_list)
1317: |sp(|)item Marsupials
1318: |sp(|)item Monotremes
1319: |sp(|)begin(p_a_list)
1320: |sp(|)item platypus
1321: |sp(|)item echidna
1322: |sp(|)end(p_a_list)
1323: |sp(|)item Placental mammals
1324: |sp(|)begin(p_a_list)
1325: |sp(|)item Cetacea
1326: |sp(|)item Primates
1327: |sp(|)end(p_a_list)
1328: |sp(|)end(number_list)
1329: |sp(|)end(a_list)
1330: |sp(|)item Notocords
1331: |sp(|)end(number_list)
1332: |sp(|)item Mollusks
1333: |sp(|)end(A_list)
1334: |sp(|)item Plant Kingdom
1335: |sp(|)end(I_list)
1336: |end(cwfigure)
1337:
1338: |begin(I_list)
1339: |item Animal Kingdom
1340: |begin(A_list)
1341: |item Arthropods
1342: |begin(number_list)
1343: |item Trilobites
1344: |item Insects
1345: |end(number_list)
1346: |item Chordates
1347: |begin(number_list)
1348: |item Vertebrates
1349: |begin(a_list)
1350: |item Birds
1351: |item Reptiles
1352: |item Mammals
1353: |begin(number_list)
1354: |item Marsupials
1355: |item Monotremes
1356: |begin(p_a_list)
1357: |item platypus
1358: |item echidna
1359: |end(p_a_list)
1360: |item Placental mammals
1361: |begin(p_a_list)
1362: |item Cetacea
1363: |item Primates
1364: |end(p_a_list)
1365: |end(number_list)
1366: |end(a_list)
1367: |item Notocords
1368: |end(number_list)
1369: |item Mollusks
1370: |end(A_list)
1371: |item Plant Kingdom
1372: |end(I_list)
1373:
1374: |subsection(Inserting other files)
1375:
1376: Other files may be inserted using the command |cw<|sp(|)insert>.|index(insert)
1377: These files will also be processed by |i<monk> and
1378: may in turn insert other files.
1379: Loops will indeed cause disaster.
1380: A file that will not be processed may also be included
1381: .Tm Figures
1382: using the |cw<|sp(|)source> command.|index(source)
1383:
1384: |subsection(Figures)
1385:
1386: The lumberjack poem above was formatted as a figure.
1387: .Tm Figures
1388: Figures are printed with blank space above and below and can be split
1389: across a page boundary.
1390: Lines are not filled.
1391: .Tm delimiters s
1392: If you want some lines to be filled, put them within the delimiters of the
1393: command |cw<|sp(|)text>.
1394: |cw<|sp(|)figure_caption> centers and labels the caption.
1395: Given
1396:
1397: |begin(cwfigure)
1398: |sp(|)begin(figure)
1399: Like the lumberjack poem above,
1400: this text is within a |sp(|)cw<|sp(|)sp(|sp(|))figure>
1401: command.
1402: |sp(|)end(figure)
1403: |sp(|)figure_caption(This is a figure caption).
1404: |end(cwfigure)
1405:
1406: |i<monk> produces
1407:
1408: |begin(here)
1409: |begin(figure)
1410: Like the lumberjack poem above,
1411: this text is within a |cw<|sp(|)figure>
1412: command.
1413: |end(figure)
1414: .Tm Spacing s
1415: |figure_caption(This is a figure caption)
1416: |end(here)
1417:
1418: |p
1419: To create a non-filled display without spacing above and below, use the
1420: command |cw<|sp(|)verbatim>.
1421: To indent either a figure or a verbatim display,
1422: simply enclose it within an |cw<|sp(|)indent> command:
1423:
1424: |begin(cwfigure)
1425: |sp(|)begin(here)
1426: |sp(|)begin(indent)
1427: |sp(|)begin(figure)
1428: This is a short figure
1429: |sp(|)end(figure)
1430: |sp(|)end(indent)
1431: |sp(|)figure_caption(with a short caption)
1432: |sp(|)end(here)
1433: |end(cwfigure)
1434:
1435: The command |cw<|sp(|)indent> can appear either inside or around the
1436: |cw<|sp(|)figure> command.
1437: However, because the caption is centered, it should not be indented.
1438: .Tm delimiters s
1439: |p
1440: The |cw<|sp(|)here> command keeps all the text within its delimiters
1441: together on one page.
1442: .Tm delimiters s
1443: It is important to include both the figure proper and its caption within
1444: the delimiters so that the caption is never orphaned.
1445: If there is not enough room on the current page, |cw<|sp(|)here>
1446: leaves the rest of the
1447: page blank and skips to the next page or next column to print the block.
1448: .Tm Comments s
1449: It is useful after comments such as ``An example follows:'',
1450: because it guarantees the relative position of the comment and the block.
1451: |p
1452: Another command, |cw<|sp(|)around>, also keeps the enclosed text together.
1453: If it cannot print the block on the current page, however, it continues
1454: printing text, postponing the block until there is enough room for it.
1455: Usually the block will be positioned at the top of the next page;
1456: however, if there are multiple large floating blocks that cannot fit together
1457: on that page, then they will appear in order as soon as possible.
1458: You can use the command |cw<|sp(|)around_placement> to force all outstanding
1459: blocks to be printed at the end of a section or chapter.
1460: .Tm equations
1461: .Tm |i<eqn> C
1462: .Tm equations
1463:
1464: |subsection(Equations)
1465:
1466: |i<Monk> uses |i<eqn>|reference<latest eqn> to format equations.
1467: The |i<monk> command |cw<|sp(|)equation> delimits an equation offset from the text.
1468: Note that |i<monk> commands may appear within the line;
1469: they do not need to be at the beginning of a line.
1470:
1471: |begin(cwfigure)
1472: |sp(|)begin(center)
1473: |sp(|)equation_number[(1a)]
1474: |sp(|)begin(equation)x = 2 pi int
1475: sin ( omega t ) dt
1476: |sp(|)end(equation)
1477: |sp(|)end(center)
1478: |end(cwfigure)
1479:
1480: When formatted the above input produces:
1481:
1482: |begin(center)
1483: |equation_number[(1a)]
1484: |begin(equation)x = 2 pi int
1485: sin ( omega t ) dt
1486: |end(equation)
1487: |end(center)
1488: |blank_space(-1)
1489:
1490: The same output is produced by the short |i<monk> form:
1491: |cw<|sp(|)equation[x = 2 pi int sin ( omega t ) dt]>.
1492: Captions are specified using |cw<|sp(|)equation_caption>.
1493: |p
1494: The equation itself
1495: is explained on page 2 of the Kernighan and Cherry memo.|footnote{Remember
1496: that the |i<monk> command |cw<|sp(|)equation(...)> replaces all
1497: instances of |cw<.EQ> and |cw<.EN> and that |cw<|sp(|)e(...)> replaces the
1498: .Tm delimiters s
1499: .Tm equations
1500: .Tm equations
1501: |cw<$...$> delimiters for in-line equations.}
1502: To write in-line equations,
1503: delimit the equation using |cw<|sp(|)e>.
1504: The input |cw{|sp(|)e<x = 2 pi int sin ( omega t ) dt>}
1505: produces the equation |e<x = 2 pi int sin ( omega t ) dt>
1506: without offsetting it.
1507: .Tm tables
1508: .Tm tables
1509: .Tm tbl C
1510: .Tm tbl C
1511:
1512: |subsection(Tables)
1513: |save(table_example)
1514:
1515: |i<Monk> does not provide any new capabilities for formatting tables;
1516: it uses |i(tbl)|reference(latest tbl).
1517: .Tm tbl C
1518: It provides |i<monk>-style commands for positioning both the table and its caption
1519: and automatically invokes the standard |i(tbl) formatting program.
1520: The following input formats the table in the file |i(examples/example.table),
1521: which appears as Appendix |remember(table_appendix).|footnote{The
1522: formatting commands |cw<.TS> and |cw<.TE>
1523: need to be omitted from the sample file.}
1524: The table could be typed into the file directly; here it is put into another
1525: file just to simplify and condense the |i<monk> example.
1526:
1527: |begin(cwfigure)
1528: |sp(|)begin(here)
1529: |sp(|)table_caption(Example of table)
1530: |sp(|)begin(table)
1531: |sp(|)insert(examples/example.table)
1532: |sp(|)end(table)
1533: |sp(|)end(here)
1534: |end(cwfigure)
1535:
1536: |p
1537: The command |cw<|sp(|)here> guarantees that the caption will not be separated
1538: from the table if it happens to hit a page boundary.
1539: The remainder of the page would be blank,
1540: and the table with caption would be printed on the next page
1541: or in the next column for multi-column documents.
1542: .Tm tbl C
1543: Together |i<monk> and |i<tbl> produce
1544:
1545: |begin(here)
1546: \!.sp -1
1547: |table_caption(Example of table)
1548: |begin(table)
1549: |comment<inserting examples/example.table starting here>
1550: box;
1551: c1 s1 s
1552: c1 | c1 | c
1553: l1 | l1 | n.
1554: Major New York Bridges
1555: =
1556: Bridge Designer Length
1557: _
1558: Brooklyn J. A. Roebling 1595
1559: Manhattan G. Lindenthal 1470
1560: Williamsburg L. L. Buck 1600
1561: _
1562: Queensborough Palmer & 1182
1563: Hornbostel
1564: _
1565: 1380
1566: Triborough O. H. Ammann _
1567: 383
1568: _
1569: Bronx Whitestone O. H. Ammann 2300
1570: Throgs Neck O. H. Ammann 1800
1571: _
1572: George Washington O. H. Ammann 3500
1573: |comment<inserting examples/example.table ending here>
1574: |end(table)
1575: |end(here)
1576:
1577: |p
1578: If you have a 5620 or a 630MTG terminal,
1579: the interactive table editor |i<vtbl>
1580: .Tm tables
1581: .Tm tbl C
1582: can be used to prepare |i<tbl> input.|reference(Murrel bitmaps build tables)
1583: Both the table structure and its text contents can be edited using |i<vtbl>.
1584: .Tm Figures
1585:
1586: |subsection(Computer Output)
1587:
1588: The command |cw<|sp(|)computeroutput> produces a figure using a constant width
1589: type that resembles low quality line printer output.
1590:
1591: |begin(computeroutput)
1592: Program: SINDSCAL-symmetric indscal
1593:
1594: ***********************************
1595: parameters
1596: dim irdata itmax irn
1597: 2 2 200 9342
1598: no. of matrices=5 no. of stim.=9
1599: ***********************************
1600:
1601: correlations vaf loss
1602: y(data)&yhat (r**2) (y-yhat)**2
1603: .161169 .025975 .974025
1604: .Tm Computer Output s
1605: .Tm Computer Output s
1606: .650655 .423352 .605140
1607: |end(computeroutput)
1608: |blank_space(-2)
1609: |computeroutput_caption(Example of computer output)
1610:
1611: |cw<|sp(|)computeroutput_caption (Example of computer output)>
1612: provides the associated caption.
1613: Currently these captions are the same as figure captions.
1614: .Tm pictures
1615: .Tm |i<pic> C
1616: .Tm typesetting g
1617:
1618: |subsection(Pictures)
1619: |save(picture_example)
1620:
1621: |i<Monk> commands also provide access to |i<pic>, a graphics language for
1622: typesetting.|reference[latest pic]
1623: Borrowing an example from the |i<PIC User Manual>,|footnote{Remember
1624: that the |i<monk> command |cw<|sp(|)picture(...)> replaces all
1625: instances of |cw<PS> and |cw<PE>.}
1626: the |i<monk> input
1627:
1628: |begin(cwfigure)
1629: |sp(|)begin(here)
1630: |sp(|)begin(picture)
1631: |sp(|)insert(examples/example.pic1)
1632: |sp(|)end(picture)
1633: |sp(|)picture_caption(Example of picture)
1634: |sp(|)end(here)
1635: |end(cwfigure)
1636:
1637: produces
1638: .Tm |i<pic> C
1639:
1640: |begin(picture)
1641: |comment<inserting examples/example.pic1 starting here>
1642: A: ellipse
1643: ellipse ht .2 wid .3 with .se at 1st ellipse.nw
1644: ellipse ht .2 wid .3 with .sw at 1st ellipse.ne
1645: circle rad .05 at 0.5 <A.nw,A.c>
1646: circle rad .05 at 0.5 <A.ne,A.c>
1647: arc from 0.25 <A.w,A.e> to 0.75 <A.w,A.e>
1648: |comment<inserting examples/example.pic1 ending here>
1649: |end(picture)
1650: |picture_caption(Example of picture)
1651:
1652: |p
1653: If you have a 5620 or a 630MTG terminal,
1654: the interactive drawing program |i<cip>
1655: can be used to prepare |i<pic> input.|reference(latest cip)
1656: |p
1657: Another example from Kernighan's |i<PIC Revised User Manual> illustrates
1658: .Tm delimiters s
1659: the use of an in-line equation embedded in a picture.|footnote{In
1660: this example, the equation within the delimiters must be placed within the
1661: .Tm Strings s
1662: .Tm Strings s
1663: |cw<|sp(|)e> command.}
1664:
1665: |comment<box "|sp(|s)e[space 0 {H( omega )} over {1 - H( omega )}]">
1666:
1667: |begin(cwfigure)
1668: |sp(|)begin(here)
1669: |sp(|)begin(picture)
1670: arrow
1671: box "|sp(|)e[{H( omega )} over {1 - H( omega )}]"
1672: arrow
1673: |sp(|)end(picture)
1674: |sp(|)picture_caption(Picture with equation)
1675: |sp(|)end(here)
1676: |end(cwfigure)
1677:
1678: produces the following beauty
1679:
1680: |begin(here)
1681: |begin(picture)
1682: arrow
1683: box "|e[{H( omega )} over {1 - H( omega )}]"
1684: arrow
1685: |end(picture)
1686: |picture_caption(Picture with equation)
1687: |end(here)
1688:
1689:
1690: |subsection(Footnotes)
1691:
1692: A numbered footnote is generated by the command |cw[|sp(|)footnote] appended to
1693: .Tm Footnotes
1694: the running text.|footnote(This is a numbered footnote)
1695: The text |cw<|sp(|)footnote(This is yet another numbered footnote)>
1696: produces
1697: .Tm Footnotes
1698: .Tm Footnotes
1699: numbered footnotes.|footnote(This is yet another numbered footnote)
1700: Analogously, |cw<|sp(|)dagnote> and |cw<|sp(|)starnote> produce
1701: daggered footnotes|dagnote(This is a daggered footnote)
1702: and starred footnotes.|starnote(This is a starred footnote)
1703: Footnote types can be mixed, as in this section.
1704: .Tm Citations
1705: .Tm cite G
1706: .Tm Citations
1707:
1708: |subsection(Citations)
1709: |save(save_section)
1710:
1711: |i<Monk> uses the program |i<cite> to handle citations.
1712: The command |cw<|sp(|)save(tag)>
1713: remembers the last important numbered item as the label
1714: |i[tag].
1715: It saves the number of the last figure, picture, equation, table,
1716: section, subsection, subsubsection or appendix.
1717: At this point the command |cw<|sp(|)save(this_section)> stores
1718: the number of the current subsection as |cw(this_section).
1719: |save(this_section)
1720: The |i(monk) command |cw<|sp(|)remember(this_section)> is replaced by
1721: that stored value wherever it appears in the text:
1722: |cw[This section is |sp(|)remember(this_section)] appears in the
1723: final output as This section is |remember(this_section).
1724: It is crucial to understand that |cw[|sp(|)save] stores the most recent
1725: counter, whatever its type.
1726: If a numbered figure appears between the section header and the |cw[|sp(|)save]
1727: command, then the number saved will be that figure number.
1728: The tag name itself has no particular meaning.
1729: Position is what counts.
1730: |p
1731: Page numbers can be saved using the command |cw<|sp(|)savepage.>
1732: |cw<|sp(|)savepage(tag)> saves the current page number as
1733: the label |cw[tag].
1734: Again, |cw<|sp(|)remember(tag)> substitutes the number
1735: associated with |cw[tag].
1736: The text
1737: |cw<the current page is |sp(|)savepage(foobar) |sp(|)remember(foobar)>
1738: generates |cw<the current page is |savepage(foobar)|remember(foobar)>.
1739: .Tm Citations
1740: |p
1741: If all citations are saved before they are used, then the user need
1742: only enter the commands shown above in the |i<monk> input text.
1743: If, however, the input uses a citation before it really is saved,
1744: as in the example below, then there is more to do.
1745:
1746: |begin(cwfigure)
1747: All commands are listed in appendix
1748: |sp(|)remember(appendix_commands).
1749: .Tm List of Commands s
1750: .Tm cite G
1751: |sp(zero width space)|b(...)
1752: |sp(|)appendix(|s(LIST OF COMMANDS))
1753: |sp(|)save(appendix_commands)
1754: |end(cwfigure)
1755:
1756: Forward referencing depends on a file named |cw<.cite>,
1757: which is generated each time the input is formatted.
1758: .Tm cite G
1759: .Tm cite G
1760: .Tm cite G
1761: .Tm Citations
1762: The |small<UNIX> command
1763:
1764: |begin(figure)
1765: |cw(cite |sp(minus)s .cite > myfile.cite)
1766: |end(figure)
1767:
1768: reports any redefinitions or unused definitions and produces a consistent
1769: set of citations.
1770: .Tm cite G
1771: The output file |cw<myfile.cite> needs to be inserted in the |i<monk> input
1772: before the first citation.
1773: .Tm cite G
1774: Do so using the command |cw<|sp(|)insert(myfile.cite)>.
1775:
1776: |comment[
1777: |subsection(Creating an Index)
1778: You can specify keywords to be inserted in an index using |cw(|sp(|)index):
1779: |cw<|sp(|)index(these words)>.
1780: The keywords |i<these words> will appear in the index with the current page
1781: number.]
1782: ........
1783: .Tm References s
1784: .Tm References s
1785:
1786: |subsection(References)
1787:
1788: |i<Monk> uses |i<prefer> to extract references from a
1789: bibliographic database.|reference<Derr Prefer>
1790: To use |i<prefer> capabilities with |i<monk>,
1791: there are only two additional things you need to know.
1792: First, the |cw<|sp(|)reference> command passes a partial reference to
1793: |i<prefer>, as in:
1794: |cw<|sp(|)|sp(zero width space)reference( Derr Prefer)>.
1795: When this command is used, |i<monk> will automatically invoke |i<prefer>.
1796: .Tm Advanced Monk s
1797: .Tm Preparing a large document s
1798: .Tm References s
1799: Second, the |cw<|sp(minus)R> option to |i<monk> serves to specify
1800: a local or private bibliography file:
1801:
1802: |begin(cwfigure)
1803: monk |sp(minus)Sproof |sp(minus)R bibliofile myfile
1804: |end(cwfigure)
1805:
1806: |section(Advanced Monk)
1807:
1808: |subsection(Preparing a large document)
1809:
1810: When working on large documents,
1811: it is important to be able to run off parts of the document separately,
1812: while maintaining correct numbering and references to other parts of the document.
1813: You can do this with |i<monk> by dividing the document into several files
1814: and identifying each file appropriately.
1815: |p
1816: The top-level file should contain all style information
1817: and include the various segments.
1818: For a book with three chapters, the parent file |cw<myfile> might look like:
1819:
1820: |begin(cwfigure)
1821: |sp(|)make(kluwer)
1822: |sp(|)style(page_width 7i)
1823: |sp(|)insert(chapter1)
1824: |sp(|)insert(chapter2)
1825: |sp(|)insert(chapter3)
1826: |end(cwfigure)
1827:
1828: The first line of each chapter file should identify it as a part
1829: of |cw<myfile>: |cw<|sp(|)part(myfile)>.
1830: |p
1831: When you run off the entire document, |i<monk> will remember the assorted
1832: section, display, and page numbers.
1833:
1834: |comment{as well as information you save using
1835: |cw<|sp(|)save> or |cw<|sp(|)savepage>.}
1836:
1837: These numbers will then be used when you run off individual parts.
1838: Note that the numbers should always be reasonable approximations, but may
1839: not always be correct.
1840: When several sections are changing simultaneously, you will need to
1841: generate the entire document periodically to guarantee that all numbers
1842: are exact.
1843:
1844: |comment{
1845: |section(Error messages)
1846: The following are the error messages currently given by monk:
1847: |begin(figure)
1848: |begin(cw)
1849: usage: monk [-d database_dir -n ] filename; no option g
1850: fiugre is not a monk command: use ``|sp(|)sp(|sp(|))'' to put `|sp(|)' in text
1851: Expecting end for figure begun at line 112; got end for table
1852: No end for figure begun at line 112
1853: Unexpected end for figure
1854: Mismatched delimiters around figure; expecting >, got EOF
1855: Mismatched delimiters around figure; expecting >, got ]
1856: |end(cw)
1857: |end(figure)}
1858: ......
1859: .Tm Modifying the standard formats s
1860:
1861: |subsection(Modifying the standard formats)
1862:
1863: You can redefine existing |i<monk> commands,
1864: such as |cw<|sp(|)ret_address> and |cw<|sp(|)p>,
1865: and you can create new document types using the standard
1866: |i<monk> database language.
1867: An early description of the database language is available,|reference{monk
1868: database}
1869: but there is no up-to-date guide.
1870: When the dust has settled,
1871: a new manual will be written.
1872: Currently, any augmentations you write should be considered temporary.
1873:
1874: |comment{
1875: When you change an existing |i<monk> command, the message
1876: ``|cw<file line_number: Redefining definition_name>''
1877: will be printed, where |i<file> and |i<line_number> identify where the
1878: redefinition of |i<definition_name> was encountered.
1879: A definition can appear anywhere in user text, but must precede its first usage.
1880: We recommend maintaining separate files of definitions, rather than including
1881: them in-line with your text.
1882: The definition file can be typed on your command line,
1883: |cw<monk definition_file text_file>, or
1884: included in your text file after the |cw<|sp(|)make> command,
1885: |cw<|sp(|)insert(definition_file)>.
1886: If you change a definition in the middle of a document,
1887: all instances before the redefinition will use the original,
1888: all later instances the new.
1889: |p
1890: Certain words are reserved as internal database commands and
1891: cannot be redefined:
1892: |cw<associate>, |cw<attribute>, |cw<begin>, |cw<comment>, |cw<define>, |cw<end>,
1893: |cw<environment>, |cw<for>, |cw<if>, |cw<else>, |cw<ifvalue>, |cw<insert>,
1894: F|cw<macro>, |cw<part>, and |cw<source>.}
1895:
1896: |p
1897: You can also cheat by adding commands in the underlying
1898: formatting language;|reference<troff latest reference>|reference<troff tutorial latest>
1899: this method may offer quick fixes,
1900: but there is a possibility of conflict with the |i<monk> program.
1901: .Tm Fonts s
1902: |i<Monk> expends considerable effort managing the state of
1903: various attributes such as fonts and indentation level.
1904: Therefore, if you change things without |i<monk>'s knowledge
1905: by using |i<troff> directly,
1906: |i<monk> may well undo your changes
1907: in the normal course of processing its own input commands.
1908: .Tm Other related programs s
1909: .Tm demonk G
1910: .Tm monkmerge G
1911:
1912: |subsection(Other related programs)
1913:
1914: There are three other programs useful to |i(monk) users:
1915: |i(demonk) is the moral equivalent of |i(deroff),
1916: |i(monkmerge) is the functional equivalent of |i(soelim),
1917: and |i(monkspell) is the |i(spell) preprocessor.
1918: These tools are helpful when processing |i(monk) files using other
1919: programs, such as indexing tools.
1920: .Tm List of Commands s
1921:
1922: |reference_placement
1923:
1924: |new_page
1925: .ad l
1926: |appendix(List of Commands)
1927:
1928:
1929: |environment(section;
1930: divert.string Ts;
1931:
1932: minimum.lines 2v, protect, incr S0,
1933: clear S1 S2 S3,
1934: font bold,
1935: |ifvalue sectioning bychapter [
1936: number CH, text ".",
1937: ]
1938: |ifvalue sectioning byappendix [
1939: number AC, text ".",
1940: ]
1941: number S0,
1942: |ifvalue sectioning bysection [
1943: text ".",
1944: ]
1945: text " ", string Ts, font roman,
1946: paragraph,
1947: clear string Rs,
1948: |ifvalue sectioning bychapter [
1949: store string.from.number Rs CH,
1950: add string Rs ".",
1951: ]
1952: |ifvalue sectioning byappendix [
1953: store string.from.number Rs AC,
1954: add string Rs ".",
1955: ]
1956: add string.from.number Rs S0,
1957: |ifvalue sectioning bysection [
1958: contents section 1 Rs Ts,
1959: ]
1960: |ifvalue sectioning bychapter [
1961: contents section 2 Rs Ts,
1962: ]
1963: |ifvalue sectioning byappendix [
1964: contents section 2 Rs Ts,
1965: ])
1966: |comment<summary: section (numbered section; IT)>
1967: .Tm Global Commands s
1968:
1969: |section(Global Commands)
1970:
1971: |comment<inserting commands/global starting here>
1972: .in +.4i
1973: .ti -.4i
1974: \f(CWA_list\fP alphabetized list using A.
1975: .ti -.4i
1976: \f(CWI_list\fP numbered list using I.
1977: .ti -.4i
1978: \f(CWa_list\fP alphabetized list using a)
1979: .ti -.4i
1980: \f(CWappendix\fP numbered appendix; can be saved|dagnote(important values can be saved and remembered; see section |remember(save_section))
1981: .ti -.4i
1982: \f(CWapproved\fP approved
1983: .ti -.4i
1984: \f(CWaround\fP keep a block together here or move it to a later page
1985: .ti -.4i
1986: \f(CWaround_placement\fP outputs all arounds
1987: .ti -.4i
1988: \f(CWauthordagnote\fP footnote marked with a dagger for author names in titlebox
1989: .ti -.4i
1990: \f(CWb\fP bold
1991: .ti -.4i
1992: \f(CWbargraph\fP a bar graph in bar
1993: .ti -.4i
1994: \f(CWbargraph_caption\fP the bar graph's caption; can be saved
1995: .ti -.4i
1996: \f(CWbi\fP bolditalics
1997: .ti -.4i
1998: \f(CWbig\fP increase point size
1999: .ti -.4i
2000: \f(CWblank_space\fP leave this much blank space
2001: .ti -.4i
2002: \f(CWbold\fP alias for b
2003: .ti -.4i
2004: \f(CWbolditalics\fP alias for bi
2005: .ti -.4i
2006: \f(CWbullet_list\fP bulleted list using \s-2\(bu\s+2
2007: .ti -.4i
2008: \f(CWcenter\fP center each line
2009: .ti -.4i
2010: \f(CWcenter_block\fP center all lines as a block
2011: .ti -.4i
2012: \f(CWchapter\fP numbered chapter; can be saved
2013: .ti -.4i
2014: \f(CWcolumn_style\fP width, offset
2015: .ti -.4i
2016: \f(CWcomment\fP comment out text
2017: .ti -.4i
2018: \f(CWcomputeroutput\fP figure using cw
2019: .Tm Computer Output s
2020: .ti -.4i
2021: \f(CWcomputeroutput_caption\fP the computer output's caption; can be saved
2022: .ti -.4i
2023: \f(CWconstant_width\fP alias for cw
2024: .ti -.4i
2025: \f(CWcw\fP constant width
2026: .ti -.4i
2027: \f(CWdagnote\fP footnote marked with a dagger
2028: .ti -.4i
2029: \f(CWdash_list\fP dashed list using \(em
2030: .ti -.4i
2031: \f(CWe\fP an inline equation in eqn
2032: .ti -.4i
2033: \f(CWendnote\fP numbered endnote
2034: .ti -.4i
2035: \f(CWendnote_placement\fP outputs endnotes
2036: .ti -.4i
2037: \f(CWequation\fP an equation in eqn
2038: .ti -.4i
2039: \f(CWequation_caption\fP the equation's caption; can be saved
2040: .ti -.4i
2041: \f(CWequation_number\fP the equation's number; can be saved
2042: .ti -.4i
2043: \f(CWfigure\fP a figure
2044: .ti -.4i
2045: \f(CWfigure_caption\fP the figure's caption; can be saved
2046: .ti -.4i
2047: \f(CWfootnote\fP numbered footnote
2048: .Tm Footnotes
2049: .ti -.4i
2050: \f(CWfull\fP use full page width for footnotes and arounds
2051: .ti -.4i
2052: \f(CWgraph\fP a graph in grap
2053: .ti -.4i
2054: \f(CWgraph_caption\fP the graph's caption; can be saved
2055: .ti -.4i
2056: \f(CWhere\fP keep a block together on this page or start a new page
2057: .ti -.4i
2058: \f(CWi\fP italics
2059: .ti -.4i
2060: \f(CWi_list\fP numbered list using i)
2061: .ti -.4i
2062: \f(CWideal\fP a picture in ideal
2063: .ti -.4i
2064: \f(CWideal_caption\fP the ideal's caption; can be saved
2065: .ti -.4i
2066: \f(CWindent\fP indent by standard amount
2067: .ti -.4i
2068: \f(CWindex\fP save this item and page number for index
2069: .ti -.4i
2070: \f(CWindex_level0\fP index program top level without sublevels
2071: .ti -.4i
2072: \f(CWindex_level1\fP index program top level with sublevels
2073: .ti -.4i
2074: \f(CWindex_level2\fP index program sublevel
2075: .ti -.4i
2076: \f(CWindex_placement\fP put the index here
2077: .ti -.4i
2078: \f(CWinsert\fP insert a file here
2079: .ti -.4i
2080: \f(CWipa\fP international phonetic alphabet
2081: .ti -.4i
2082: \f(CWitalics\fP alias for i
2083: .ti -.4i
2084: \f(CWitem\fP item of a list; can be saved
2085: .ti -.4i
2086: \f(CWleft_adjust\fP left adjust the text
2087: .ti -.4i
2088: \f(CWleft_center_right\fP left justify, center, right justify a line
2089: .Tm Footnotes
2090: .ti -.4i
2091: \f(CWnarrow\fP use current column for footnotes and arounds
2092: .ti -.4i
2093: \f(CWnew_column\fP skip to the next column
2094: .ti -.4i
2095: \f(CWnew_page\fP skip to the next page
2096: .ti -.4i
2097: \f(CWnotation\fP notation
2098: .ti -.4i
2099: \f(CWnumber_list\fP numbered list using 1.
2100: .ti -.4i
2101: \f(CWp\fP alias for paragraph
2102: .ti -.4i
2103: \f(CWp_a_list\fP alphabetized list using (a)
2104: .ti -.4i
2105: \f(CWp_number_list\fP numbered list using (1)
2106: .ti -.4i
2107: \f(CWparagraph\fP n, i, f, numbered, indented, flushed
2108: .ti -.4i
2109: \f(CWpart\fP multi-part document
2110: .ti -.4i
2111: \f(CWped\fP a picture in ped
2112: .ti -.4i
2113: \f(CWped_caption\fP the ped's caption; can be saved
2114: .ti -.4i
2115: \f(CWpicture\fP a picture in pic
2116: .ti -.4i
2117: \f(CWpicture_caption\fP the picture's caption; can be saved
2118: .ti -.4i
2119: \f(CWquotation\fP indent left and right
2120: .ti -.4i
2121: \f(CWr\fP roman
2122: .ti -.4i
2123: \f(CWreference\fP a reference in prefer
2124: .ti -.4i
2125: \f(CWreference_database\fP use this database file for prefer
2126: .ti -.4i
2127: \f(CWreference_include\fP these reference in prefer
2128: .ti -.4i
2129: \f(CWreference_list\fP format these databases in prefer
2130: .Tm References s
2131: .ti -.4i
2132: \f(CWreference_placement\fP produce references here
2133: .ti -.4i
2134: \f(CWremember\fP remember the important thing or page number saved in this label
2135: .ti -.4i
2136: \f(CWroman\fP alias for r
2137: .ti -.4i
2138: \f(CWs\fP alias for small
2139: .ti -.4i
2140: \f(CWsave\fP save last important thing, shown as ``can be saved'', in this label
2141: .ti -.4i
2142: \f(CWsavepage\fP save last page number in this label
2143: .ti -.4i
2144: \f(CWsavestring\fP save string under this name
2145: .ti -.4i
2146: \f(CWsection\fP numbered section; can be saved
2147: .ti -.4i
2148: \f(CWset_counter\fP page, chapter, section, subsection, subsubsection, appendix, figure, table, footnote, note
2149: .ti -.4i
2150: \f(CWset_string\fP page_headers, even_headers, odd_headers, page_footers, even_footers, odd_footers
2151: .ti -.4i
2152: \f(CWsmall\fP reduce the point size
2153: .ti -.4i
2154: \f(CWsource\fP insert a file here without processing it
2155: .Tm Special characters s
2156: .ti -.4i
2157: \f(CWsp\fP special characters
2158: .ti -.4i
2159: \f(CWstarnote\fP footnote marked with a star
2160: .ti -.4i
2161: \f(CWstyle\fP controls general style of document
2162: .ti -.4i
2163: \f(CW 1_5_space\fP 1 and a half space
2164: .ti -.4i
2165: \f(CW double_space\fP double space
2166: .ti -.4i
2167: \f(CW font_family\fP times, palatino, bembo, optima, souvenir, helvetica, cw, gothic, condensed, narrow
2168: .Tm Spacing s
2169: .ti -.4i
2170: \f(CW font_size\fP font_size font_spacing
2171: .Tm Spacing s
2172: .ti -.4i
2173: \f(CW list_spacing\fP on, off
2174: .ti -.4i
2175: \f(CW multi_column\fP multiple columns per page
2176: .ti -.4i
2177: \f(CW one_column\fP full page output
2178: .ti -.4i
2179: \f(CW page_length\fP length of the printed page
2180: .ti -.4i
2181: \f(CW page_number\fP arabic, roman
2182: .ti -.4i
2183: \f(CW page_offset\fP offset of the printed page
2184: .ti -.4i
2185: \f(CW page_width\fP width of the printed page
2186: .ti -.4i
2187: \f(CW paragraph_style\fP indented, numbered, flushed
2188: .ti -.4i
2189: \f(CW reference\fP acm, apa, att, ieee, lsa, pami, spectrum
2190: .ti -.4i
2191: \f(CW reference_option\fP tm, rp, nroff, troff, sort, sequence, a, d, t, ad, at, da, dt, ta, td, adt, atd, dat, dta, tad, tda
2192: .ti -.4i
2193: \f(CW single_space\fP single space
2194: .ti -.4i
2195: \f(CW triple_space\fP triple space
2196: .ti -.4i
2197: \f(CW two_column\fP two columns per page
2198: .ti -.4i
2199: \f(CWsubsection\fP numbered subsection; can be saved
2200: .ti -.4i
2201: \f(CWsubsubsection\fP numbered subsubsection; can be saved
2202: .Tm tbl C
2203: .ti -.4i
2204: \f(CWtable\fP a table in tbl
2205: .ti -.4i
2206: \f(CWtable_caption\fP the table's caption; can be saved
2207: .ti -.4i
2208: \f(CWtc_entry\fP tc program entry
2209: .ti -.4i
2210: \f(CWtc_heading\fP tc program heading
2211: .Tm Table of contents s
2212: .ti -.4i
2213: \f(CWtc_placement\fP output the table of contents
2214: .ti -.4i
2215: \f(CWtext\fP fill the text
2216: .ti -.4i
2217: \f(CWu\fP underline
2218: .ti -.4i
2219: \f(CWunderline\fP alias for u
2220: .ti -.4i
2221: \f(CWunnumbered_appendix\fP unnumbered appendix
2222: .ti -.4i
2223: \f(CWunnumbered_chapter\fP unnumbered chapter
2224: .ti -.4i
2225: \f(CWunnumbered_footnote\fP unnumbered footnote
2226: .ti -.4i
2227: \f(CWunnumbered_section\fP unnumbered section
2228: .ti -.4i
2229: \f(CWunnumbered_subsection\fP unnumbered subsection
2230: .ti -.4i
2231: \f(CWunnumbered_subsubsection\fP unnumbered subsubsection
2232: .ti -.4i
2233: \f(CWverbatim\fP text exactly as it is
2234: .Tm Letters s
2235: .in -.4i
2236: |comment<inserting commands/global ending here>
2237:
2238: |section(Letters)
2239:
2240: |comment<inserting commands/letter starting here>
2241: .in +.4i
2242: .ti -.4i
2243: \f(CWaddress\fP who to address the letter to
2244: .ti -.4i
2245: \f(CWbody\fP body of letter
2246: .ti -.4i
2247: \f(CWclosing\fP salutation
2248: .ti -.4i
2249: \f(CWdate\fP date
2250: .ti -.4i
2251: \f(CWgreeting\fP greeting
2252: .ti -.4i
2253: \f(CWret_address\fP return address
2254: .ti -.4i
2255: \f(CWsignature\fP signature
2256: .Tm Memoranda s
2257: .in -.4i
2258: |comment<inserting commands/letter ending here>
2259:
2260: |section(Memoranda)
2261:
2262: |comment<inserting commands/memo starting here>
2263: .in +.4i
2264: .ti -.4i
2265: \f(CWabstract\fP abstract for coversheet
2266: .ti -.4i
2267: \f(CWauthor\fP name, initials, location, department, extension, room for title box and coversheet
2268: .ti -.4i
2269: \f(CWdate\fP date of tm for title box and coversheet
2270: .ti -.4i
2271: \f(CWdocument\fP number, file_case, work_program for title box and coversheet
2272: .ti -.4i
2273: \f(CWkeywords\fP keywords for cover sheet
2274: .ti -.4i
2275: \f(CWsignature\fP signatures and typing credits
2276: .ti -.4i
2277: \f(CWtitle\fP title of document for title box and coversheet
2278: .ti -.4i
2279: \f(CWtitlebox\fP produce title box here
2280: .Tm Merit Review Form 1 s
2281: .in -.4i
2282: |comment<inserting commands/memo ending here>
2283:
2284: |section(Merit Review Form 1)
2285:
2286: |comment<inserting commands/form1 starting here>
2287: .in +.4i
2288: .ti -.4i
2289: \f(CWdate\fP date for signature
2290: .ti -.4i
2291: \f(CWdepartment\fP department for titlebox
2292: .ti -.4i
2293: \f(CWname\fP name for titlebox and signature
2294: .ti -.4i
2295: \f(CWp\fP paragraph
2296: .ti -.4i
2297: \f(CWsignature\fP signature
2298: .ti -.4i
2299: \f(CWtitlebox\fP title box
2300: .Tm Bi-Annual Research Reports s
2301: .in -.4i
2302: |comment<inserting commands/form1 ending here>
2303:
2304: |section(Bi-Annual Research Reports)
2305:
2306: |comment<inserting commands/research starting here>
2307: .in +.4i
2308: .ti -.4i
2309: \f(CWauthor\fP name, number for footer and title box
2310: .ti -.4i
2311: \f(CWdate\fP report, range for title box
2312: .ti -.4i
2313: \f(CWdepartment\fP name, number for title box
2314: .ti -.4i
2315: \f(CWp\fP alias for paragraph
2316: .ti -.4i
2317: \f(CWparagraph\fP i, indented
2318: .ti -.4i
2319: \f(CWsection\fP section
2320: .ti -.4i
2321: \f(CWsignature\fP signature
2322: .ti -.4i
2323: \f(CWtitlebox\fP title box
2324: .Tm Center Phone Books s
2325: .in -.4i
2326: |comment<inserting commands/research ending here>
2327:
2328: |section(Center Phone Books)
2329:
2330: |comment<inserting commands/centerpb starting here>
2331: .in +.4i
2332: .ti -.4i
2333: \f(CWdate\fP date of center phone book
2334: .ti -.4i
2335: \f(CWdepartment\fP a department
2336: .ti -.4i
2337: \f(CWdepartment_title\fP title of department
2338: .ti -.4i
2339: \f(CWemployee\fP name, nicname, phone, room, email, secretary, consultant, contractor, intern, limited term, resident visitor, casual, post doc, temporary, mit coop, department
2340: .ti -.4i
2341: \f(CWlaboratory\fP a laboratory
2342: .ti -.4i
2343: \f(CWlaboratory_title\fP title of laboratory
2344: .ti -.4i
2345: \f(CWroom\fP name, phone, room, email
2346: .ti -.4i
2347: \f(CWtitlebox\fP title box
2348: .Tm Technical Memoranda s
2349: .in -.4i
2350: |comment<inserting commands/centerpb ending here>
2351:
2352: |section(Technical Memoranda)
2353:
2354: |comment<inserting commands/tm starting here>
2355: .in +.4i
2356: .ti -.4i
2357: \f(CWabstract\fP abstract for coversheet
2358: .ti -.4i
2359: \f(CWadd_totals\fP text, other, figure, table, reference counts for cover sheet
2360: .ti -.4i
2361: \f(CWatt\fP is_release for cover sheet
2362: .ti -.4i
2363: \f(CWauthor\fP name, initials, location, department, extension, room for title box and coversheet
2364: .ti -.4i
2365: \f(CWcover_sheet\fP produce the coversheet here
2366: .ti -.4i
2367: \f(CWdate\fP date of tm for title box and coversheet
2368: .ti -.4i
2369: \f(CWdh_name\fP department head's name for cover sheet
2370: .ti -.4i
2371: \f(CWdirector_name\fP director's name for cover sheet
2372: .ti -.4i
2373: \f(CWdistribute_complete_memo\fP distribution list for complete memo
2374: .ti -.4i
2375: \f(CWdistribute_cover_sheet\fP distribution list for cover sheet
2376: .ti -.4i
2377: \f(CWdocument\fP number, file_case, work_program for title box and coversheet
2378: .ti -.4i
2379: \f(CWearlier\fP replacing earlier document_number for cover sheet
2380: .ti -.4i
2381: \f(CWgovernment_security\fP government security clearance for cover sheet
2382: .ti -.4i
2383: \f(CWkeywords\fP keywords for cover sheet
2384: .ti -.4i
2385: \f(CWmercury\fP chm, cmm, cmp, elc, lfs, man, mas, mkt, phy, std mercury distribution for cover sheet
2386: .ti -.4i
2387: \f(CWother\fP end of text body/start of attached pages
2388: .ti -.4i
2389: \f(CWproprietary_class\fP proprietary classification for cover sheet
2390: .ti -.4i
2391: \f(CWsignature\fP signatures and typing credits
2392: .ti -.4i
2393: \f(CWtitle\fP title of document for title box and coversheet
2394: .ti -.4i
2395: \f(CWtitlebox\fP produce title box here
2396: .Tm Internal Memoranda s
2397: .in -.4i
2398: |comment<inserting commands/tm ending here>
2399:
2400: |section(Internal Memoranda)
2401:
2402: |comment<inserting commands/im starting here>
2403: .in +.4i
2404: .ti -.4i
2405: \f(CWabstract\fP abstract for coversheet
2406: .ti -.4i
2407: \f(CWadd_totals\fP text, other, figure, table, reference counts for cover sheet
2408: .ti -.4i
2409: \f(CWatt\fP is_release for cover sheet
2410: .ti -.4i
2411: \f(CWauthor\fP name, initials, location, department, extension, room for title box and coversheet
2412: .ti -.4i
2413: \f(CWcover_sheet\fP produce the coversheet here
2414: .ti -.4i
2415: \f(CWdate\fP date of tm for title box and coversheet
2416: .ti -.4i
2417: \f(CWdh_name\fP department head's name for cover sheet
2418: .ti -.4i
2419: \f(CWdirector_name\fP director's name for cover sheet
2420: .ti -.4i
2421: \f(CWdistribute_complete_memo\fP distribution list for complete memo
2422: .ti -.4i
2423: \f(CWdistribute_cover_sheet\fP distribution list for cover sheet
2424: .ti -.4i
2425: \f(CWdocument\fP number, file_case, work_program for title box and coversheet
2426: .ti -.4i
2427: \f(CWearlier\fP replacing earlier document_number for cover sheet
2428: .ti -.4i
2429: \f(CWgovernment_security\fP government security clearance for cover sheet
2430: .ti -.4i
2431: \f(CWkeywords\fP keywords for cover sheet
2432: .ti -.4i
2433: \f(CWmercury\fP chm, cmm, cmp, elc, lfs, man, mas, mkt, phy, std mercury distribution for cover sheet
2434: .ti -.4i
2435: \f(CWother\fP end of text body/start of attached pages
2436: .ti -.4i
2437: \f(CWproprietary_class\fP proprietary classification for cover sheet
2438: .ti -.4i
2439: \f(CWsignature\fP signatures and typing credits
2440: .ti -.4i
2441: \f(CWtitle\fP title of document for title box and coversheet
2442: .ti -.4i
2443: \f(CWtitlebox\fP produce title box here
2444: .Tm Technical Correspondence s
2445: .in -.4i
2446: |comment<inserting commands/im ending here>
2447:
2448: |section(Technical Correspondence)
2449:
2450: |comment<inserting commands/tc starting here>
2451: .in +.4i
2452: .ti -.4i
2453: \f(CWabstract\fP abstract for coversheet
2454: .ti -.4i
2455: \f(CWadd_totals\fP text, other, figure, table, reference counts for cover sheet
2456: .ti -.4i
2457: \f(CWatt\fP is_release for cover sheet
2458: .ti -.4i
2459: \f(CWauthor\fP name, initials, location, department, extension, room for title box and coversheet
2460: .ti -.4i
2461: \f(CWcover_sheet\fP produce the coversheet here
2462: .ti -.4i
2463: \f(CWdate\fP date of tm for title box and coversheet
2464: .ti -.4i
2465: \f(CWdh_name\fP department head's name for cover sheet
2466: .ti -.4i
2467: \f(CWdirector_name\fP director's name for cover sheet
2468: .ti -.4i
2469: \f(CWdistribute_complete_memo\fP distribution list for complete memo
2470: .ti -.4i
2471: \f(CWdistribute_cover_sheet\fP distribution list for cover sheet
2472: .ti -.4i
2473: \f(CWdocument\fP number, file_case, work_program for title box and coversheet
2474: .ti -.4i
2475: \f(CWearlier\fP replacing earlier document_number for cover sheet
2476: .ti -.4i
2477: \f(CWgovernment_security\fP government security clearance for cover sheet
2478: .ti -.4i
2479: \f(CWkeywords\fP keywords for cover sheet
2480: .ti -.4i
2481: \f(CWmercury\fP chm, cmm, cmp, elc, lfs, man, mas, mkt, phy, std mercury distribution for cover sheet
2482: .ti -.4i
2483: \f(CWother\fP end of text body/start of attached pages
2484: .ti -.4i
2485: \f(CWproprietary_class\fP proprietary classification for cover sheet
2486: .ti -.4i
2487: \f(CWsignature\fP signatures and typing credits
2488: .ti -.4i
2489: \f(CWtitle\fP title of document for title box and coversheet
2490: .ti -.4i
2491: \f(CWtitlebox\fP produce title box here
2492: .Tm Release Papers s
2493: .in -.4i
2494: |comment<inserting commands/tc ending here>
2495:
2496: |section(Release Papers)
2497:
2498: |comment<inserting commands/rp starting here>
2499: .in +.4i
2500: .ti -.4i
2501: \f(CWabstract\fP abstract for coversheet
2502: .ti -.4i
2503: \f(CWauthor\fP name, initials, location, department, extension, room for title box and coversheet
2504: .ti -.4i
2505: \f(CWdate\fP date of tm for title box and coversheet
2506: .ti -.4i
2507: \f(CWdocument\fP number, file_case, work_program for title box and coversheet
2508: .ti -.4i
2509: \f(CWkeywords\fP keywords for cover sheet
2510: .ti -.4i
2511: \f(CWtitle\fP title of document for title box and coversheet
2512: .ti -.4i
2513: \f(CWtitlebox\fP produce title box here
2514: .Tm Association for Computing Machinery Proceedings s
2515: .in -.4i
2516: |comment<inserting commands/rp ending here>
2517:
2518: |section(Association for Computing Machinery Proceedings)
2519:
2520: |comment<inserting commands/acm starting here>
2521: .in +.4i
2522: .ti -.4i
2523: \f(CWabstract\fP abstract for coversheet
2524: .ti -.4i
2525: \f(CWauthor\fP name, initials, location, department, extension, room for title box and coversheet
2526: .ti -.4i
2527: \f(CWdate\fP date of tm for title box and coversheet
2528: .ti -.4i
2529: \f(CWdocument\fP number, file_case, work_program for title box and coversheet
2530: .ti -.4i
2531: \f(CWkeywords\fP keywords for cover sheet
2532: .Tm References s
2533: .ti -.4i
2534: \f(CWreference_placement\fP produce references here
2535: .ti -.4i
2536: \f(CWtitle\fP title of document for title box and coversheet
2537: .ti -.4i
2538: \f(CWtitlebox\fP produce title box here
2539: .Tm Conference Proceedings Model Sheets s
2540: .in -.4i
2541: |comment<inserting commands/acm ending here>
2542:
2543: |section(Conference Proceedings Model Sheets)
2544:
2545: |comment<inserting commands/model starting here>
2546: .in +.4i
2547: .ti -.4i
2548: \f(CWabstract\fP abstract for coversheet
2549: .ti -.4i
2550: \f(CWauthor\fP name, initials, location, department, extension, room for title box and coversheet
2551: .ti -.4i
2552: \f(CWdate\fP date of tm for title box and coversheet
2553: .ti -.4i
2554: \f(CWdocument\fP number, file_case, work_program for title box and coversheet
2555: .ti -.4i
2556: \f(CWkeywords\fP keywords for cover sheet
2557: .Tm References s
2558: .ti -.4i
2559: \f(CWreference_placement\fP produce references here
2560: .ti -.4i
2561: \f(CWtitle\fP title of document for title box and coversheet
2562: .ti -.4i
2563: \f(CWtitlebox\fP produce title box here
2564: .Tm Computer Science Press Books s
2565: .in -.4i
2566: |comment<inserting commands/model ending here>
2567:
2568: |section(Computer Science Press Books)
2569:
2570: |comment<inserting commands/cspress starting here>
2571: .in +.4i
2572: .ti -.4i
2573: \f(CWabstract\fP abstract for coversheet
2574: .ti -.4i
2575: \f(CWauthor\fP name, initials, location, department, extension, room for title box and coversheet
2576: .ti -.4i
2577: \f(CWdate\fP date of tm for title box and coversheet
2578: .ti -.4i
2579: \f(CWdocument\fP number, file_case, work_program for title box and coversheet
2580: .ti -.4i
2581: \f(CWkeywords\fP keywords for cover sheet
2582: .ti -.4i
2583: \f(CWtitle\fP title of document for title box and coversheet
2584: .ti -.4i
2585: \f(CWtitlebox\fP produce title box here
2586: .Tm Kluwer Academic Publishers Books s
2587: .in -.4i
2588: |comment<inserting commands/cspress ending here>
2589:
2590: |section(Kluwer Academic Publishers Books)
2591:
2592: |comment<inserting commands/kluwer starting here>
2593: .in +.4i
2594: .ti -.4i
2595: \f(CWappendix\fP numbered appendix; IT
2596: .ti -.4i
2597: \f(CWchapter\fP numbered chapter; IT
2598: .ti -.4i
2599: \f(CWindex_placement\fP put the index here
2600: .Tm References s
2601: .ti -.4i
2602: \f(CWreference_placement\fP produce references here
2603: .ti -.4i
2604: \f(CWsection\fP numbered section; IT
2605: .ti -.4i
2606: \f(CWtc_heading\fP tc program heading
2607: .ti -.4i
2608: \f(CWunnumbered_appendix\fP unnumbered appendix
2609: .ti -.4i
2610: \f(CWunnumbered_chapter\fP unnumbered chapter
2611: .ti -.4i
2612: \f(CWunnumbered_section\fP unnumbered section
2613: .in -.4i
2614: |comment<inserting commands/kluwer ending here>
2615:
2616: |section(Nursing Home Song Sheets)
2617:
2618: |comment<inserting commands/song starting here>
2619: .in +.4i
2620: .ti -.4i
2621: \f(CWd\fP directive to the singers
2622: .ti -.4i
2623: \f(CWm\fP margin text
2624: .ti -.4i
2625: \f(CWrefrain\fP refrain of the song
2626: .ti -.4i
2627: \f(CWsmaller\fP print the song smaller than normal
2628: .ti -.4i
2629: \f(CWstyle singers\fP full instructions
2630: .ti -.4i
2631: \f(CWtitle\fP title of the song
2632: .ti -.4i
2633: \f(CWverse\fP verse of the song
2634: .Tm Special characters s
2635: .Tm Special characters s
2636: .Tm Spacing s
2637: .in -.4i
2638: |comment<inserting commands/song ending here>
2639:
2640: .ad b
2641:
2642: |appendix(List of Special Characters)
2643: |save(special_appendix)
2644:
2645: The special characters that control spacing and carriage movements are
2646: described in section |remember(special_section).
2647: .Tm Special characters s
2648: All other special characters are listed below.
2649: For each character,
2650: column |cw<Char> contains the final printed character
2651: and column |cw<Name> contains the keywords
2652: given to |i<monk> to specify the character.
2653: To print the character |sp(rhand), type |cw<|sp(|)sp(rhand)>
2654: in your input file.
2655: .Tm Special characters s
2656:
2657: |comment<inserting examples/special starting here>
2658: |section(Common special characters)
2659: .Tm Greek alphabet s
2660: .Tm Mathematical Symbols s
2661: |begin(table)
2662: ;
2663: cfB 1 lfB cfB 1 lfB
2664: cw(.3i)1 lw(.85i) cw(.3i)1 lw(.85i).
2665: Char Name Char Name
2666: |sp{rhand} rhand |sp{lhand} lhand
2667: |sp{open quote} open quote |sp{close quote} close quote
2668: |sp{Em dash} Em dash |sp{minus} minus
2669: |sp{hyphen} hyphen |sp{underrule} underrule
2670: |sp{\} |sp{\} |sp{/} /
2671: |sp{degree} degree |sp{bullet} bullet
2672: |sp{dagger} dagger |sp{double dagger} double dagger
2673: |sp{section} section
2674: |sp{|} |sp{|}
2675: |sp{.} .
2676: .T&
2677: c1 le cz1 le.
2678: |sp{ATT logo}
2679: |sp{TM} TM |s(ATT) logo
2680: |sp{registered} registered |sp{copyright} copyright
2681: |end(table)
2682: |section(Greek alphabet)
2683: |begin(table)
2684: ;
2685: cfB 1 lfB cfB 1 lfB
2686: cw(.3i)1 lw(.85i) cw(.3i)1 lw(.85i).
2687: Char Name Char Name
2688: |sp{alpha} alpha |sp{ALPHA} ALPHA
2689: |sp{beta} beta |sp{BETA} BETA
2690: |sp{gamma} gamma |sp{GAMMA} GAMMA
2691: |sp{delta} delta |sp{DELTA} DELTA
2692: |sp{epsilon} epsilon |sp{EPSILON} EPSILON
2693: |sp{zeta} zeta |sp{ZETA} ZETA
2694: |sp{eta} eta |sp{ETA} ETA
2695: |sp{theta} theta |sp{THETA} THETA
2696: |sp{iota} iota |sp{IOTA} IOTA
2697: |sp{kappa} kappa |sp{KAPPA} KAPPA
2698: |sp{lambda} lambda |sp{LAMBDA} LAMBDA
2699: |sp{mu} mu |sp{MU} MU
2700: |sp{nu} nu |sp{NU} NU
2701: |sp{xi} xi |sp{XI} XI
2702: |sp{omicron} omicron |sp{OMICRON} OMICRON
2703: |sp{pi} pi |sp{PI} PI
2704: |sp{rho} rho |sp{RHO} RHO
2705: |sp{sigma} sigma |sp{SIGMA} SIGMA
2706: |sp{terminal sigma} terminal sigma
2707: |sp{tau} tau |sp{TAU} TAU
2708: |sp{upsilon} upsilon |sp{UPSILON} UPSILON
2709: |sp{phi} phi |sp{PHI} PHI
2710: |sp{chi} chi |sp{CHI} CHI
2711: |sp{psi} psi |sp{PSI} PSI
2712: |sp{omega} omega |sp{OMEGA} OMEGA
2713: |end(table)
2714: |section(Mathematical symbols)
2715: |begin(table)
2716: ;
2717: cfB 1 lfB cfB 1 lfB
2718: cw(.3i)1 lw(.85i) cw(.3i)1 lw(.85i).
2719: Char Name Char Name
2720: |sp{+} + |sp{-} -
2721: |sp{+-} +- |sp{*} *
2722: |sp{times} times |sp{divide} divide
2723: |sp{-wig} -wig |sp{wig} wig
2724: |sp{!=} != |sp{==} ==
2725: |sp{>=} >= |sp{<=} <=
2726: |sp{integral} integral |sp{partial} partial
2727: |sp{inf} inf |sp{del} del
2728: |sp{not} not |sp{or} or
2729: |sp{prop} prop
2730: |sp{lceil} lceil |sp{rceil} rceil
2731: |sp{lfloor} lfloor |sp{rfloor} rfloor
2732: |end(table)
2733: |section(Mathematical set symbols)
2734: |begin(table)
2735: ;
2736: cfB 1 lfB cfB 1 lfB
2737: cw(.3i)1 lw(.85i) cw(.3i)1 lw(.85i).
2738: Char Name Char Name
2739: |sp{member} member |sp{cup} cup
2740: |sp{empty} empty |sp{cap} cap
2741: |sp{subset} subset |sp{superset} superset
2742: |sp{isubset} isubset |sp{isuperset} isuperset
2743: |end(table)
2744: |section(Miscellaneous)
2745: |begin(table)
2746: ;
2747: cfB 1 lfB cfB 1 lfB
2748: cw(.3i)1 lw(.85i) cw(.3i)1 lw(.85i).
2749: Char Name Char Name
2750: |sp{fi} fi |sp{fl} fl
2751: |sp{ff} ff |sp{ffi} ffi
2752: |sp{ffl} ffl
2753: |sp{rule} rule |sp{box vertical rule} box vertical rule
2754: |sp{acute} acute |sp{grave} grave
2755: |sp{circle} circle |sp{square} square
2756: |sp{bold vertical} bold vertical |sp{footmark} footmark
2757: |sp{->} -> |sp{<-} <-
2758: |sp{uarrow} uarrow |sp{darrow} darrow
2759: |sp{quarter} quarter |sp{half} half
2760: |sp{3quarter} 3quarter |sp{cent} cent
2761: |sp{TEX} TEX |sp{LATEX} LATEX
2762: |end(table)
2763: |comment<
2764: |section(Carriage control)
2765: |sp{down} down
2766: |sp{break and spread} break and spread
2767: |sp{reverse} reverse
2768: |sp{tab} tab
2769: |sp{up} up
2770: |sp{interrupt text processing} interrupt text processing
2771: |sp{conceal new line} conceal new line>
2772: |comment<inserting examples/special ending here>
2773:
2774: |appendix(List Of Examples)
2775:
2776: This appendix provides the input text for examples that appear in
2777: this |i<Monk> user guide.
2778: .Tm tbl C
2779: .Tm |i<pic> C
2780: .Tm References s
2781: They are not intended for a novice user,
2782: but for those already familiar with these formatting tools.
2783: If you want to learn how to use |i<tbl> or |i<pic>
2784: do not look at these examples.
2785: Please read the guides that are listed in the references.
2786: These guides, which are readily available,
2787: begin with simple examples.
2788:
2789: |comment<|section(Table in section |remember(table_example))>
2790: |section(Table in section 5.14)
2791: |save(table_appendix)
2792: .ta 1.4i 2.6i
2793:
2794: |begin(figure)
2795: |source(examples/example.table)
2796: |end(figure)
2797:
2798: .ta
2799:
2800: |comment<|section(Picture in section |remember(picture_example))>
2801: |section(Picture in section 5.16)
2802:
2803: .ta .2i
2804:
2805: |begin(figure)
2806: |source(examples/example.pic1)
2807: |end(figure)
2808:
2809: .ta
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.