pdfroff(1) manual page
pdfroff(7) manual page
groff_toc(7) manual page
The set of package files, which appear below, represent snapshots of the state of groff-pdfmark development on the date indicated, in the form YYYYMMDD.N, (with 'N' as a serialization index, to accommodate multiple snapshots in any given day), as the effective version number for the snapshot release. The content of the various package files comprises:
groff-pdfmark-YYYYMMDD.N-src.tar.xz | A snapshot of the repository content, with the addition of generated configure script, and GNU format ChangeLog, as committed on the specified date |
groff-pdfmark-YYYYMMDD.N-posix-bin.tar.xz | A generated executable copy of the pdfroff shell script, suitable for deployment on POSIX compliant operating systems |
groff-pdfmark-YYYYMMDD.N-win32-bin.tar.xz | A generated executable copy of the pdfroff shell script, suitable for deployment on MS-Windows operating systems, (with a suitable Bourne shell execution environment) |
groff-pdfmark-YYYYMMDD.N-doc.tar.xz | Generated copies of the pdfmark.pdf, and pdfroff.1.pdf documentation files, accompanied by the source for pdfmark.pdf, offered as an example |
groff-pdfmark-YYYYMMDD.N-man.tar.xz | Generated copies of associated manual pages ... currently pdfroff.1 alone |
groff-pdfmark-YYYYMMDD.N-tmac.tar.xz | groff macro files which are maintained as groff-pdfmark components; (excludes s.tmac, which must be as recent as that incorporated into the groff-pdfmark repository) |
Filename | Size | Time | Download count |
groff-pdfmark-20240409.1-doc.tar.xz | 410.95 k | 2024-04-10 06:23:53 | 8 |
groff-pdfmark-20240409.1-src.tar.xz | 173.22 k | 2024-04-10 06:23:53 | 10 |
groff-pdfmark-20240409.1-win32-bin.tar.xz | 9.27 k | 2024-04-10 06:23:53 | 9 |
groff-pdfmark-20240409.1-posix-bin.tar.xz | 9.09 k | 2024-04-10 06:23:53 | 7 |
groff-pdfmark-20240409.1-shasum.gpg | 1.23 k | 2024-04-10 06:23:52 | 14 |
groff-pdfmark-20240409.1-tmac.tar.xz | 29.97 k | 2024-04-10 06:23:52 | 9 |
groff-pdfmark-20240409.1-man.tar.xz | 6.9 k | 2024-04-10 06:23:52 | 12 |
groff-pdfmark-20230406.1-win32-bin.tar.xz | 8.41 k | 2024-04-10 06:21:31 | 25 |
groff-pdfmark-20230406.1-tmac.tar.xz | 24.53 k | 2024-04-10 06:21:18 | 18 |
groff-pdfmark-20230406.1-src.tar.xz | 143.72 k | 2024-04-10 06:21:08 | 28 |
Downloaded tarballs for groff‑pdfmark‑YYYYMMDD.N may be verified, by checking against the SHA512 checksums which have been enumerated within the corresponding validation file, groff‑pdfmark‑YYYYMMDD.N‑shasum.gpg, (which may, itself, be verified by GPG signature, since it has been signed with my public key, available from OpenPGP public key servers, with footprint C19E C018 1547 DE50 E1D4 8F53 C0AD 36C6 347E 5A3F), by running the command:
$ gpg --decrypt groff-pdfmark-YYYYMMDD.N-shasum.gpg | shasum --check --ignore-missing
(note that the --ignore-missing option is not strictly required, but is recommended when only a subset of the tarballs for the corresponding groff‑pdfmark‑YYYYMMDD.N release has been downloaded).
Unpacking of groff‑pdfmark‑YYYYMMDD.N‑src.tar.xz will create a free-standing source tree, below the current working directory; unpacking each of the other package tarballs will reproduce the structure of the 'bin' and 'share' subtrees of a standard installation, with the current working directory substituted in place of the normal installation prefix.
Rev. | Time | Author | Message RSS |
8a1e9107 | 2024-08-06 20:33:01 | Keith Marshall | Remove inappropriate discretionary hyphenation points. *... |
26e9e465 | 2024-08-06 16:40:09 | Keith Marshall | Drop synopsis section from groff_toc.7 manual page. * ma... |
cd1fd35c | 2024-08-06 03:29:42 | Keith Marshall | Use boiler-plate to standardize manpdf fallback macros. ... |
7d5268a4 | 2024-07-20 06:12:47 | Keith Marshall | Add a convenience makefile rule to build everything. * M... |
84b87df2 | 2024-07-13 21:42:22 | Keith Marshall | Correct a malformed manpage reference. * man/pdfroff.1.m... |
1c50f0f8 | 2024-07-13 21:04:36 | Keith Marshall | Configure project-hosted manpage URI references. * tmac/... |
36edf76d | 2024-07-13 05:31:14 | Keith Marshall | Differentiate groff-pdfmark and groff package versions. ... |
41c30d06 | 2024-07-13 03:07:51 | Keith Marshall | Support internal references to manpage headings. * tmac/... |
33ab865a | 2024-07-13 02:28:57 | Keith Marshall | Remap some special escape tokens in sanitized text. * tm... |
071092ad | 2024-07-09 06:47:29 | Keith Marshall | Use explicit naming for manpage outline reference marks. ... |
The ten most recent commits to the repository are summarized below; for the full log, please refer to the ChangeLog page.
- 2024-08-05 Keith Marshall <address@hidden>
- Remove inappropriate discretionary hyphenation points.
- * man/pdfroff.1.man man/pdfroff.7.man man/groff_toc.man (.UR):
- Delete '\%' prefix from URI argument; it was intended to prevent
- hyphenation, but it actually allows insertion of a discretionary
- hyphen, and line break, within the bracketted URI output string,
- between the opening angle bracket and the URI itself.
- 2024-08-05 Keith Marshall <address@hidden>
- Drop synopsis section from groff_toc.7 manual page.
- * man/groff_toc.7.man: Add paragraph marks.
- (Synopsis): Delete section; fold its relevant content into...
- (Usage): ...this alternative section, as appropriate; correct...
- (.toc error): ...this malformed syntax specification.
- (Authors): Some minor wording improvement.
- 2024-08-05 Keith Marshall <address@hidden>
- Use boiler-plate to standardize manpdf fallback macros.
- * Makefile.in (AWK, GREP, USORT): New macros, defined by...
- * configure.ac (AC_PROG_AWK, AC_PROG_GREP): ...these, and...
- (SORT, UNIQ): ...these AC_PATH_PROG substitutions.
- * Makefile.in (manpdf_fallbacks): New macro; it represents...
- * man/manpdf-fallbacks.in: ...this new file; it implements in-line
- fallbacks for each non-standard -manpdf extension macro; it also
- implements a fallback for groff-1.23's .MR macro, for use on any
- platform which lacks it, and defines host URI mappings for PDF
- renditions of project-local manual pages.
- * Makefile.in (manpage_update_script): Add substitutions for...
- (@ENUMERATE_MR_REFERENCES@, @IMPORT_LOCAL_FALLBACK_MACROS@): ...each
- of these place-holders; appropriate content is generated by...
- (usort_awk, refgen_script, refmap_script, mxmap_script, mxgen_script):
- ...these new in-line scripts, extracting content as appropriate, from
- the boiler-plate defined within the file which is represented by...
- (manpdf_fallbacks): ...this new macro; it is used by...
- (%.mr, %.mx): ...these new build rules; make them prerequisites...
- (all-manpages, all-pdf-manpages): ...for both of these.
- * man/pdfroff.1.man man/pdfroff.7.man man/groff_toc.man
- (@ENUMERATE_MR_REFERENCES@, @IMPORT_LOCAL_FALLBACK_MACROS@): Use them
- in place of, and to avoid duplication of, content abstracted from...
- * man/manpdf-fallbacks.in: ...here.
- * tmac/anpdf.tmac (MX-HOST): Make it consistent with usage as...
- * man/manpdf-fallbacks.in: ...specified here.
- 2024-07-19 Keith Marshall <address@hidden>
- Add a convenience makefile rule to build everything.
- * Makefile.in (all-inclusive): New build goal; it incorporates...
- (all, all-manpages, all-pdf-manpages): ...all of these.
- 2024-07-13 Keith Marshall <address@hidden>
- Correct a malformed manpage reference.
- * man/pdfroff.1.man (.MR gs 1): Should use...
- (.MR gs @MAN1EXT@): ...this preferred form; correct it.
- 2024-07-13 Keith Marshall <address@hidden>
- Configure project-hosted manpage URI references.
- * tmac/anpdf.tmac (MX-HOST): Rename original macro, as...
- (MR-HOST): ...this; update references accordingly, and then...
- (MX-HOST): ...redefine as new; this replacement version now maps
- individual manpage references to specific MR-HOST URI indicies.
- * configure.ac (MANPAGE_URI_ROOT, MANPAGE_URI_PATH): New AC_SUBST
- variables; together, they specify the groff-pdfmark project URI.
- * Makefile.in (MANPAGE_URI_ROOT, MANPAGE_URI_PATH): Use them to...
- (MR_HOST_3_URI_ROOT, MR_HOST_3_URI_PATH): ...define these new macros,
- respectively; substitute their values into generated manpages, via...
- (manpage_update_script): ...this internal sed script, mapping to...
- (MR_HOST_3_URI, MR_HOST_3_DIR): ...these tags, respectively.
- * man/pdfroff.7.man
- * man/groff_toc.7.man [groff && MR-HOST defined]: Expand...
- (MR_HOST_3_URI, MR_HOST_3_DIR): ...these substitution tags, through...
- (MR-HOST-3-URI): ...this troff string, assigning to MR-HOST index 3.
- (pdfroff.@MAN1EXT@): Map it to MR-HOST index 3, using...
- (MX-HOST): ...this.
- * man/pdfroff.7.man (groff_pdfmark.@MAN7EXT@): Also map this, and...
- (groff_toc.@MAN7EXT@): ...this, to MR-HOST index 3, again using...
- (MX-HOST): ...this.
- 2024-07-12 Keith Marshall <address@hidden>
- Differentiate groff-pdfmark and groff package versions.
- * configure.ac (AC_INIT): Specify YY.MM style groff-pdfmark version.
- (GROFF_PACKAGE_VERSION): New AC_SUBST variable; define it to represent
- the groff version, with which groff-pdfmark is nominally associated.
- (MANPAGE_DATE_FORMAT): New AC_SUBST variable; define it to specify
- the default date format for use in groff-pdfmark manual pages.
- * Makefile.in (PACKAGE_BASE_VERSION): Use GROFF_PACKAGE_VERSION.
- (MANPAGE_DATE): Use MANPAGE_DATE_FORMAT.
- 2024-07-12 Keith Marshall <address@hidden>
- Support internal references to manpage headings.
- * tmac/anpdf.tmac (SR, RK): New macros; define them in terms of...
- (anpdf-ref-heading, anpdf-ref-kern): ...these new macros, and...
- (anpdf-ref-kern-list): ...this new string.
- * man/pdfroff.1.man man/pdfroff.7.man
- * man/groff_toc.7.man [!manpdf] (SR, RK): Define fallbacks.
- (SR, RK): Use them.
- 2024-07-12 Keith Marshall <address@hidden>
- Remap some special escape tokens in sanitized text.
- * tmac/sanitize.tmac (sanitize:scan-space-token.remap): New macro;
- define it, intending it exclusively for conditional internal use by...
- (sanitize) ["\ ", "\~", "\0"]: ...this, to substitute ASCII SP.
- (sanitize) ["\-"]: Explicitly substitute ASCII hyphen-minus.
- 2024-07-08 Keith Marshall <address@hidden>
- Use explicit naming for manpage outline reference marks.
- * tmac/anpdf.tmac (anpdf-reload-man): Increase...
- (PDFHREF.VIEW.LEADING): ...this, for manpage title reference marks.
- (anpdf-ref, anpdf-ref-outline): New macros; together, they generate
- explicit reference mark names, to associate with manpage headings.
- (anpdf-sh-wrapper): Use them.