contrib/mom/BUGS

   1 Assume that anything that doesn't work or behaves oddly is a bug.
   2 The documentation should be taken as the authoritative source for
   3 how things ought to be.
   4
   5 Post to the groff mailing list (groff@ffii.org) with bug reports,
   6 questions and suggestions, or contact me directly at:
   7
   8     df191@ncf.ca
   9
  10 If writing me directly, please include the word "groff" or "mom" in
  11 the Subject line or you risk my spam filter nuking your message.
  12 Also, please--no html email.  That, too, gets nuked.
  13
  14 --Peter Schaffter
  15
  16 ========================================================================
  17
  18 Version 1.1.7-a
  19 ===============
  20
  21 Suite number in DOCTYPE LETTER not printing.
  22 ---Fixed---
  23
  24 Footer elements not always vertically aligning.
  25 ---Fixed---
  26
  27 Footer rule gap not always correctly observed.
  28 ---Fixed---
  29
  30 Page numbering, when at top of page, not always falling on
  31 HDRFTR_MARGIN.
  32 ---Fixed---
  33
  34 Default page numbering style for COPYSTYLE draft is DIGIT instead
  35 of roman.
  36 ---Fixed---
  37
  38 Hyphens around page numbering when style is DIGIT, ROMAN or ALPHA
  39 not vertically centered.
  40 ---Fixed---
  41
  42 EXT arg not working with DROPCAP.
  43 ---Fixed---
  44
  45 DOC_QUAD not automatically set immediately after START
  46 ---Fixed--
  47
  48 Tabs behaving erratically during document processing.
  49 ---Fixed---
  50
  51 Version 1.1.7
  52 =============
  53
  54 When DOCHEADER OFF <distance> is given, if <distance> falls short
  55 of the top margin of running text, <distance> is not respected and
  56 bottom margin falls low.
  57 ---Fixed---
  58
  59
  60 Version 1.1.6-e
  61 ===============
  62
  63 The " mark (doublequote), when entered while not in document
  64 processing mode (i.e. just straightforward typesetting), outputs
  65 nothing unless SMARTQUOTES is invoked explicitly.
  66 ---Fixed---
  67
  68 Version 1.1.6-c
  69 ===============
  70
  71 In document processing mode, docs that use *none* of the
  72 docprocessing tags being ignored.
  73 ---Fixed---
  74
  75 Version 1.1.6-b
  76 ===============
  77
  78 String tabs not picking up #L_MARGIN when #L_MARGIN not explicitly
  79 set with L_MARGIN, PAPER or PAGE.
  80 ---Fixed---
  81
  82 Infinite loop when B_MARGIN is set lower than FOOTER_MARGIN during
  83 doc processing.
  84 ---Fixed---
  85
  86 Version 1.1.6-a
  87 ===============
  88
  89 Mom partially broken when run with groff 1.19.1.  Don't know yet
  90 what this is, whether bad coding in mom, or a problem with 1.19.1.
  91 Only solution for now: run mom 1.1.6 with groff 1.18.
  92 ----Fixed---
  93
  94 Top margin of endnotes pages after the first endnotes page when
  95 PRINTSTYLE is TYPEWRITE and endnotes single-spacing is turned on
  96 falling one line too high.
  97 ---Fixed---
  98
  99 Version 1.1.6
 100 =============
 101
 102 DOCHEADER OFF (distance) not being respected.
 103 ---Fixed---
 104
 105 FINIS killing ENDNOTES page numbering and heads.
 106 ---Fixed---
 107
 108 Version 1.1.5
 109 =============
 110
 111 Draft and revision not appearing in page headers.
 112 ---Fixed---
 113
 114 \*[RULE] not working properly with indents and justified copy.
 115 ---Fixed---
 116
 117 Post-epigraph spacing in TYPEWRITE causing some first pages to run too
 118 deep.
 119 ---Fixed---
 120
 121 Spacing of docheaders in TYPEWRITE not always consistent.
 122 ---Fixed---
 123
 124 Version 1.1.4
 125 =============
 126
 127 Blockquotes that span pages running too deep.
 128 ---Fixed---
 129
 130 Version 1.1.3
 131 =============
 132
 133 Footnotes not outputting on final page of document body when ENDNOTES
 134 is invoked.
 135 ---Fixed---
 136
 137 Pad not working properly and/or spitting out warnings when fill mode is
 138 on.
 139 ---Fixed---
 140
 141 Version 1.1.2
 142 =============
 143
 144 PAGENUM_STYLE being ignored unless entered after START.
 145 ---Fixed---
 146
 147 Version 1.1
 148 ===========
 149
 150 String tabs not working as advertised when set from within other tabs.
 151 ---Fixed---
 152
 153 .COLLATE sometimes depositing a header on the first page of a subsequent doc.
 154 ---Fixed with workaround BREAK_QUOTE---
 155
 156 .UNDERLINE_QUOTES in PRINTSTYLE TYPEWRITE not on by default as advertised.
 157 ---Fixed---
 158
 159 .TI not cooperating with other indent styles.
 160 ---Fixed---
 161
 162 .WS and .SS not cooperating.
 163 ---Fixed---
 164
 165 .RW and .EW not working.
 166 ---Fixed---
 167
 168 ========================================================================
 169
 170 KNOWN PROBLEMS
 171 --------------
 172
 173 The indent macros from the typesetting macro set may not always
 174 perform well in conjunction with the document processing macros,
 175 especially when documents are set in columns.  Mostly, this is the
 176 result of inadequate testing.  There are only so many "who'd want to
 177 do this anyway?" scenarios I can think of on my own.
 178
 179 Epigraphs at the bottoms of page may sometimes run exactly one line
 180 deeper than they should.  The alternative (from my point of view) is
 181 to have them run 1 line shorter than they should.  The problem stems
 182 from the fact the epigraphs are leaded differently than all other text,
 183 and there's only so much adjusting that can be done with the whitespace
 184 surrounding them to get them to bottom align.  Since stylistically,
 185 epigraphs should never appear at the bottom of a page/column without at
 186 least some running text beneath them in order to make sense of the role
 187 they play in page layout, this not likely to be fixed for some time.
 188