Tags
No Tags

Frequently used words (click to add to your profile)

javac++androidlinuxc#windowsobjective-ccocoa誰得qtpythonphprubygameguibathyscaphec計画中(planning stage)翻訳omegatframeworktwitterdomtestvb.netdirectxゲームエンジンbtronarduinopreviewer

Documentation Links

pdfroff(1) manual page
pdfroff(7) manual page
groff_toc(7) manual page

Recent Development Activity

2024-08-06
2024-06-14
2024-04-26
2024-04-11
2024-04-10

Recent Wiki Changes

2024-04-25
2023-04-09
2023-02-15

Wiki Guide

Side Bar

PDF Document Publication with GNU Troff

Release Files

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.xzA 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.xzA generated executable copy of the pdfroff shell script, suitable for deployment on POSIX compliant operating systems
groff-pdfmark-YYYYMMDD.N-win32-bin.tar.xzA 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.xzGenerated 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.xzGenerated copies of associated manual pages ... currently pdfroff.1 alone
groff-pdfmark-YYYYMMDD.N-tmac.tar.xzgroff 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)

FilenameSizeTimeDownload count
groff-pdfmark-20240409.1-doc.tar.xz410.95 k2024-04-10 06:23:538
groff-pdfmark-20240409.1-src.tar.xz173.22 k2024-04-10 06:23:5310
groff-pdfmark-20240409.1-win32-bin.tar.xz9.27 k2024-04-10 06:23:539
groff-pdfmark-20240409.1-posix-bin.tar.xz9.09 k2024-04-10 06:23:537
groff-pdfmark-20240409.1-shasum.gpg1.23 k2024-04-10 06:23:5214
groff-pdfmark-20240409.1-tmac.tar.xz29.97 k2024-04-10 06:23:529
groff-pdfmark-20240409.1-man.tar.xz6.9 k2024-04-10 06:23:5212
groff-pdfmark-20230406.1-win32-bin.tar.xz8.41 k2024-04-10 06:21:3125
groff-pdfmark-20230406.1-tmac.tar.xz24.53 k2024-04-10 06:21:1818
groff-pdfmark-20230406.1-src.tar.xz143.72 k2024-04-10 06:21:0828

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.

Recent Commits

Rev.TimeAuthorMessage RSS
8a1e91072024-08-06 20:33:01Keith MarshallRemove inappropriate discretionary hyphenation points. *...
26e9e4652024-08-06 16:40:09Keith MarshallDrop synopsis section from groff_toc.7 manual page. * ma...
cd1fd35c2024-08-06 03:29:42Keith MarshallUse boiler-plate to standardize manpdf fallback macros. ...
7d5268a42024-07-20 06:12:47Keith MarshallAdd a convenience makefile rule to build everything. * M...
84b87df22024-07-13 21:42:22Keith MarshallCorrect a malformed manpage reference. * man/pdfroff.1.m...
1c50f0f82024-07-13 21:04:36Keith MarshallConfigure project-hosted manpage URI references. * tmac/...
36edf76d2024-07-13 05:31:14Keith MarshallDifferentiate groff-pdfmark and groff package versions. ...
41c30d062024-07-13 03:07:51Keith MarshallSupport internal references to manpage headings. * tmac/...
33ab865a2024-07-13 02:28:57Keith MarshallRemap some special escape tokens in sanitized text. * tm...
071092ad2024-07-09 06:47:29Keith MarshallUse explicit naming for manpage outline reference marks. ...

ChangeLog

