2022-03-30  Keith Marshall  <address@hidden>
 
         Clean up extraneous trailing white-space.
 
         * pdfmark.ms: Delete all white-space at end-of-line, throughout.
 
 2022-03-30  Keith Marshall  <address@hidden>
 
         Avoid keeps for widow and orphan line control.
 
         * pdfmark.ms (KS, KE): Avoid using these for widow and orphan line
         control; in particular do not include any section heading within such
         a construct, as it may result in incorrect page numbering within the
         generated table of contents; instead, use "ne" requests, with...
         (\n[PD]u): ...this form for paragraph distance references used
         consistently, in preference to...
         (\n(PDu): ...this.
 
 2022-03-29  Keith Marshall  <address@hidden>
 
         Implement a more effective TOC generation strategy.
 
         * tmac/toc.tmac: New file; it implements a basic, extensible,
         table of contents generator macro framework; use it...
         * pdfmark.ms (XH-UPDATE-TOC): ...here; modify it to generate...
         (pdfmark.toc): ...this new file, subsequently included and used by...
         (toc.outline, toc.refmark, toc.pageref): ...these new document-local
         toc.tmac extending macros, to generate TOC in-line, superseding...
         (TC): ...use of this spdf.tmac macro; delete reference.
         [TOC] (PDFHREF.TEXT.COLOUR): Set it to match...
         (\n[.m]): ...this.
 
         * Makefile.in (pdfmark.pdf): Update dependencies, requiring...
         (pdfmark.toc): ...this new intermediate file; add rules to generate
         it, by performing a separate pre-processing pass over...
         (pdfmark.ms): ...this primary source file.
         (clean): Remove "*.toc" files.
 
 2022-03-28  Keith Marshall  <address@hidden>
 
         Preserve pdfhref link text colour specification.
 
         * tmac/pdfmark.tmac (pdf*href)
         [d PDFHREF.TEXT.COLOUR & !d PDFHREF.TEXT.COLOR]: Redefine...
         (PDFHREF.TEXT.COLOR): ...this, by specifying it as an alias for...
         (PDFHREF.TEXT.COLOUR): ...this; otherwise...
         [d PDFHREF.TEXT.COLOR & !d PDFHREF.TEXT.COLOUR]: Redefine...
         (PDFHREF.TEXT.COLOUR): ...this, by specifying it as an alias for...
         (PDFHREF.TEXT.COLOR): ...this; otherwise...
         [!d PDFHREF.TEXT.COLOUR & !d PDFHREF.TEXT.COLOR]: Redefine...
         (PDFHREF.TEXT.COLOR): ...this, by assignment of default value, and...
         (PDFHREF.TEXT.COLOUR): ...this, as an alias for it.
 
 2022-03-28  Keith Marshall  <address@hidden>
 
         Maintain separation of in-document pdfroff hints.
 
         * pdfroff.sh (pdfroff-option:set): Quote collected hints, as returned
         by sed, to preserve separating newlines; without this, all hints will
         be evaluated as if representing a single, possibly malformed command,
         which is unlikely to have the desired effect.
 
 2022-03-28  Keith Marshall  <address@hidden>
 
         Always set the PHASE indicator when formatting body text.
 
         * pdfroff.sh (BODY_FORMAT): Do not clear it, when...
         [--no-toc-relocation]: ...this option is active; we require...
         [-rPHASE=2]: ...this, even when PHASE=1 is omitted.
 
 2022-03-26  Keith Marshall  <address@hidden>
 
         Improve handling of pdfbookmark names.
 
         * tmac/pdfmark.tmac (pdfbookmark): Define...
         (PDFBOOKMARK.NAME): ...this, on entry, rather than on final output.
         (pdfbookmark) [-N]: Add support; suppress automatic name generation,
         and use specified bookmark name instead; separate name sequencing from
         bookmark cache sequencing; transfer automatic name sequencing to...
         (pdf:bm.ix): ...this new auto-incrementing register, retaining...
         (pdf:bm.nr): ...this for cache sequencing; make it auto-increment.
 
 2022-03-24  Keith Marshall  <address@hidden>
 
         Place outline references before generating TOC entries.
 
         * tmac/spdf.tmac (spdf:XH.format, spdf:XN.format): Do not call...
         (XH-UPDATE-TOC): ...this directly; instead, call it indirectly from...
         (spdf:XH.finalize): ...here, whence call it after invoking...
         (pdfhref O): ...this.
 
 2022-03-01  Keith Marshall  <address@hidden>
 
         Document "ms" section headings support features.
 
         * pdfmark.ms (Section 3.1.2): Update and expand; refer to...
         (XH, XN): ...this pair of section heading specification macros.
         (Subsection 3.1.2.1): Add content to document them.
         (Subsection 3.1.2.2): Add content; document...
         (XH-INIT, XN-INIT): ...this pair of user-definable macros.
         (Subsection 3.1.2.3): Add content; document...
         (XH-UPDATE-TOC): ...this user-redefinable macro.
         (Subsection 3.1.2.4): Add content; document...
         (XH-REPLACEMENT, XN-REPLACEMENT): ...these user-redefinable macros.
 
         * tmac/spdf.tmac (XN): Correct comment typo; should refer to...
         (NH <n>): ...this, rather than implied use after self.
 
 2022-02-27  Keith Marshall  <address@hidden>
 
         Add discussion of "ms" document structure.
 
         * pdfmark.ms (Section 3.1.1): Add content.
         (Section 4): Add cross-reference label, named...
         (pdf-publishing): ...thus.
 
 2022-02-27  Keith Marshall  <address@hidden>
 
         Add footnote concerning choice of layout macro package.
 
         * pdfmark.ms (Section 3): Add footnote #16.
 
 2022-02-26  Keith Marshall  <address@hidden>
 
         Correct page trap macro assignment syntax.
 
         * pdfmark.ms (Section 2.5.6.1): Insert missing initial period...
         (pfdhref I -PT ...): ...introducing this macro usage example.
 
 2022-02-11  Keith Marshall  <address@hidden>
 
         Document reference text custom formatting capabilities.
 
         * pdfmark.ms (Section 2.5.5.4): Replace and expand content; explain
         operation of the default reference text formatting macro, and use of
         'pdfhref K', to implement user-defined formatting keywords.
 
 2022-02-11  Keith Marshall  <address@hidden>
 
         Add support for custom location keyword interpretation.
 
         * pdfmark.tmac (pdf*href.format): Generalize keyword interpreter.
         (pdf*href-K): New internal macro; it implements the interpreter for
         "pdfhref K ..." macro calls; use it to map location keywords to...
         (PDFHREF.FILEREF, PDFHREF.PAGEREF, PDFHREF.SECTREF): ...these; thus...
         (pdf*href.format.file, pdf*href.format.page, pdf*href.format.section):
         ...these become redundant; delete them.
 
         * pdfmark.ms (pdfhref K): Document it; add keeps, to avoid potential
         widow lines in following paragraphs.
 
 2021-12-31  Keith Marshall  <address@hidden>
 
         Describe automatic pdfhref annotation capability.
 
         * pdmark.ms (Section 2.5.5.3): Add content; introduce and explain
         the default provisions, with examples, for the automatic generation
         of reference text to describe pdfhref links.
 
 2021-12-31  Keith Marshall  <address@hidden>
 
         Fix a "pdfhref" arguments evaluation bug.
 
         * pdfmark.tmac: Squeeze unnecessary vertical space.
         (pdf*href) [.$]: Do not delay assignment of arguments to...
         (PDFHREF.DESC): ...this; deferring the evaluation of \$*, until...
         (pdf*href.format): ...here, is too late; it interprets the wrong \$*,
         resulting in failure of the intended arguments override feature;
         additionally, quote PDFHREF.DESC, only when NOT overridden.
 
 2021-12-20  Keith Marshall  <address@hidden>
 
         Describe explicit pdfhref annotation capability.
 
         * pdfmark.ms (Section 2.5.5.2): Add content; show, by example, how
         text within a link "hot-spot" may be explicitly specified at time of
         link placement.
 
 2021-12-15  Keith Marshall  <address@hidden>
 
         Describe pdfhref colour management mechanism.
 
         pdfmark.ms (Section 2.5.5.1): Add content; state purpose and use of...
         (PDFHREF.BORDER, PDFHREF.COLOUR, PDFHREF.TEXT.COLOUR): ...these.
 
 2021-11-18  Keith Marshall  <address@hidden>
 
         Correct a statement with inverted logic.
 
         * pdfmark.ms (Section 2.5.6): Insert missing "not", in opening
         paragraph; links become problematic when they do not function as
         expected, not when they do!
 
 2021-11-18  Keith Marshall  <address@hidden>
 
         Avoid unwanted line-breaks at hard hyphenation points.
 
         * pdfmark.ms: Ensure that all explicitly hyphenated words are prefixed
         by "\%", to make hard hyphens non-breaking.
 
 2021-11-18  Keith Marshall  <address@hidden>
 
         Set initial view to page width.
 
         * pdfmark.ms (pageview): Add /View /FitH specification for /Page 1.
 
 2021-11-17  Keith Marshall  <address@hidden>
 
         Widow and orphan line adjustments.
 
         * pdfmark.ms: Add vertical space reservations, or specify keeps, as
         appropriate, to avoid widow lines and orphaned examples, when a short
         paragraph precedes an example; adjust paragraph spacing, as necessary
         around keeps.
 
 2021-11-17  Keith Marshall  <address@hidden>
 
         Sentence space adjustments at footnote markers.
 
         * pdfmark.ms (FZ): New document-local macro; define it such that it
         behaves as FE, augmented to preserve the effect of sentence spacing,
         when invoked with arguments having end-of-sentence punctuation.
         [GhostScript 8.14.\**, MSYS.\**]: Follow with FS ... FZ.
 
 2021-11-15  Keith Marshall  <address@hidden>
 
         Adjust footnote marker position over punctuation.
 
         * pdfmark.ms ["," or "." followed by "\**"]: Suppress horizontal
         spacing in way of the punctuation mark, causing the footnote marker to
         be positioned above it.
 
 2021-11-15  Keith Marshall  <address@hidden>
 
         Correct paragraph spacing irregularities.
 
         * pdfmark.ms [QS followed by IP, QS followed by LD]
         [DE followed by QE, QE followed by LP]: Each of these combinations
         results in doubling of the normal inter-paragraph vertical spacing at
         the location of the combination; suppress the excess.
 
 2021-11-14  Keith Marshall  <address@hidden>
 
         Implement publication system management infrastructure.
 
         * configure.ac Makefile.in: New files; they support independent
         publication per GNU autoconf build-system conventions.
 
 2021-11-14  Keith Marshall  <address@hidden>
 
         Create free-standing groff-pdfmark publication system.
 
         * cover.ms pdfmark.ms pdfroff.1.man
         * pdfroff.sh: Import from GNU Troff project.
 
         * tmac/pdfmark.tmac tmac/s.tmac tmac/sanitize.tmac tmac/spdf.tmac
         * artwork/gnu.eps: Import, and relocate.