Imported Upstream version 1.22.4
[platform/upstream/groff.git] / contrib / mom / BUGS
1     -*- text -*-
2     Copyright 2004-2018 Free Software Foundation, Inc.
3
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.
7
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.
11
12 Post to the groff mailing list with bug reports, questions and
13 suggestions, or contact me directly at:
14
15     peter@schaffter.ca
16
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.
19
20 --Peter Schaffter
21
22 ====================================================================
23
24 Version 2.4
25 ===========
26 BIBLIOGRAPHY output broken.
27 ---Fixed---
28
29 Version 2.3
30 ===========
31 .PS/.PE not working at start of documents without a preceding .PP.
32 ---Fixed---
33
34 Output of .PS/.PE not centered correctly (the default).
35 ---Fixed---
36
37 Version 2.2-a
38 =============
39 Omitting postfixed digit from ROMAN/roman args to LIST not
40 generating warning.
41 ---Fixed---
42
43 FOOTERS causing infinite loop.
44 ---Fixed---
45
46 Version 2.2
47 ===========
48 COVERTITLE not picking up style params.
49 ---Fixed---
50
51 FORCE_RECTO and BLANKPAGES not co-operating.
52 ---Fixed---
53
54 TOC and LISTS_OF leading not being picked up and/or adjusted
55 properly.
56 ---Fixed---
57
58 PDF outline putting first doc ahead of TOC in PDF outline when
59 TOC is auto-relocated and COVER has the BLANKPAGE arg.
60 ---Fixed---
61
62 Version 2.1-b
63 =============
64 Toggling of pagination broken.
65 ---Fixed---
66
67 HEADERS_AND_FOOTERS printing footer at top of second page instead of
68 printing header unless FOOTER_ON_FIRST_PAGE is called.
69 ---Fixed---
70
71 Version 2.1-a
72 =============
73
74 Some part-by-part formatting changes to headers not being recognized
75 when global header options have been invoked.
76 ---Fixed---
77
78 Version 2.1
79 ===========
80
81 UNDERSCORE adding an extra space after underlined text.
82 ---Fixed---
83
84 bug #44903: 2 column output misplaced
85 ---Fixed---
86
87 PDF_IMAGE and FLOAT environments conflicting.
88 ---Fixed---
89
90 DROPCAP picking up color from last call to .gcolor.
91 ---Fixed---
92
93 PAD not working properly with mom's indent macros.
94 ---Fixed---
95
96 Margin notes not respecting differing recto-verso margins.
97 ---Fixed---
98
99 Graphical object macros not clearing fill/no-fill registers and
100 modes.
101 ---Fixed---
102
103 LIST ALPHA emitting a number register to output.
104 ---Fixed---
105
106 HEADER_PLAIN and FOOTER_PLAIN broken.
107 ---Fixed---
108
109 Version 2.0-c_1
110 ===============
111
112 .TS with no H causing FN_OVERFLOW warning when there are footnotes
113 on same page.
114 ---Fixed---
115
116 PDF_TARGET "descriptive text" not printing.
117 ---Fixed---
118
119 Version 2.0-c
120 =============
121
122 Endnotes page offset wrong if (BLOCK)QUOTE last macro before
123 ENDNOTES.
124 ---Fixed---
125
126 Character translation of diacritics from lowercase to caps broken.
127 ---Fixed---
128
129 Spacing not being restored (.ns/.rs) after a HEADING that falls at
130 the top of the page.
131 ---Fixed---
132
133 Version 2.0-b
134 =============
135
136 When line numbering is enabled, line numbers after QUOTE being reset
137 to '0'.
138 ---Fixed---
139
140 When line numbering is enabled for QUOTE and BLOCKQUOTE, style
141 params for line numbers not being applied.
142 ---Fixed---
143
144 TOC overprinting footer when it comes immediately after
145 BIBLIOGRAPHY.
146 ---Fixed---
147
148 TOC page numbers not printing when positioned at top of page.
149 ---Fixed---
150
151 TOC page numbers not always incrementing properly.
152 ---Fixed---
153
154 Version 2.0-a_1
155 ===============
156
157 QUOTE_INDENT not being respected in FLOAT.
158 ---Fixed---
159
160 SMARTQUOTES OFF broken.
161 ---Fixed---
162
163 DOCHEADER_LEAD being reset to default after first chapter.
164 ---Fixed---
165
166 Forced floats that fit on the page causing floats on the next page
167 to be treated as forced.
168 ---Fixed---
169
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.
172 ---Fixed---
173
174 Text after defered floats not being shimmed properly.
175 ---Fixed---
176
177 Tables that span pages overprinting first two lines of table on new
178 pages.
179 ---Fixed---
180
181 PDF_IMAGE not respecting .IL, .IR, or .IB.
182 ---Fixed---
183
184 AUTOLEAD not sticking after .START.
185 ---Fixed---
186
187 Version 2.0-a
188 =============
189
190 Footer not printing on first page when HEADERS_AND_FOOTERS enabled.
191 ---Fixed---
192
193 $AUTHOR string missing.
194 ---Fixed---
195
196 Version 2.0
197 ===========
198
199 tbl macros .TS/.TE not working unless inside a float.
200 ---Fixed---
201
202 Terminal period after page number(s) in refer items not always
203 printing.
204 ---Fixed---
205
206 ====================================================================
207
208 Version 1.6-a
209 ===========
210
211 Footnotes on last page of columnar docs before a TOC getting printed
212 at bottom of last column, not current column.
213 --Fixed---
214
215 HEADER_RULE OFF turning off headers completely.
216 ---Fixed---
217
218 FINIS depositing a blank final page when invoked too close to the
219 bottom margin.
220 ---Fixed---
221
222 Version 1-6
223 ===========
224
225 ENDNOTE_STRING_CAPS not disabling caps when arg given.
226 ---Fixed---
227
228 Superfluous blank line before paragraphs with paraheads.
229 ---Fixed---
230
231 Paraheads causing line numbering to overprint two line numbers.
232 ---Fixed---
233
234 Endless loop when DOC_LEAD_ADJUST is disabled. 
235 ---Fixed---
236
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.
240 --Fixed--
241
242 PRINTSTYLE TYPEWRITE not respecting TYPEWRITER_FAMILY when DOCTYPE
243 is LETTER.
244 ---Fixed---
245
246 Version 1.5-d
247 =============
248
249 ILX not quitting left indents set within ITEM.
250 ---Fixed----
251
252 Version 1.5-c
253 =============
254
255 COVER_COUNTS_PAGES incrementing pagenum by 1 too many.
256 ---Fixed---
257
258 HEADER/FOOTER_RECTO strings vanishing when the default CAPS option
259 is turned off.
260 ---Fixed---
261
262 TQ not removing QUAD arg from cleared tabs.
263 ---Fixed---
264
265 DROPCAP_OFF trap remaining in effect after dropcap has been
266 processed.
267 ---Fixed---
268
269 PARAHEAD_SIZE 0 resulting in 0-sized type!
270 ---Fixed---
271
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.
275 ---Fixed---
276
277 (DOC_)COVER requests annihilating families used in various document
278 elements if those families differ from the document's overall
279 family.
280 ---Fixed---
281
282 Covers and doccovers not always respecting null pagenumbering.
283 --Fixed---
284
285 Version 1.5-b
286 =============
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.---
292
293 COLLATE depositing a blank page if last output line before it falls
294 at the bottom of running text.
295 ---Fixed---
296
297 PRINTSTYLE TYPEWRITE not setting $FAMILY or $FONT or $PP_FT, with
298 consequences for COLLATE.
299 ---Fixed---
300
301 FOOTNOTE_MARKERS OFF not disabling footnote markers if used before
302 START.
303 ---Fixed---
304
305 1st footnotes with overflow vanishing altogether with an
306 "automatically ending diversion 'FN_OVERFLOW' on exit" warning.
307 ---Fixed---
308
309 Right hand margin notes vanishing when an RH margin note overflows
310 to the next output page.
311 ---Fixed (I think)---
312
313 Doc bug; \*[S<size>] escape incorrectly typed as \*S[<size>] in the
314 section on mom's inlines.
315 ---Fixed---
316
317 Paragraphs inside blockquotes not being spaced when .PARA_SPACE is
318 active.
319 ---Fixed---
320
321 Version 1.5-a
322 =============
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.
326 ---Fixed---
327
328 Version 1.5
329 ===========
330 DROPCAP not printing the dropcap letter at all in PRINTSTYLE
331 TYPEWRITE, nor when DROPCAP is used (accidentally?) after a valid
332 "first" paragraph.
333 ---FIXED---
334
335 DROPCAP going into an infinite loop when groff called with the
336 -Tascii switch.
337 ---FIXED---
338
339 SHIFT_LIST, when used anywhere but with a top-level list, is killing
340 list indents for every list level *returned to* afterward.
341 ---Fixed---
342
343 TOC page number for heads and subheads that get bumped to next page
344 (because of .ne) off by 1.
345 ---Fixed---
346
347 Moving backwards in nested lists not setting the proper indent.
348 ---Fixed---
349
350 Default linebreak color missing in om.tmac.
351 ---Fixed---
352
353 Some links in macrolist.html not pointing to html "name" owing to
354 missing # in link names.
355 ---Fixed---
356
357 Version 1.4-b
358 =============
359 Line lengths and indents not always being respected in LIST.
360 ---Fixed---
361
362 CAPS OFF, called inline with \*[CAPS OFF] not working.
363 (Added two new inlines, \*[UC] and \*[LC], to do the job.)
364 ---Fixed---
365
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.
368 ---Fixed---
369
370 When DOCTYPE is CHAPTER and .TITLE is omitted after .COLLATE, the
371 title vanishes from page headers/footers.
372 ---Fixed---
373
374 Version 1.4-a
375 =============
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
379 standard text face.
380 ---Fixed---
381
382 Document title identification string missing on endnotes pages when
383 the endnote marker style is LINE.
384 ---Fixed---
385
386 Space between endnote items on endnotes output pages not being
387 inserted.
388 ---Fixed---
389
390 Version 1.4
391 ===========
392 Invoking .FOOTERS isn't automatically putting pagination in the top
393 margin.
394 ---Fixed---
395
396 .PP_FONT after .COLLATE not being respected.
397 ---Fixed---
398
399 $SAVED_PP_FT not being fed to .FT in .PP after .COLLATE
400 ---Fixed---
401
402 .CODE OFF not always restoring previous family and font.
403 ---Fixed---
404
405 .ITEM, when not in a list, should do nothing.
406 ---Fixed---
407
408 Version 1.3-e_3
409 ===============
410 ENDNOTES is not, by default, printing headers on endnotes pages.
411 ---Fixed---
412
413 Processing of the "Endnotes" title for the TOC is putting the
414 page number 1 line too high and not inserting leader.
415 ---Fixed---
416
417 Collated docs not respecting $PP_FT (it's picking up the font from
418 the pagenumber font)
419 ---Fixed---
420
421 Docheader spacing sometimes depositing too much space between
422 various docheader elements in TYPEWRITE when DOCTYPE is DEFAULT or
423 NAMED.
424 ---Fixed---
425
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.
429 ---Fixed---
430
431 HDRFTR_LEFT printing one line too high when .HEADER_COLOR is used.
432 ---Fixed---
433
434 DOCTITLE link broken in the docs.
435 ---Fixed---
436
437 Version 1.3-e_2
438 ===============
439 TOC formatting incorrect when the pound/number sign (#) is used in
440 head elements.
441 ---Fixed---
442
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).
446 ---Fixed---
447
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.
450 ---Fixed---
451
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.
457 ---Fixed---
458
459 SHIFT_LIST not being observed when moving *back* to a shifted list;
460 the list is reverting to the left margin.
461 ---Fixed---
462
463 NUMBER_SUBHEADS not working with TYPESET when PARA_SPACE is on.
464 ---Fixed---
465
466 Version 1.3-e_1
467 ===============
468 Missing #COLLATE register (accidentally wiped out) creating various
469 problems with .COLLATE (missing headers, leading increasing
470 slightly each time .COLLATE invoked, etc).
471 ---Fixed---
472
473 Version 1.3-e
474 =============
475 mom failing during groff build while processing
476 examples/typesetting.mom
477 ---Fixed---
478
479 Windows user reports COLLATE fails with a bottom margin error
480 (generated by mom).
481 ---Fixed---
482
483 Version 1.3-d
484 =============
485 Small error in the examples of output in the "Footnotes and
486 Punctuation" documentation section.
487 ---Fixed----
488
489 PAD_LIST_DIGITS/SHIFT_LIST broken when the enumerator type is
490 roman or ROMAN.
491 ---Fixed---
492
493 COLLATE wiping out <doc element>_FAMILY settings.
494 ---Fixed---
495
496 DOC_LEAD_ADJUST OFF not being observed when COLLATE is invoked.
497 ---Fixed---
498
499 DROPCAP setting the dropcap too high in initial paragraph after a
500 COLLATE.
501 ---Fixed---
502
503 Version 1.3-c
504 =============
505 Owing to a superfluous "if" in the FONT macro, the "missing font"
506 routine is being silently ignored.
507 ---Fixed---
508
509 FOOTNOTE, used in nofill mode, adds a linebreak between the
510 marker and the text of the footnote.
511 ---Fixed---
512
513 Version 1.3-b
514 =============
515
516 ITALIC_MEANS_ITALIC not being respected when DOCTYPE LETTER.
517 ---Fixed---
518
519 Underlining of italic passages in PRINTSTYLE TYEPWRITE not spanning
520 pages.
521 ---Fixed---
522
523 PRINTSTYLE TYPEWRITE depositing extra space on new pages above quotes
524 that span pages.
525 ---Fixed---
526
527 MN doesn't accept OFF, QUIT, END, X, etc.
528 ---Fixed---
529
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.
533 ---Fixed---
534
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
537 MN-top.)
538 ---Fixed---
539
540 MN_INIT not accepting "" args for default values.
541 ---Fixed---
542
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".
546 ---Fixed---
547
548 Use of "" to tell MN_INIT to use the default for any specific
549 argument in the arg list broken.
550 ---Fixed---
551
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
555 close quote.
556 ---Fixed---
557
558 Version 1.3-a
559 =============
560
561 First baseline of type isn't going where it's supposed to when the
562 docheader is turned off.
563 ---Fixed---
564
565 Version 1.3
566 ===========
567
568 Persistent error in html coding of docs (<nobr> tag).
569 ---Fixed---
570
571 Version 1.2-f
572 ============
573
574 Multiple line subheads near page bottom sometimes printing one line
575 of subhead at page bottom, and subsequent lines on next page.
576 ---Fixed---
577
578 Post-quote spacing still wonky when paragraph spacing is turned on.
579 ---Fixed--- (for good would be nice)
580
581 RULE not always resetting quad and quad value.
582 ---Fixed---
583
584 Version 1.2-e
585 =============
586
587 Some string definitions in om.tmac had superfluous spaces after
588 them (e.g. $COVERTITLE).
589 ---Fixed---
590
591 Spacing under quotes not correct when paragraph spacing is turned
592 on.
593 ---Fixed---
594
595
596 First word of last line before footnotes is getting chopped.
597 ---Fixed---
598
599 Version 1.2-d
600 =============
601
602 HEADER_FAMILY not changing header family.
603 ---Fixed---
604
605 FAMILY, after COLLATE, not changing the family of all and every
606 page element or tag.
607 ---Fixed---
608
609 Heads and subheads at the start of docs are printing one line lower
610 than they should.
611 ---Fixed---
612  
613 Gaps are appearing at the bottom of pages when there's a linebreak
614 followed by a subhead.
615 ---Fixed---
616
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.
620 ---Fixed---
621
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---
627
628 Version 1.2-c
629 =============
630
631 Deferred footnotes not always being output, and groff complains
632 "ending diversion FN_OVERFLOW on exit."
633 ---Fixed---
634
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.
638 ---Fixed---
639
640 DROPCAP not properly restoring a running \*[COND] or \*[EXT] after
641 COND or EXT are given as arguments to DROPCAP.
642 ---Fixed---
643
644 Version 1.2
645 ===========
646
647 .PAD not co-operating with mom's fontstyles, esp. when a full
648 family+fontstyle is given to .FT.
649 ---Fixed---
650
651 .DROPCAP -- ditto the above.
652 ---Fixed---
653
654 Version 1.1.9
655 =============
656
657 Footnote markers not resetting properly on new pages when COLUMNS
658 is enabled.
659 ---Fixed---
660
661 When overflowed footnote material is the only footnote material on
662 the page or in the column, no footnotes are output.
663 ---Fixed---
664
665 The AUTOLEAD used in FOOTNOTE not being disabled after FOOTNOTES
666 are output, or after PROCESS_FN_LEFTOVER/PROCESS_FN_IN_DIVER.
667 ---Fixed---
668
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.
672 ---Fixed---
673
674 BR_AT_LINE_KERN not "break-and-spreading" text when used in
675 justified copy.
676 ---Fixed---
677
678 Version 1.1.8
679 =============
680
681 BLOCKQUOTE_FAMILY not changing blockquote family.
682 ---Fixed---
683
684 FOOTNOTE, whether in column mode or not, was using
685 #FN_COUNT_FOR_COLS for all footnote markers and handling.
686 ---Fixed---
687
688 Deferred footnotes that occured on the second to last page of
689 documents not printing.
690 ---Fixed---
691
692 Version 1.1.7-a
693 ===============
694
695 Suite number in DOCTYPE LETTER not printing.
696 ---Fixed---
697
698 Footer elements not always vertically aligning.
699 ---Fixed---
700
701 Footer rule gap not always correctly observed.
702 ---Fixed---
703
704 Page numbering, when at top of page, not always falling on
705 HDRFTR_MARGIN.
706 ---Fixed---
707
708 Default page numbering style for COPYSTYLE draft is DIGIT instead
709 of roman.
710 ---Fixed---
711
712 Hyphens around page numbering when style is DIGIT, ROMAN or ALPHA
713 not vertically centered.
714 ---Fixed---
715
716 EXT arg not working with DROPCAP.
717 ---Fixed---
718
719 DOC_QUAD not automatically set immediately after START
720 ---Fixed--
721
722 Tabs behaving erratically during document processing.
723 ---Fixed---
724
725 Version 1.1.7
726 =============
727
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.
731 ---Fixed---
732
733
734 Version 1.1.6-e
735 ===============
736
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.
740 ---Fixed---
741
742 Version 1.1.6-c
743 ===============
744
745 In document processing mode, docs that use *none* of the
746 docprocessing tags being ignored.
747 ---Fixed---
748
749 Version 1.1.6-b
750 ===============
751
752 String tabs not picking up #L_MARGIN when #L_MARGIN not explicitly
753 set with L_MARGIN, PAPER or PAGE.
754 ---Fixed---
755
756 Infinite loop when B_MARGIN is set lower than FOOTER_MARGIN during
757 doc processing.
758 ---Fixed---
759
760 Version 1.1.6-a
761 ===============
762
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.
766 ----Fixed---
767
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.
771 ---Fixed---
772
773 Version 1.1.6
774 =============
775
776 DOCHEADER OFF (distance) not being respected.
777 ---Fixed---
778
779 FINIS killing ENDNOTES page numbering and heads.
780 ---Fixed---
781
782 Version 1.1.5
783 =============
784
785 Draft and revision not appearing in page headers.
786 ---Fixed---
787
788 \*[RULE] not working properly with indents and justified copy.
789 ---Fixed---
790
791 Post-epigraph spacing in TYPEWRITE causing some first pages to run too
792 deep.
793 ---Fixed---
794
795 Spacing of docheaders in TYPEWRITE not always consistent.
796 ---Fixed---
797
798 Version 1.1.4
799 =============
800
801 Blockquotes that span pages running too deep.
802 ---Fixed---
803
804 Version 1.1.3
805 =============
806
807 Footnotes not outputting on final page of document body when ENDNOTES
808 is invoked.
809 ---Fixed---
810
811 Pad not working properly and/or spitting out warnings when fill mode is
812 on.
813 ---Fixed---
814
815 Version 1.1.2
816 =============
817
818 PAGENUM_STYLE being ignored unless entered after START.
819 ---Fixed---
820
821 Version 1.1
822 ===========
823
824 String tabs not working as advertised when set from within other tabs.
825 ---Fixed---
826
827 .COLLATE sometimes depositing a header on the first page of a subsequent doc.
828 ---Fixed with workaround BREAK_QUOTE---
829
830 .UNDERLINE_QUOTES in PRINTSTYLE TYPEWRITE not on by default as advertised.
831 ---Fixed---
832
833 .TI not cooperating with other indent styles.
834 ---Fixed---
835
836 .WS and .SS not cooperating.
837 ---Fixed---
838
839 .RW and .EW not working.
840 ---Fixed---
841
842 ========================================================================
843
844 KNOWN PROBLEMS
845 --------------
846
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.
852
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.
862