The ten most recent commits to the repository are summarized below; for the full log, please refer to the ChangeLog page.

  1. 2024-08-05 Keith Marshall <address@hidden>
  2. Remove inappropriate discretionary hyphenation points.
  3. * man/pdfroff.1.man man/pdfroff.7.man man/groff_toc.man (.UR):
  4. Delete '\%' prefix from URI argument; it was intended to prevent
  5. hyphenation, but it actually allows insertion of a discretionary
  6. hyphen, and line break, within the bracketted URI output string,
  7. between the opening angle bracket and the URI itself.
  8. 2024-08-05 Keith Marshall <address@hidden>
  9. Drop synopsis section from groff_toc.7 manual page.
  10. * man/groff_toc.7.man: Add paragraph marks.
  11. (Synopsis): Delete section; fold its relevant content into...
  12. (Usage): ...this alternative section, as appropriate; correct...
  13. (.toc error): ...this malformed syntax specification.
  14. (Authors): Some minor wording improvement.
  15. 2024-08-05 Keith Marshall <address@hidden>
  16. Use boiler-plate to standardize manpdf fallback macros.
  17. * Makefile.in (AWK, GREP, USORT): New macros, defined by...
  18. * configure.ac (AC_PROG_AWK, AC_PROG_GREP): ...these, and...
  19. (SORT, UNIQ): ...these AC_PATH_PROG substitutions.
  20. * Makefile.in (manpdf_fallbacks): New macro; it represents...
  21. * man/manpdf-fallbacks.in: ...this new file; it implements in-line
  22. fallbacks for each non-standard -manpdf extension macro; it also
  23. implements a fallback for groff-1.23's .MR macro, for use on any
  24. platform which lacks it, and defines host URI mappings for PDF
  25. renditions of project-local manual pages.
  26. * Makefile.in (manpage_update_script): Add substitutions for...
  27. (@ENUMERATE_MR_REFERENCES@, @IMPORT_LOCAL_FALLBACK_MACROS@): ...each
  28. of these place-holders; appropriate content is generated by...
  29. (usort_awk, refgen_script, refmap_script, mxmap_script, mxgen_script):
  30. ...these new in-line scripts, extracting content as appropriate, from
  31. the boiler-plate defined within the file which is represented by...
  32. (manpdf_fallbacks): ...this new macro; it is used by...
  33. (%.mr, %.mx): ...these new build rules; make them prerequisites...
  34. (all-manpages, all-pdf-manpages): ...for both of these.
  35. * man/pdfroff.1.man man/pdfroff.7.man man/groff_toc.man
  36. (@ENUMERATE_MR_REFERENCES@, @IMPORT_LOCAL_FALLBACK_MACROS@): Use them
  37. in place of, and to avoid duplication of, content abstracted from...
  38. * man/manpdf-fallbacks.in: ...here.
  39. * tmac/anpdf.tmac (MX-HOST): Make it consistent with usage as...
  40. * man/manpdf-fallbacks.in: ...specified here.
  41. 2024-07-19 Keith Marshall <address@hidden>
  42. Add a convenience makefile rule to build everything.
  43. * Makefile.in (all-inclusive): New build goal; it incorporates...
  44. (all, all-manpages, all-pdf-manpages): ...all of these.
  45. 2024-07-13 Keith Marshall <address@hidden>
  46. Correct a malformed manpage reference.
  47. * man/pdfroff.1.man (.MR gs 1): Should use...
  48. (.MR gs @MAN1EXT@): ...this preferred form; correct it.
  49. 2024-07-13 Keith Marshall <address@hidden>
  50. Configure project-hosted manpage URI references.
  51. * tmac/anpdf.tmac (MX-HOST): Rename original macro, as...
  52. (MR-HOST): ...this; update references accordingly, and then...
  53. (MX-HOST): ...redefine as new; this replacement version now maps
  54. individual manpage references to specific MR-HOST URI indicies.
  55. * configure.ac (MANPAGE_URI_ROOT, MANPAGE_URI_PATH): New AC_SUBST
  56. variables; together, they specify the groff-pdfmark project URI.
  57. * Makefile.in (MANPAGE_URI_ROOT, MANPAGE_URI_PATH): Use them to...
  58. (MR_HOST_3_URI_ROOT, MR_HOST_3_URI_PATH): ...define these new macros,
  59. respectively; substitute their values into generated manpages, via...
  60. (manpage_update_script): ...this internal sed script, mapping to...
  61. (MR_HOST_3_URI, MR_HOST_3_DIR): ...these tags, respectively.
  62. * man/pdfroff.7.man
  63. * man/groff_toc.7.man [groff && MR-HOST defined]: Expand...
  64. (MR_HOST_3_URI, MR_HOST_3_DIR): ...these substitution tags, through...
  65. (MR-HOST-3-URI): ...this troff string, assigning to MR-HOST index 3.
  66. (pdfroff.@MAN1EXT@): Map it to MR-HOST index 3, using...
  67. (MX-HOST): ...this.
  68. * man/pdfroff.7.man (groff_pdfmark.@MAN7EXT@): Also map this, and...
  69. (groff_toc.@MAN7EXT@): ...this, to MR-HOST index 3, again using...
  70. (MX-HOST): ...this.
  71. 2024-07-12 Keith Marshall <address@hidden>
  72. Differentiate groff-pdfmark and groff package versions.
  73. * configure.ac (AC_INIT): Specify YY.MM style groff-pdfmark version.
  74. (GROFF_PACKAGE_VERSION): New AC_SUBST variable; define it to represent
  75. the groff version, with which groff-pdfmark is nominally associated.
  76. (MANPAGE_DATE_FORMAT): New AC_SUBST variable; define it to specify
  77. the default date format for use in groff-pdfmark manual pages.
  78. * Makefile.in (PACKAGE_BASE_VERSION): Use GROFF_PACKAGE_VERSION.
  79. (MANPAGE_DATE): Use MANPAGE_DATE_FORMAT.
  80. 2024-07-12 Keith Marshall <address@hidden>
  81. Support internal references to manpage headings.
  82. * tmac/anpdf.tmac (SR, RK): New macros; define them in terms of...
  83. (anpdf-ref-heading, anpdf-ref-kern): ...these new macros, and...
  84. (anpdf-ref-kern-list): ...this new string.
  85. * man/pdfroff.1.man man/pdfroff.7.man
  86. * man/groff_toc.7.man [!manpdf] (SR, RK): Define fallbacks.
  87. (SR, RK): Use them.
  88. 2024-07-12 Keith Marshall <address@hidden>
  89. Remap some special escape tokens in sanitized text.
  90. * tmac/sanitize.tmac (sanitize:scan-space-token.remap): New macro;
  91. define it, intending it exclusively for conditional internal use by...
  92. (sanitize) ["\ ", "\~", "\0"]: ...this, to substitute ASCII SP.
  93. (sanitize) ["\-"]: Explicitly substitute ASCII hyphen-minus.
  94. 2024-07-08 Keith Marshall <address@hidden>
  95. Use explicit naming for manpage outline reference marks.
  96. * tmac/anpdf.tmac (anpdf-reload-man): Increase...
  97. (PDFHREF.VIEW.LEADING): ...this, for manpage title reference marks.
  98. (anpdf-ref, anpdf-ref-outline): New macros; together, they generate
  99. explicit reference mark names, to associate with manpage headings.
  100. (anpdf-sh-wrapper): Use them.

Latest updated Tickets

No tickets