• R/O
  • SSH

List of commits

No Tags

Frequently used words (click to add to your profile)

javac++androidlinuxc#objective-cqtwindows誰得cocoapythonphprubygameguibathyscaphec翻訳omegat計画中(planning stage)frameworktwittertestdomvb.netdirectxbtronarduinopreviewerゲームエンジン

Reference Documentation: PDF Publishing with GNU Troff

Rev. Time Author
d88f5243be1a tip 2022-03-30 21:37:24 Keith Marshall

Clean up extraneous trailing white-space.

* pdfmark.ms: Delete all white-space at end-of-line, throughout.

852dc6c1c5eb 2022-03-30 21:05:29 Keith Marshall

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.

a01868c021e5 2022-03-30 04:12:08 Keith Marshall

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.

dfbd1d88c3e4 2022-03-29 00:43:31 Keith Marshall

Preserve pdfhref link text colour specification.

* tmac/pdfmark.tmac (pdf*href)
(PDFHREF.TEXT.COLOR): ...this, by specifying it as an alias for...
(PDFHREF.TEXT.COLOUR): ...this; otherwise...
(PDFHREF.TEXT.COLOUR): ...this, by specifying it as an alias for...
(PDFHREF.TEXT.COLOR): ...this; otherwise...
(PDFHREF.TEXT.COLOR): ...this, by assignment of default value, and...
(PDFHREF.TEXT.COLOUR): ...this, as an alias for it.

00105ad9d397 2022-03-29 00:43:31 Keith Marshall

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.

c43427d15754 2022-03-29 00:43:31 Keith Marshall

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.

99ad4280a97e 2022-03-27 03:47:47 Keith Marshall

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.

8dd4f5977467 2022-03-25 07:11:04 Keith Marshall

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.

aae8df304ce0 2022-03-02 00:15:26 Keith Marshall

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 Add content to document them.
(Subsection Add content; document...
(XH-INIT, XN-INIT): ...this pair of user-definable macros.
(Subsection Add content; document...
(XH-UPDATE-TOC): ...this user-redefinable macro.
(Subsection 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.

651fc10b18c4 2022-02-27 23:19:43 Keith Marshall

Add discussion of "ms" document structure.

* pdfmark.ms (Section 3.1.1): Add content.
(Section 4): Add cross-reference label, named...
(pdf-publishing): ...thus.

5da678ba39a9 2022-02-27 20:07:02 Keith Marshall

Add footnote concerning choice of layout macro package.

* pdfmark.ms (Section 3): Add footnote #16.

df6b5959bbe9 2022-02-27 07:29:25 Keith Marshall

Correct page trap macro assignment syntax.

* pdfmark.ms (Section Insert missing initial period...
(pfdhref I -PT ...): ...introducing this macro usage example.

0c494e7d228c 2022-02-12 06:02:01 Keith Marshall

Document reference text custom formatting capabilities.

* pdfmark.ms (Section Replace and expand content; explain
operation of the default reference text formatting macro, and use of
'pdfhref K', to implement user-defined formatting keywords.

19f3178f8599 2022-02-12 06:02:01 Keith Marshall

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...
(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.

81770f396af0 2022-01-01 04:19:09 Keith Marshall

Describe automatic pdfhref annotation capability.

* pdmark.ms (Section Add content; introduce and explain
the default provisions, with examples, for the automatic generation
of reference text to describe pdfhref links.

4214632a723f 2021-12-31 22:00:29 Keith Marshall

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.

2eaeb060eea0 2021-12-21 03:51:59 Keith Marshall

Describe explicit pdfhref annotation capability.

* pdfmark.ms (Section Add content; show, by example, how
text within a link "hot-spot" may be explicitly specified at time of
link placement.

1c0c718c41ec 2021-12-16 01:16:24 Keith Marshall

Describe pdfhref colour management mechanism.

pdfmark.ms (Section Add content; state purpose and use of...

23efd5e57fd2 2021-11-19 01:13:06 Keith Marshall

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!

87af6703595c 2021-11-18 23:39:54 Keith Marshall

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.

787b45ec7250 2021-11-18 20:16:12 Keith Marshall

Set initial view to page width.

* pdfmark.ms (pageview): Add /View /FitH specification for /Page 1.

00f6ab8a34e3 2021-11-18 05:13:47 Keith Marshall

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.

13644a8333a3 2021-11-17 20:12:03 Keith Marshall

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.

01f6a374e1db 2021-11-16 01:02:39 Keith Marshall

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.

a3ca225afb1e 2021-11-15 18:40:30 Keith Marshall

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.

e9a2ee266ee7 2021-11-15 06:11:38 Keith Marshall

Implement publication system management infrastructure.

* configure.ac Makefile.in: New files; they support independent
publication per GNU autoconf build-system conventions.

446d9f138238 2021-11-15 05:17:45 Keith Marshall

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.