2 Copyright 2004-2018 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:
17 If writing me directly, please include the word "groff" or "mom" in
18 the Subject line or you risk my spam filters nuking your message.
22 ====================================================================
26 BIBLIOGRAPHY output broken.
31 .PS/.PE not working at start of documents without a preceding .PP.
34 Output of .PS/.PE not centered correctly (the default).
39 Omitting postfixed digit from ROMAN/roman args to LIST not
43 FOOTERS causing infinite loop.
48 COVERTITLE not picking up style params.
51 FORCE_RECTO and BLANKPAGES not co-operating.
54 TOC and LISTS_OF leading not being picked up and/or adjusted
58 PDF outline putting first doc ahead of TOC in PDF outline when
59 TOC is auto-relocated and COVER has the BLANKPAGE arg.
64 Toggling of pagination broken.
67 HEADERS_AND_FOOTERS printing footer at top of second page instead of
68 printing header unless FOOTER_ON_FIRST_PAGE is called.
74 Some part-by-part formatting changes to headers not being recognized
75 when global header options have been invoked.
81 UNDERSCORE adding an extra space after underlined text.
84 bug #44903: 2 column output misplaced
87 PDF_IMAGE and FLOAT environments conflicting.
90 DROPCAP picking up color from last call to .gcolor.
93 PAD not working properly with mom's indent macros.
96 Margin notes not respecting differing recto-verso margins.
99 Graphical object macros not clearing fill/no-fill registers and
103 LIST ALPHA emitting a number register to output.
106 HEADER_PLAIN and FOOTER_PLAIN broken.
112 .TS with no H causing FN_OVERFLOW warning when there are footnotes
116 PDF_TARGET "descriptive text" not printing.
122 Endnotes page offset wrong if (BLOCK)QUOTE last macro before
126 Character translation of diacritics from lowercase to caps broken.
129 Spacing not being restored (.ns/.rs) after a HEADING that falls at
136 When line numbering is enabled, line numbers after QUOTE being reset
140 When line numbering is enabled for QUOTE and BLOCKQUOTE, style
141 params for line numbers not being applied.
144 TOC overprinting footer when it comes immediately after
148 TOC page numbers not printing when positioned at top of page.
151 TOC page numbers not always incrementing properly.
157 QUOTE_INDENT not being respected in FLOAT.
160 SMARTQUOTES OFF broken.
163 DOCHEADER_LEAD being reset to default after first chapter.
166 Forced floats that fit on the page causing floats on the next page
167 to be treated as forced.
170 Forced floats not advancing on the page after output if the float is
171 forced to the next page, causing running text to overprint.
174 Text after defered floats not being shimmed properly.
177 Tables that span pages overprinting first two lines of table on new
181 PDF_IMAGE not respecting .IL, .IR, or .IB.
184 AUTOLEAD not sticking after .START.
190 Footer not printing on first page when HEADERS_AND_FOOTERS enabled.
193 $AUTHOR string missing.
199 tbl macros .TS/.TE not working unless inside a float.
202 Terminal period after page number(s) in refer items not always
206 ====================================================================
211 Footnotes on last page of columnar docs before a TOC getting printed
212 at bottom of last column, not current column.
215 HEADER_RULE OFF turning off headers completely.
218 FINIS depositing a blank final page when invoked too close to the
225 ENDNOTE_STRING_CAPS not disabling caps when arg given.
228 Superfluous blank line before paragraphs with paraheads.
231 Paraheads causing line numbering to overprint two line numbers.
234 Endless loop when DOC_LEAD_ADJUST is disabled.
237 In the case where the list doesn't fit the page, -mom inserts
238 an extra page with one word and a warning about "environment stack
239 underflow" and then continues on the following page.
242 PRINTSTYLE TYPEWRITE not respecting TYPEWRITER_FAMILY when DOCTYPE
249 ILX not quitting left indents set within ITEM.
255 COVER_COUNTS_PAGES incrementing pagenum by 1 too many.
258 HEADER/FOOTER_RECTO strings vanishing when the default CAPS option
262 TQ not removing QUAD arg from cleared tabs.
265 DROPCAP_OFF trap remaining in effect after dropcap has been
269 PARAHEAD_SIZE 0 resulting in 0-sized type!
272 When DOC_LEAD is called to change document leading in collated docs,
273 document leading steadily increases by small amounts at each
274 subsequent call to COLLATE.
277 (DOC_)COVER requests annihilating families used in various document
278 elements if those families differ from the document's overall
282 Covers and doccovers not always respecting null pagenumbering.
287 Use of \E*[UC] and \E*[LC] inside strings for HDRFTR_RECTO and
288 HDRFTR_VERSO breaking headers.
289 ---Not fixable. CAPS option added to HDRFTR_RECTO/VERSO to
290 accomodate situations where capitalized reserved
291 strings(\*[$TITLE], \*[$AUTHOR], etc) are desired.---
293 COLLATE depositing a blank page if last output line before it falls
294 at the bottom of running text.
297 PRINTSTYLE TYPEWRITE not setting $FAMILY or $FONT or $PP_FT, with
298 consequences for COLLATE.
301 FOOTNOTE_MARKERS OFF not disabling footnote markers if used before
305 1st footnotes with overflow vanishing altogether with an
306 "automatically ending diversion 'FN_OVERFLOW' on exit" warning.
309 Right hand margin notes vanishing when an RH margin note overflows
310 to the next output page.
311 ---Fixed (I think)---
313 Doc bug; \*[S<size>] escape incorrectly typed as \*S[<size>] in the
314 section on mom's inlines.
317 Paragraphs inside blockquotes not being spaced when .PARA_SPACE is
323 Indenting of references (collected with .REF) on endnotes pages when
324 endnote numbers are right-aligned appears to be backwards; the
325 first line of the reference is indented more than the second.
330 DROPCAP not printing the dropcap letter at all in PRINTSTYLE
331 TYPEWRITE, nor when DROPCAP is used (accidentally?) after a valid
335 DROPCAP going into an infinite loop when groff called with the
339 SHIFT_LIST, when used anywhere but with a top-level list, is killing
340 list indents for every list level *returned to* afterward.
343 TOC page number for heads and subheads that get bumped to next page
344 (because of .ne) off by 1.
347 Moving backwards in nested lists not setting the proper indent.
350 Default linebreak color missing in om.tmac.
353 Some links in macrolist.html not pointing to html "name" owing to
354 missing # in link names.
359 Line lengths and indents not always being respected in LIST.
362 CAPS OFF, called inline with \*[CAPS OFF] not working.
363 (Added two new inlines, \*[UC] and \*[LC], to do the job.)
366 When type is set after START but no docelement tag given, the
367 expected family ($DOC_FAMILY) and font (R) are not in effect.
370 When DOCTYPE is CHAPTER and .TITLE is omitted after .COLLATE, the
371 title vanishes from page headers/footers.
376 In collated documents, when using a different HEADER_FAMILY,
377 if BLANKPAGE <n> is given after COLLATE (but before START) all
378 subsequent text is set in the HEADER_FAMILY face rather than the
382 Document title identification string missing on endnotes pages when
383 the endnote marker style is LINE.
386 Space between endnote items on endnotes output pages not being
392 Invoking .FOOTERS isn't automatically putting pagination in the top
396 .PP_FONT after .COLLATE not being respected.
399 $SAVED_PP_FT not being fed to .FT in .PP after .COLLATE
402 .CODE OFF not always restoring previous family and font.
405 .ITEM, when not in a list, should do nothing.
410 ENDNOTES is not, by default, printing headers on endnotes pages.
413 Processing of the "Endnotes" title for the TOC is putting the
414 page number 1 line too high and not inserting leader.
417 Collated docs not respecting $PP_FT (it's picking up the font from
421 Docheader spacing sometimes depositing too much space between
422 various docheader elements in TYPEWRITE when DOCTYPE is DEFAULT or
426 When COLUMNS are on, subheads that are deferred to the next
427 column/page because there isn't enough room for the s/h and one
428 line of text are causing columns to overprint.
431 HDRFTR_LEFT printing one line too high when .HEADER_COLOR is used.
434 DOCTITLE link broken in the docs.
439 TOC formatting incorrect when the pound/number sign (#) is used in
443 [Documentation]: The docs erroneously state that TOC control macros
444 can be entered anywhere in a file prior to invoking TOC (they should
445 be entered before START).
448 Page numbers in the bottom margin being printed too low on output
449 pages preceding an invocation of COLLATE or macros that call it.
452 A superfluous blank, numbered page is being generated by COLLATE
453 (and macros that call it, namely TOC and ENDNOTES) when the last
454 line of output text before it falls on the last valid baseline of
455 an output page. Same thing happening occasionally with normal
456 document termination.
459 SHIFT_LIST not being observed when moving *back* to a shifted list;
460 the list is reverting to the left margin.
463 NUMBER_SUBHEADS not working with TYPESET when PARA_SPACE is on.
468 Missing #COLLATE register (accidentally wiped out) creating various
469 problems with .COLLATE (missing headers, leading increasing
470 slightly each time .COLLATE invoked, etc).
475 mom failing during groff build while processing
476 examples/typesetting.mom
479 Windows user reports COLLATE fails with a bottom margin error
485 Small error in the examples of output in the "Footnotes and
486 Punctuation" documentation section.
489 PAD_LIST_DIGITS/SHIFT_LIST broken when the enumerator type is
493 COLLATE wiping out <doc element>_FAMILY settings.
496 DOC_LEAD_ADJUST OFF not being observed when COLLATE is invoked.
499 DROPCAP setting the dropcap too high in initial paragraph after a
505 Owing to a superfluous "if" in the FONT macro, the "missing font"
506 routine is being silently ignored.
509 FOOTNOTE, used in nofill mode, adds a linebreak between the
510 marker and the text of the footnote.
516 ITALIC_MEANS_ITALIC not being respected when DOCTYPE LETTER.
519 Underlining of italic passages in PRINTSTYLE TYEPWRITE not spanning
523 PRINTSTYLE TYPEWRITE depositing extra space on new pages above quotes
527 MN doesn't accept OFF, QUIT, END, X, etc.
530 Margin notes that begin flush with the last line of text on a page
531 are running down the same page, instead of the remainder being
532 collected and output on the next.
535 MN sometimes erroneously dropping margin notes near the bottom of
536 a page, even when they'd fit. (MN-shifted not being removed by
540 MN_INIT not accepting "" args for default values.
543 Documentation for margin notes erroneously states that the first
544 (optional) argument can be either "ragged" or "symmetric". S/b
545 "RAGGED" or "SYMMETRIC".
548 Use of "" to tell MN_INIT to use the default for any specific
549 argument in the arg list broken.
552 Paragraphs that begin with a "smart" double quote when the
553 preceding paragraph has no corresponding close quote (i.e. dialogue
554 passages containing multiple paragraphs) are starting off with a
561 First baseline of type isn't going where it's supposed to when the
562 docheader is turned off.
568 Persistent error in html coding of docs (<nobr> tag).
574 Multiple line subheads near page bottom sometimes printing one line
575 of subhead at page bottom, and subsequent lines on next page.
578 Post-quote spacing still wonky when paragraph spacing is turned on.
579 ---Fixed--- (for good would be nice)
581 RULE not always resetting quad and quad value.
587 Some string definitions in om.tmac had superfluous spaces after
588 them (e.g. $COVERTITLE).
591 Spacing under quotes not correct when paragraph spacing is turned
596 First word of last line before footnotes is getting chopped.
602 HEADER_FAMILY not changing header family.
605 FAMILY, after COLLATE, not changing the family of all and every
609 Heads and subheads at the start of docs are printing one line lower
613 Gaps are appearing at the bottom of pages when there's a linebreak
614 followed by a subhead.
617 When LS is invoked after a single text line at the top of a page
618 containing a T_MARGIN (set with T_MARGIN or PAGE), mom is performing
619 spacing adjustments as if the first line doesn't exist.
622 Changes made to ALD and LS in version 1.2-c should not apply when
623 the document processing macros are used. There is a significant
624 conflict with the internal use of ALD when the docheader is only
625 one line long (as, for example, when DOCTYPE is CHAPTER).
626 ---Fixed, pending discovery of further conflicts---
631 Deferred footnotes not always being output, and groff complains
632 "ending diversion FN_OVERFLOW on exit."
635 First .LS call after a top margin has been set (with .T_MARGIN
636 or .PAGE) causing mom to move off the top margin baseline. Also,
637 there are conflicts between ALD, LS and T_MARGIN.
640 DROPCAP not properly restoring a running \*[COND] or \*[EXT] after
641 COND or EXT are given as arguments to DROPCAP.
647 .PAD not co-operating with mom's fontstyles, esp. when a full
648 family+fontstyle is given to .FT.
651 .DROPCAP -- ditto the above.
657 Footnote markers not resetting properly on new pages when COLUMNS
661 When overflowed footnote material is the only footnote material on
662 the page or in the column, no footnotes are output.
665 The AUTOLEAD used in FOOTNOTE not being disabled after FOOTNOTES
666 are output, or after PROCESS_FN_LEFTOVER/PROCESS_FN_IN_DIVER.
669 COL_NEXT and COL_BREAK, when invoked during the last column on a
670 page, are overprinting the last column instead of breaking to a new
671 page when there are footnotes in the column.
674 BR_AT_LINE_KERN not "break-and-spreading" text when used in
681 BLOCKQUOTE_FAMILY not changing blockquote family.
684 FOOTNOTE, whether in column mode or not, was using
685 #FN_COUNT_FOR_COLS for all footnote markers and handling.
688 Deferred footnotes that occured on the second to last page of
689 documents not printing.
695 Suite number in DOCTYPE LETTER not printing.
698 Footer elements not always vertically aligning.
701 Footer rule gap not always correctly observed.
704 Page numbering, when at top of page, not always falling on
708 Default page numbering style for COPYSTYLE draft is DIGIT instead
712 Hyphens around page numbering when style is DIGIT, ROMAN or ALPHA
713 not vertically centered.
716 EXT arg not working with DROPCAP.
719 DOC_QUAD not automatically set immediately after START
722 Tabs behaving erratically during document processing.
728 When DOCHEADER OFF <distance> is given, if <distance> falls short
729 of the top margin of running text, <distance> is not respected and
730 bottom margin falls low.
737 The " mark (doublequote), when entered while not in document
738 processing mode (i.e. just straightforward typesetting), outputs
739 nothing unless SMARQUOTES is invoked explicitly.
745 In document processing mode, docs that use *none* of the
746 docprocessing tags being ignored.
752 String tabs not picking up #L_MARGIN when #L_MARGIN not explicitly
753 set with L_MARGIN, PAPER or PAGE.
756 Infinite loop when B_MARGIN is set lower than FOOTER_MARGIN during
763 Mom partially broken when run with groff 1.19.1. Don't know yet
764 what this is, whether bad coding in mom, or a problem with 1.19.1.
765 Only solution for now: run mom 1.1.6 with groff 1.18.
768 Top margin of endnotes pages after the first endnotes page when
769 PRINTSTYLE is TYPEWRITE and endnotes single-spacing is turned on
770 falling one line too high.
776 DOCHEADER OFF (distance) not being respected.
779 FINIS killing ENDNOTES page numbering and heads.
785 Draft and revision not appearing in page headers.
788 \*[RULE] not working properly with indents and justified copy.
791 Post-epigraph spacing in TYPEWRITE causing some first pages to run too
795 Spacing of docheaders in TYPEWRITE not always consistent.
801 Blockquotes that span pages running too deep.
807 Footnotes not outputting on final page of document body when ENDNOTES
811 Pad not working properly and/or spitting out warnings when fill mode is
818 PAGENUM_STYLE being ignored unless entered after START.
824 String tabs not working as advertised when set from within other tabs.
827 .COLLATE sometimes depositing a header on the first page of a subsequent doc.
828 ---Fixed with workaround BREAK_QUOTE---
830 .UNDERLINE_QUOTES in PRINTSTYLE TYPEWRITE not on by default as advertised.
833 .TI not cooperating with other indent styles.
836 .WS and .SS not cooperating.
839 .RW and .EW not working.
842 ========================================================================
847 The indent macros from the typesetting macro set may not always
848 perform well in conjunction with the document processing macros,
849 especially when documents are set in columns. Mostly, this is the
850 result of inadequate testing. There are only so many "who'd want to
851 do this anyway?" scenarios I can think of on my own.
853 Epigraphs at the bottoms of page may sometimes run exactly one line
854 deeper than they should. The alternative (from my point of view) is
855 to have them run 1 line shorter than they should. The problem stems
856 from the fact the epigraphs are leaded differently than all other text,
857 and there's only so much adjusting that can be done with the whitespace
858 surrounding them to get them to bottom align. Since stylistically,
859 epigraphs should never appear at the bottom of a page/column without at
860 least some running text beneath them in order to make sense of the role
861 they play in page layout, this not likely to be fixed for some time.