o examples/letter.mom: New file.
[s-roff.git] / contrib / mom / ChangeLog
blobef2b28ae104e7548c60e70428b02cd64dd91ca74
1 *Fri Jun  7 2002
3 o examples/letter.mom: New file.
5 o Makefile.sub (EXAMPLEFILES, PROCESSEDEXAMPLEFILES): Add letter.mom.
7 *Wed Jun  5 2002
9 o Makefile.sub (TFLAG): Add `$(top_builddir)/tmac'.
11 *Tue Jun  4 2002
13 o Makefile.sub (groff_bin_dirs): Fix typo (forgotten `src' element).
15 *Mon Jun  3 2002
17 o Makefile.sub (uninstall_sub): Don't use `momdocdir' but `htmldocdir'.
18   Add missing backslash.
20 *Sat Jun  1 2002
22 o Makefile.in (prepare_make_examples): Test for `penguin.ps', not
23   `examples/penguin.ps'.
25 *Wed May 29 2002
27 o Rewrote portions of PAGENUM_STYLE and COPYSTYLE so that PAGENUM_STYLE
28   behaves as advertised.
30 *Fri May 24 2002
32 o /Makefile.sub (momdocdir): Removed.
33   (HTMLDOCFILES): Prepend `momdoc/'.
34   (EXTRAEXAMPLEFILES): Removed.  Added entries to...
35   (EXAMPLEFILES): This.
36   (.SUFFIXES, .mom.ps): New.
37   (prepare_make_examples): Updated.
38   (examples/*.ps): Removed; .mom.ps will handle this.
39   (install_data): Updated.  
41 *Thu May 23 2002
43 o Applied two small bug fixes to om.tmac (patches 1.1.1a and 1.1.1b).
45 o mom is now part of groff.
47 o Some renaming to avoid problems with 8+3 filesystems:
49     examples/docprocessing_typeset.mom   -> examples/typeset.mom
50     examples/docprocessing_typewrite.mom -> examples/typewrite.mom
51     examples/typesetting_macros.mom      -> examples/macros.mom
52     examples/penguin_small2_bw.ps        -> examples/penguin.ps
54 o Removed `INSTALL' and `README' since groff takes care of installation
55   now.
57 o Added Makefile.sub.
59 o Added mom.tmac (which simply calls om.tmac).
61 o Added groff_mom.man for orthogonality; it simply points to the HTML
62   documentation.
64 *Thu May 16 2002
66 o Added macro DRAFT_WITH_PAGENUMBER so user can have draft/revision
67   info attached to the pagenumber in COPYSTYLE DRAFT, instead of having
68   it HEADER center.  Always having it HEADER center was creating problems
69   with long doc titles, esp. with PRINTSTYLE TYPEWRITE (which is when
70   COPYSTYLE DRAFT is most likely to be used).  Now user has the choice,
71   in these circumstances, either to reduce HEADER_SIZE, or to displace
72   the draft/revision info.  Also rewrote portions of COPYSTYLE so that
73   if no revision number is given in the reference macros, "Rev. #"
74   doesn't appear when COPYSTYLE DRAFT.
76 *Fri May 10 2002
78 o Added capability of user-defined, single string recto/verso
79   headers/footers.
81 o Added new entries to docs about the above.  Made some additional
82   small changes to toc.html, rectoverso.html, and headfootpage.html
83   to supplement the new entries.
85 o Small fix to handling of footer separator rule -- was 1 point too low
86   owing to fuzziness of #CAP_HEIGHT as returned by SIZESPECS.
88 o Added some more useful stuff to elvis_syntax.
90 *Sun May 05 2002
92 o Fix to DEFAULTS so that L_MARGIN and R_MARGIN are reprocessed if
93   DOCTYPE LETTER.  R_MARGIN, as set by DOCTYPE LETTER had no preceding
94   PAGEWIDTH or PAPER from which to get #PAGE_WIDTH for figuring out
95   line length.
97 o Additional fix to DEFAULTS in handling DOCTYPE LETTER so that if user
98   sets line length prior to START, no reprocessing of R_MARGIN occurs.
99   This necessitated adding a new number register: #USER_SET_L_LENGTH
101 *Sat May 04 23:48:05 EDT 2002
103 o Added .cflags 4 /\(en -- was driving me nuts that lines wouldn't
104   break after these characters; I'm assuming others feel the same way
106 * Fri May 03 2002
108 o Made some small fixes to space handling around quotes, mostly to do
109   with quotes immediately after START and quotes after (sub)heads.
111 * Wed May 01 2002
113 o Fixed a small bug that was causing the first .PP after START to begin
114   at the top margin of the page regardless of any type that preceded
115   .PP when docheaders were off.
117 o Fixed HEADER so that when HEADERS are off the first line of type on
118   pages after the first falls properly at the top margin
120 *Sat Apr 27 2002
122 o Renamed docprocessing_macros.mom in /examples to
123   docprocessing_typeset.mom.  Added docprocessing_typewrite.mom, as
124   well as a README file.
126 o Fixed UNDERLINE_QUOTES (for PRINTSTYLE TYPEWRITE) so they really are
127   on by default as the docs say.
129 o Changes to doc entry on COLLATE:
131     - removed bit about using COLLATE after a cover page (I wrote the
132       entry *before* I wrote the macro!).  Cover pages should be
133       followed by NEWPAGE, not COLLATE.
135     - added caution about mixing PRINTSTYLEs
137     - added caution about using DOC_FAMILY to change family of all
138       document elements after COLLATE
140 o Made HEADER_SIZE (and, by extension, FOOTER_SIZE) available to
141   PRINTSTYLE TYPEWRITE.  Changed appropriate doc entries to reflect
142   this.
144 *Wed Apr 24 2002
146 o Small change to DO_QUOTE to correct a problem with quotes and
147   blockquotes that fall in the middle of paragraphs (i.e. text after
148   the quote is not a new para).  Basically, added a bit that stores the
149   current para indent, sets para indent to 0, invokes a PP, then
150   restores the original para indent.
152 o Added new macro, BREAK_QUOTE, to deal with the problem of
153   footnotes in quotes and blockquotes that cross pages or columns.
155   Quotes and blockquotes are read into diversions, which means they
156   get their footnote information from the page/column on which they
157   were started.  If a footnoted quote crosses a page/column, what
158   sometimes happens is that the footnote itself is output at the
159   bottom of page/column where the quote started, whereas the text
160   marker for the footnote appears on the next page/column where the
161   quote ends.  Furthermore, the text marker is the one appropriate
162   to the previous page.  BREAK_QUOTE is a workaround.
164 o Added directory /examples to archive.
166 o Added typesetting_macros.mom, docprocessing_macros.mom, elvis_syntax
167   and penguin_small2_bw.ps to /examples.
169 o Added BREAK_QUOTE to docs, made some additions to reserved words
170   list, and corrected a few little doc errors.
172 *Mon Apr 22 2002
174 o Added default .L_MARGIN 1i and .R_MARGIN 1i to PAPER, PAGE, and
175   PAGEWIDTH.  L_MARGIN is essential otherwise left indents and tabs
176   don't have a register #L_MARGIN to work with.  The default right
177   margin is a convenience only.  Updated the doc entries for L_MARGIN
178   and R_MARGIN to reflect the change.
180 *Sun Apr 21 2002
182 o Changes to COLLATE:
184     - added some "resets" (LL, LS, QUAD)
185     - added a check for whether pagination is at page top (either
186       because FOOTERS are on or because PAGENUM_POS was user set).
187       If pagination is on, and PAGENUM_POS is TOP, it's turned off
188       for next page (start of next collated document) and restored
189       for subsequent pages unless PAGENUM_ON_FIRST_PAGE is on, in
190       which case the page number appears at page top.
192 o The macro TRAPS is always invoked at the end of DEFAULTS (which is
193   called by START).  Formerly, TRAPS was only invoked at the start
194   of a doc, not after COLLATE.  Now runs after COLLATE as well.
196 o Distance from $DOC_TYPE in DOCTYPE NAMED "<string>" to start of
197   running text was one linespace too deep.  Fixed (in START).
199 o When 1st arg to PAGENUM_POS was user set to TOP, running text was
200   printing 1 linespace too high, even when PAGINATION was OFF.  Same
201   problem when HEADERS were OFF (i.e. nothing in the header margin at
202   all).  Fixed by removing -\\n[#DOC_LEAD]u from all .sp |\\n[#T_MARGIN]u
203   calls of .el portion after .ie \\n[#HEADERS_ON].
205 o Added new macro: PAGENUM_ON_FIRST_PAGE.  Normally, when FOOTERS are
206   being used instead of HEADERS, mom doesn't print the page number at
207   the top of the first page of a doc, or the first page of collated
208   docs.  New macro allows user to get mom to put the page number on
209   "first" pages if that's desired.  Updated docs to include the macro.
211 o More little fixes to docs.
213 *Thu Apr 18 2002
215 o Fixed TI (temporary indent) so that it continues to work as expected,
216   even when called while another type of indent is in effect.
218 *Tue Apr 16 2002
220 o String tabs weren't working as advertised when set from within
221   a tab.  Fixed.  Two new registers added: #ST_OFFSET and #IN_TAB.
222   String tabs now behave poperly and intuitively when set within tabs.
224 o Added a note to docs about surrounding \w'...' escape with double-
225   quotes when it's used as an argument to macros
227 o Added a note to docs that SILENT does not deposit a .br
229 *Mon Apr 15  2002
231 o Added new macro BR_AT_LINE_KERN if user wants mom to deposit .br's
232   before .RW and/or .EW.
234 o Added 1/4 points to inline escapes \*[ALD] and \*[RLD].
236 o Added 1/4 points to inline escapes \*[FP] and \*[BP]
238 o Updated docs to reflect the above changes.
240 *Fri Apr 12 2002
242 o Fixed .RW and .EW which weren't working because of a missing \ in
243   \\n(.f register.  Also made it so that .RW and .EW affect all fonts
244   in positions 1, 2, 3, and 4 at once, hence line kerning now affects
245   all fonts that appear after it, not just the font that was current at
246   the time of the macros' invocation.
248 o .SS and .WS now working properly.  .WS no longer has any effect on
249   .SS, which remains constant regardless of .WS.  Furthermore, .SS no
250   longer gets its value by adding \*[$SS_VAR] + \n[.ss].  Instead,
251   it remains constant.  Don't know what I was thinking when I wrote
252   the routine in the first place.
254 o Updated and rewrote doc entry pertaining to SS
256 *Wed Apr 10 2002
258 o Renamed tmac.om to om.tmac to bring macro file's name into line
259   with current groff policy
261 o Added more standard paper sizes to PAPER.
263 o Fixed T_MARGIN, LS, and AUTOLEAD so that if T_MARGIN is set before LS
264   or AUTOLEAD at the top of a file, the first line of type falls
265   properly on the baseline set by T_MARGIN.  Previously, LS and
266   AUTOLEAD automatically advanced by the value passed to them before
267   setting the first line of type, meaning that the first line of type
268   fell at T_MARGINu+1v instead of T_MARGIN.
270 o Updated docs to reflect changes.
272 o Removed #TEST_FOR_NUMERIC from list of reserved words.
274 o Added "t" and #T_MARGIN_SET to list of reserved words.
276 *Sat Apr 6 2002
278 o Added FACTOR arg to AUTOLEAD, so if user wants autolead to be a factor
279   of point size, instead of being the sum of pointsize + autolead, s/he
280   has the choice.  Incorporated appropriate changes to PS and LS.
282 o Added new register #AUTOLEAD_FACTOR to reserved words.  Modified
283   comments for AUTOLEAD, PS, and LS to reflect changes.  Also
284   corrected an error where #AUTOLEAD_VALUE had mistakenly been written
285   $AUTOLEAD_VALUE in comments in the macro file, and removed erroneous
286   | <anything>.  Updated AUTOLEAD entry in momdoc/typesetting.html
287   to reflect the changes.
289 Release 1.1
290 -----------
292 *Wed Apr 3 2002
294 o Cleaned up html errors in the docs.
296 o Added "Next," "Prev" and "Top" links to top and bottom of doc files.
298 o Fixed some typos in the docs.