Initial import from FreeBSD RELENG_4:
[dragonfly.git] / contrib / groff / contrib / mom / NEWS
1 Release 1.1.4
2 -------------
3
4 ***SIGNIFICANT CHANGE***
5 .IX is now deprecated, although it will continue to work as before.
6 The new form is .IQ (Indent Quit).  Groff will emit a message advising
7 users to update their docs.
8
9 ***NEW***
10 Four new inlines to deal with horizontal and vertical movements:
11
12     o \*[FWD n]
13     o \*[BCK n]
14     o \*[UP n]
15     o \*[DOWN n]
16
17 All four require a unit of measure after n.  These inlines are similar
18 to the older \*[FPn], \*[BPn], \*[ALDn] and \*[RLDn], however they're
19 not restricted to points, and any value can be entered for n (the older
20 forms -- which still work -- were restricted to 1 - 36).
21
22 ***CHANGED***
23 Inline kerning can now be accomplished with \*[BU n] and \*[FU n], where
24 n, after the space, is the desired number of kern units.  The older
25 forms \*[BUn] and \*[FUn] still work, up to 36 units.
26
27 ------------------------------------------------------------------------
28
29 Release 1.1.3c
30 --------------
31
32 ***NEW***
33 A new macro -- ENDNOTES_HDRFTR_CENTER -- added so that mom's default
34 behaviour of not printing the header center string when DOCTYPE is
35 CHAPTER can be disabled (i.e. she will print the center string).  The
36 macro is user-called with ENDNOTES_HEADER_CENTER or
37 ENDNOTES_FOOTER_CENTER.
38
39 ***FIXES***
40 PAD now works as advertised when fill mode is on.
41
42 ENDNOTES no longer disables printing of footnotes on last page of
43 document body.
44
45 Release 1.1.3
46 -------------
47
48 ***SIGNIFICANT CHANGE -- PLEASE TAKE NOTE***
49 As of 1.1.3, groff must be >= 1.18.
50
51 ***NEW***
52 Added endnotes functionality to mom, along with a slew of macros to
53 control how mom prints endnotes pages.  See the html documentation.
54
55 ***NEW***
56 Added inline \*[RULE], which draws a rule to the full measure of the
57 current line length ( to be used in place of \h'\n(.lu' ).  Weight of the
58 rule is dependent on the point size of type when \#[RULE] is called.
59
60 ***FIXES***
61 PAD -- works more intuitively now when the pad string contains inline
62 escapes for font, point size, etc.
63
64 UNDERLINE -- fixed character translations of digraphs so they get
65 underlined properly.  Also fixed a bug that was causing some footnotes
66 to get underlined when UNDERLINE was on in the body of the document.
67
68 ***UPDATES***
69 Html documentation
70 elvis_syn
71
72 Release 1.1.2a
73 --------------
74
75 ***SIGNIFICANT CHANGE -- PLEASE TAKE NOTE***
76 In order to help mom toward full groffship, the macro .PS has been
77 renamed to .PT_SIZE, and the alias .TS (for .TAB_SET) has been removed.
78 .PS and .TS are keywords used by pic and tbl respectively, and the mom
79 macros of the same name were in conflict.
80
81 Release 1.1.2
82 -------------
83
84 ***IT'S OFFICIAL!***
85 mom is now an official part of the groff.  New releases will be
86 incorporated into the groff package.  I'll still be posting each new
87 release on the mom homepage, so there's no need to download all of the
88 most recent version of groff just to get a newer mom. :)
89
90 ***CHANGES***
91 Fixed default footer separator rule adjustment so that it's closer to
92 the advertised "4 points above the tallest ascender in the footer."
93
94 Added more stuff to the elvis_syn file.  Still wouldn't mind someone
95 contributing some vim/emacs syntax highlighting.
96
97 Added .cflags 4 /\(em to om.tmac.  By default, mom now obligingly
98 breaks after / and \(en.
99
100 ***NEW***
101 Macro(s): HEADER_RECTO
102           HEADER_VERSO
103 With these macros, users can now define single-string recto/verso
104 headers/footers.  HEADER_RECTO (or FOOTER_RECTO) can be used to create
105 a one-part header/footer (instead of mom's default three-parters) that
106 appears on every page if RECTO_VERSO is OFF or, if RECTO_VERSO is on, if
107 no HEADER_VERSO (or FOOTER_VERSO) has been defined.  If a HEADER_VERSO
108 (or FOOTER_VERSO) is defined and RECTO_VERSO is on, _RECTO prints on
109 even pages and _VERSO on odd pages.
110
111 Added macro DRAFT_WITH_PAGENUMBER so user can have draft/revision
112 info attached to the pagenumber in COPYSTYLE DRAFT, instead of having
113 it HEADER center.  Always having it HEADER center was creating problems
114 with long doc titles, esp. with PRINTSTYLE TYPEWRITE (which is when
115 COPYSTYLE DRAFT is most likely to be used).
116
117 ***FIXES***
118 No more "can't break line" warnings in DOCTYPE LETTER.
119
120 If no REVISION number is given, Rev. 0 no longer appears HEADER_CENTER
121 in COPYSTYLE DRAFT
122
123 PAGENUM_STYLE now works as advertised.
124
125 Release 1.1.1
126 -------------
127
128 ***CHANGES***
129 Main macro file renamed to om.tmac, in keeping with current groff
130 policy.
131
132 Now okay to use groff mailing list for mom-related posts
133
134 ***NEW***
135 Toggle macro -- BR_AT_LINE_KERN.  When on, automatically deposits
136 a break whenever .RW or .EW are invoked.  Very useful when kerning
137 whole lines of rag copy.
138
139 ***NEW***
140 Toggle macro -- PAGENUM_ON_FIRST_PAGE.  Normally, when FOOTERS are
141 being used instead of HEADERS, mom doesn't print the page number at
142 the top of the first page of a doc, or the first page of collated docs.
143 PAGENUM_ON_FIRST_PAGE allows user to get mom to put the page number on
144 "first" pages if that's desired.
145
146 ***NEW***
147 Macro -- BREAK_QUOTE -- to deal with problem of footnoted quotes and
148 blockquotes that cross a page or column.
149
150 ***NEW***
151 New argument to AUTOLEAD -- FACTOR.  With FACTOR, you can, if you
152 wish, enter a factor by which AUTOLEAD multiplies the point size when
153 calculating lead automatically.
154
155 Improvements
156 ------------
157
158 PAPER now has a much larger selection of common paper sizes.
159
160 \*[ALD], \*[RLD], \*[FP] and \*[BP] now accept increments of quarter
161 points (expressed as decimal fractions).  \*[RLD1.75], for example,
162 reverses 1-3/4 points up on the line.
163
164 HEADER_SIZE now available to PRINTSTYLE TYPEWRITE.  This was necessary
165 to deal with the problem of excessively long HEADER_LEFT, _CENTER or
166 _RIGHT strings.
167
168 Fixes
169 -----
170
171 T_MARGIN -- can be set before or after LS or AUTOLEAD
172 SS       -- remains constant regardless of WS
173 WS       -- no longer affects SS
174 TI       -- now works as expected even when called while another indent
175             type is in effect
176 COLLATE  -- small fixes
177
178 Broken .RW and .EW fixed.
179
180 String tabs now behave properly when set from within tabs.
181
182 UNDERLINE_QUOTES (for PRINTSTYLE TYPEWRITE) are now, in fact, on by
183 default as the docs state.