1 11/30/86  preface.compin, pf.compin, pf_cont.compin
 2 
 3 Syntax: .ifi preface "copyright-year(s)"
 4      OR .ifi pf      "copyright-year(s)"
 5         .srv file_no "Pubs-catalog-file-number"
 6 and, at the top of the second page (to reset the footers, etc.)  .ifi
 7         pf_cont
 8 
 9 
10 Function:
11 This compose macro creates a preface for a manual.  It
12 1) generates a 'Preface' section heading (with no Table of Contents
13    entry)
14 2) generates the page footers for the first and succeeding pages of the
15    preface (with a copyright notice and 'Pubs-catalog-file-number' on
16    the first page)
17 3) numbers the Preface pages in lowercase roman, starting with 'iii'
18 4) adds a legal notice concerning specifications and availability of
19    the described product.
20 
21 
22 5) generates a special notice on the Preface page (ahead of the
23    copyright line) of all technical manuals advising the reader of
24    possible changes in the information and availability of the
25    product described.  This notice may not be typed for a typewritten
26    manual, but must be pasted in before printing.  Preface.compin will
27    leave one inch of extra space on the preface page to accommodate
28    this notice.
29 
30 
31 Arguments:
32 'copyright-year(s)' is the copyright year(s) (all 4 digits) for the
33    document.
34 'Pubs-catalog-file-number' is the file reference number given in the
35    Publications Catalog.  (For Honeywell use, these numbers will be
36    found in Table 1-3 in Part III, "Writing and Editing," of the
37    Honeywell Publications Standards.)
38 'notice' is a specifications disclaimer legal notice will be
39    printed at the bottom of the first preface page, ahead of the
40    Copyright line.
41 
42 
43 Examples:
44 The following could be the preface of the MPM Commands:
45         .ifi init_mpm "AG92"
46         .srv file_no "1L13"
47         .ifi preface "1975, 1977"
48              Primary reference for user and
49                .
50                .
51                .
52         .brp
53         .ifi pf_cont
54              The MPM I/O manual
55                .
56                .
57 
58 (END)