1 10/17/81  l0h.compin, l0new.compin
  2 
  3 Syntax: .ifi l0h   "title-of-section"
  4      OR .ifi l0new "title-of-section"
  5 
  6      OR, for numbered sections (see "Section numbering" below)
  7 
  8         .srv section "section-no"
  9        {.srv style "roman"}
 10         .ifi l0h   "title-of-section"
 11      OR .ifi l0new "title-of-section"
 12 
 13 
 14 Function:
 15 This macro begins a new major section of a document.  It should be
 16 inserted at the beginning of each section.
 17 
 18 
 19 Arguments:
 20 'title-of-section' is the title of the section as it is to appear in
 21    the Table of Contents (i.e., first caps, no underlines).  It is
 22    translated to the proper font for the section heading on the output
 23    page.
 24 'section-no' is either a section number (e.g., "2") or an appendix
 25    letter (e.g., "A").  This value is used (e.g., SECTION 2 or APPENDIX
 26    A) in a title line preceding the section title line and is used in
 27    page numbers, figure numbers, and table numbers (e.g., the first
 28    page, figure, or table number when section-no "2" is 2-1; when
 29    section-no is "A", A-1).
 30 
 31 
 32 Macro actions:
 33 1) initializes a new section of a manual
 34 2) generates a one or two line section heading on a new page (see
 35    "Section numbering" below)
 36 3) sets the page counter to 1
 37 4) adds the section title to the Table of Contents
 38 5) in addition to the above, 'l0new' generates Table of Contents
 39    change-bars for all level header entries in a newly added section.
 40    The next use of any of the 'l0' macros other than 'l0new' cancels
 41    these change-bars.
 42 
 43 
 44 Section numbering:
 45 If you use numbered sections (i.e., use .srv section "section-no") the
 46 macros automatically use Arabic numbers in the section heading and as
 47 part of the page numbers, figure numbers, and table numbers (e.g.,
 48 2-1).
 49 
 50 You can get Roman numerals in the section heading (e.g., SECTION II
 51 preceding the section title line) by using the following line
 52 immediately BEFORE the l0h line
 53         .srv style "roman"
 54 The section-no portion of the page number, figure number, and table
 55 number will still be Arabic.
 56 
 57 
 58 Examples:
 59 The first section of the MPM Commands might begin with
 60 
 61         .ifi init_mpm "AG92"
 62         .srv section "1"
 63         .ifi l0h "Multics Command Environment"
 64 
 65 which yields (in typed output)
 66 
 67                                SECTION 1
 68 
 69                       MULTICS COMMAND ENVIRONMENT
 70 
 71 
 72 A section of a manual that does not use section numbers might begin
 73 with
 74 
 75         .ifi init "My Manual"
 76         .ifi l0h "Manual of Instructions"
 77 
 78 which yields (in typed out)
 79 
 80                         MANUAL OF INSTRUCTIONS
 81 
 82 
 83 An appendix of a manual might begin with
 84 
 85         .ifi init "My Manual"
 86         .srv section "A"
 87         .ifi l0h "Summary of Operation Properties"
 88 
 89 which yields (in typed output)
 90 
 91                               APPENDIX A
 92 
 93                     SUMMARY OF OPERATION PROPERTIES
 94 
 95 
 96 Notes:
 97 1) The section title is translated to the proper font when used in the
 98    section heading.  Use the l0exact and l0toc macros for section
 99    titles containing literal strings that should not be translated to
100    the Level 0 font.
101 
102 (END)