1 Copyright 2004, 2005, 2006
2 Free Software Foundation, Inc.
4 Copying and distribution of this file, with or without modification,
5 are permitted in any medium without royalty provided the copyright
6 notice and this notice are preserved.
8 Assume that anything that doesn't work or behaves oddly is a bug.
9 The documentation should be taken as the authoritative source for
10 how things ought to be.
12 Post to the groff mailing list with bug reports, questions and
13 suggestions, or contact me directly at:
19 If writing me directly, please include the word "groff" or "mom" in
20 the Subject line or you risk my spam filters nuking your message.
21 Also, please--no html email. That, too, gets nuked.
25 ========================================================================
28 Indenting of references (collected with .REF) on endnotes pages when
29 endnote numbers are right-aligned appears to be backwards; the
30 first line of the reference is indented more than the second.
35 DROPCAP not printing the dropcap letter at all in PRINTSTYLE
36 TYPEWRITE, nor when DROPCAP is used (accidentally?) after a legal
40 DROPCAP going into an infinite loop when groff called with the
44 SHIFT_LIST, when used anywhere but with a top-level list, is killing
45 list indents for every list level *returned to* afterward.
48 TOC page number for heads and subheads that get bumped to next page
49 (because of .ne) off by 1.
52 Moving backwards in nested lists not setting the proper indent.
55 Default linebreak color missing in om.tmac.
58 Some links in macrolist.html not pointing to html "name" owing to
59 missing # in link names.
64 Line lengths and indents not always being respected in LIST.
67 CAPS OFF, called inline with \*[CAPS OFF] not working.
68 (Added two new inlines, \*[UC] and \*[LC], to do the job.)
71 When type is set after START but no docelement tag given, the
72 expected family ($DOC_FAMILY) and font (R) are not in effect.
75 When DOCTYPE is CHAPTER and .TITLE is omitted after .COLLATE, the
76 title vanishes from page headers/footers.
81 In collated documents, when using a different HEADER_FAMILY,
82 if BLANKPAGE <n> is given after COLLATE (but before START) all
83 subsequent text is set in the HEADER_FAMILY face rather than the
87 Document title identification string missing on endnotes pages when
88 the endnote marker style is LINE.
91 Space between endnote items on endnotes output pages not being
97 Invoking .FOOTERS isn't automatically putting pagination in the top
101 .PP_FONT after .COLLATE not being respected.
104 $SAVED_PP_FT not being fed to .FT in .PP after .COLLATE
107 .CODE OFF not always restoring previous family and font.
110 .ITEM, when not in a list, should do nothing.
115 ENDNOTES is not, by default, printing headers on endnotes pages.
118 Processing of the "Endnotes" title for the TOC is putting the
119 page number 1 line too high and not inserting leader.
122 Collated docs not respecting $PP_FT (it's picking up the font from
126 Docheader spacing sometimes depositing too much space between
127 various docheader elements in TYPEWRITE when DOCTYPE is DEFAULT or
131 When COLUMNS are on, subheads that are deferred to the next
132 column/page because there isn't enough room for the s/h and one
133 line of text are causing columns to overprint.
136 HDRFTR_LEFT printing one line too high when .HEADER_COLOR is used.
139 DOCTITLE link broken in the docs.
144 TOC formatting incorrect when the pound/number sign (#) is used in
148 [Documentation]: The docs erroneously state that TOC control macros
149 can be entered anywhere in a file prior to invoking TOC (they should
150 be entered before START).
153 Page numbers in the bottom margin being printed too low on output
154 pages preceding an invocation of COLLATE or macros that call it.
157 A superfluous blank, numbered page is being generated by COLLATE
158 (and macros that call it, namely TOC and ENDNOTES) when the last
159 line of output text before it falls on the last valid baseline of
160 an output page. Same thing happening occasionally with normal
161 document termination.
164 SHIFT_LIST not being observed when moving *back* to a shifted list;
165 the list is reverting to the left margin.
168 NUMBER_SUBHEADS not working with TYPESET when PARA_SPACE is on.
173 Missing #COLLATE register (accidentally wiped out) creating various
174 problems with .COLLATE (missing headers, leading increasing
175 slightly each time .COLLATE invoked, etc).
180 mom failing during groff build while processing
181 examples/typesetting.mom
184 Windows user reports COLLATE fails with a bottom margin error
190 Small error in the examples of output in the "Footnotes and
191 Punctuation" documentation section.
194 PAD_LIST_DIGITS/SHIFT_LIST broken when the enumerator type is
198 COLLATE wiping out <doc element>_FAMILY settings.
201 DOC_LEAD_ADJUST OFF not being observed when COLLATE is invoked.
204 DROPCAP setting the dropcap too high in initial paragraph after a
210 Owing to a superfluous "if" in the FONT macro, the "missing font"
211 routine is being silently ignored.
214 FOOTNOTE, used in nofill mode, adds a linebreak between the
215 marker and the text of the footnote.
221 ITALIC_MEANS_ITALIC not being respected when DOCTYPE LETTER.
224 Underlining of italic passages in PRINTSTYLE TYEPWRITE not spanning
228 PRINTSTYLE TYPEWRITE depositing extra space on new pages above quotes
232 MN doesn't accept OFF, QUIT, END, X, etc.
235 Margin notes that begin flush with the last line of text on a page
236 are running down the same page, instead of the remainder being
237 collected and output on the next.
240 MN sometimes erroneously dropping margin notes near the bottom of
241 a page, even when they'd fit. (MN-shifted not being removed by
245 MN_INIT not accepting "" args for default values.
248 Documentation for margin notes erroneously states that the first
249 (optional) argument can be either "ragged" or "symmetric". S/b
250 "RAGGED" or "SYMMETRIC".
253 Use of "" to tell MN_INIT to use the default for any specific
254 argument in the arg list broken.
257 Paragraphs that begin with a "smart" double quote when the
258 preceding paragraph has no corresponding close quote (i.e. dialogue
259 passages containing multiple paragraphs) are starting off with a
266 First baseline of type isn't going where it's supposed to when the
267 docheader is turned off.
273 Persistent error in html coding of docs (<nobr> tag).
279 Multiple line subheads near page bottom sometimes printing one line
280 of subhead at page bottom, and subsequent lines on next page.
283 Post-quote spacing still wonky when paragraph spacing is turned on.
284 ---Fixed--- (for good would be nice)
286 RULE not always resetting quad and quad value.
292 Some string definitions in om.tmac had superfluous spaces after
293 them (e.g. $COVERTITLE).
296 Spacing under quotes not correct when paragraph spacing is turned
301 First word of last line before footnotes is getting chopped.
307 HEADER_FAMILY not changing header family.
310 FAMILY, after COLLATE, not changing the family of all and every
314 Heads and subheads at the start of docs are printing one line lower
318 Gaps are appearing at the bottom of pages when there's a linebreak
319 followed by a subhead.
322 When LS is invoked after a single text line at the top of a page
323 containing a T_MARGIN (set with T_MARGIN or PAGE), mom is performing
324 spacing adjustments as if the first line doesn't exist.
327 Changes made to ALD and LS in version 1.2-c should not apply when
328 the document processing macros are used. There is a significant
329 conflict with the internal use of ALD when the docheader is only
330 one line long (as, for example, when DOCTYPE is CHAPTER).
331 ---Fixed, pending discovery of further conflicts---
336 Deferred footnotes not always being output, and groff complains
337 "ending diversion FN_OVERFLOW on exit."
340 First .LS call after a top margin has been set (with .T_MARGIN
341 or .PAGE) causing mom to move off the top margin baseline. Also,
342 there are conflicts between ALD, LS and T_MARGIN.
345 DROPCAP not properly restoring a running \*[COND] or \*[EXT] after
346 COND or EXT are given as arguments to DROPCAP.
352 .PAD not co-operating with mom's fontstyles, esp. when a full
353 family+fontstyle is given to .FT.
356 .DROPCAP -- ditto the above.
362 Footnote markers not resetting properly on new pages when COLUMNS
366 When overflowed footnote material is the only footnote material on
367 the page or in the column, no footnotes are output.
370 The AUTOLEAD used in FOOTNOTE not being disabled after FOOTNOTES
371 are output, or after PROCESS_FN_LEFTOVER/PROCESS_FN_IN_DIVER.
374 COL_NEXT and COL_BREAK, when invoked during the last column on a
375 page, are overprinting the last column instead of breaking to a new
376 page when there are footnotes in the column.
379 BR_AT_LINE_KERN not "break-and-spreading" text when used in
386 BLOCKQUOTE_FAMILY not changing blockquote family.
389 FOOTNOTE, whether in column mode or not, was using
390 #FN_COUNT_FOR_COLS for all footnote markers and handling.
393 Deferred footnotes that occured on the second to last page of
394 documents not printing.
400 Suite number in DOCTYPE LETTER not printing.
403 Footer elements not always vertically aligning.
406 Footer rule gap not always correctly observed.
409 Page numbering, when at top of page, not always falling on
413 Default page numbering style for COPYSTYLE draft is DIGIT instead
417 Hyphens around page numbering when style is DIGIT, ROMAN or ALPHA
418 not vertically centered.
421 EXT arg not working with DROPCAP.
424 DOC_QUAD not automatically set immediately after START
427 Tabs behaving erratically during document processing.
433 When DOCHEADER OFF <distance> is given, if <distance> falls short
434 of the top margin of running text, <distance> is not respected and
435 bottom margin falls low.
442 The " mark (doublequote), when entered while not in document
443 processing mode (i.e. just straightforward typesetting), outputs
444 nothing unless SMARQUOTES is invoked explicitly.
450 In document processing mode, docs that use *none* of the
451 docprocessing tags being ignored.
457 String tabs not picking up #L_MARGIN when #L_MARGIN not explicitly
458 set with L_MARGIN, PAPER or PAGE.
461 Infinite loop when B_MARGIN is set lower than FOOTER_MARGIN during
468 Mom partially broken when run with groff 1.19.1. Don't know yet
469 what this is, whether bad coding in mom, or a problem with 1.19.1.
470 Only solution for now: run mom 1.1.6 with groff 1.18.
473 Top margin of endnotes pages after the first endnotes page when
474 PRINTSTYLE is TYPEWRITE and endnotes single-spacing is turned on
475 falling one line too high.
481 DOCHEADER OFF (distance) not being respected.
484 FINIS killing ENDNOTES page numbering and heads.
490 Draft and revision not appearing in page headers.
493 \*[RULE] not working properly with indents and justified copy.
496 Post-epigraph spacing in TYPEWRITE causing some first pages to run too
500 Spacing of docheaders in TYPEWRITE not always consistent.
506 Blockquotes that span pages running too deep.
512 Footnotes not outputting on final page of document body when ENDNOTES
516 Pad not working properly and/or spitting out warnings when fill mode is
523 PAGENUM_STYLE being ignored unless entered after START.
529 String tabs not working as advertised when set from within other tabs.
532 .COLLATE sometimes depositing a header on the first page of a subsequent doc.
533 ---Fixed with workaround BREAK_QUOTE---
535 .UNDERLINE_QUOTES in PRINTSTYLE TYPEWRITE not on by default as advertised.
538 .TI not cooperating with other indent styles.
541 .WS and .SS not cooperating.
544 .RW and .EW not working.
547 ========================================================================
552 The indent macros from the typesetting macro set may not always
553 perform well in conjunction with the document processing macros,
554 especially when documents are set in columns. Mostly, this is the
555 result of inadequate testing. There are only so many "who'd want to
556 do this anyway?" scenarios I can think of on my own.
558 Epigraphs at the bottoms of page may sometimes run exactly one line
559 deeper than they should. The alternative (from my point of view) is
560 to have them run 1 line shorter than they should. The problem stems
561 from the fact the epigraphs are leaded differently than all other text,
562 and there's only so much adjusting that can be done with the whitespace
563 surrounding them to get them to bottom align. Since stylistically,
564 epigraphs should never appear at the bottom of a page/column without at
565 least some running text beneath them in order to make sense of the role
566 they play in page layout, this not likely to be fixed for some time.