Reference Documentation: PDF Publishing with GNU Troff
Revisão | 1a0c70b44d8a2df2831f898e8104af69819c2d7f (tree) |
---|---|
Hora | 2024-04-11 19:44:05 |
Autor | Keith Marshall <keith@user...> |
Commiter | Keith Marshall |
A minor pdfroff.1 manpage correction.
* pdfroff.1.man (TH): s/groff/groff-pdfmark/
(AUTHORS): Refer to author's "OSDN web-site", in preference
to "OSDN site".
* Makefile.in (MANPAGE_DATE): New user overridable variable,
specifying the publication date for all generated manual pages;
define it, by shell substitution, to reflect current date.
(manpage_update_script): Use it, in substitution for...
(MDATE): ...this field value.
@@ -5,7 +5,7 @@ | ||
5 | 5 | # Makefile template for independent Groff Pdfmark.PDF publication |
6 | 6 | # |
7 | 7 | # Written by Keith Marshall <keith.d.marshall@ntlworld.com> |
8 | -# Copyright (C) 2021-2023, Keith Marshall | |
8 | +# Copyright (C) 2021-2024, Keith Marshall | |
9 | 9 | # |
10 | 10 | # --------------------------------------------------------------------------- |
11 | 11 | # |
@@ -251,12 +251,19 @@ | ||
251 | 251 | datarootdir := @datarootdir@ |
252 | 252 | pdfdocdir := @docdir@ |
253 | 253 | |
254 | +# The script will normally insert the current date into each | |
255 | +# generated manpage, but we provide the user with a mechanism | |
256 | +# to override this default behaviour, by specifying another | |
257 | +# date via a MANPAGE_DATE='d Month YYYY' argument. | |
258 | +# | |
259 | +MANPAGE_DATE := $(shell date +"%e %B %Y") | |
260 | + | |
254 | 261 | # The requisite sed script itself, is specified as: |
255 | 262 | # |
256 | 263 | override manpage_update_script = \ |
257 | 264 | -e 's!@VERSION@!$(PACKAGE_VERSION)!' \ |
258 | - -e 's!@MDATE@!$(shell date +"%e %B %Y")!' \ | |
259 | 265 | -e 's!@PDFDOCDIR@!${pdfdocdir}!' \ |
266 | + -e 's!@MDATE@!$(MANPAGE_DATE)!' \ | |
260 | 267 | -e 's!@MAN\([1-9]\)EXT@!\1!g' |
261 | 268 | |
262 | 269 | # This script is run, on specific demand only, to regenerate |
@@ -280,7 +287,7 @@ | ||
280 | 287 | # require a patch to an-old.tmac, because, as shipped, it does |
281 | 288 | # not behave as described in groff_man(7), w.r.t. "-rFT". |
282 | 289 | # |
283 | -MAN2PDF_FLAGS := -dpaper=a4 -P-pa4 -rFT=0-0.75i -rCS=1 -rCT=1 | |
290 | +MAN2PDF_FLAGS := -dpaper=a4 -P-pa4 -dMF=R -rFT=0-0.75i -rCS=1 -rCT=1 | |
284 | 291 | |
285 | 292 | # It is convenient to use pdfroff, to generate PDF from manpage |
286 | 293 | # source; when doing so, no reference dictionary is needed, but |
@@ -1,4 +1,4 @@ | ||
1 | -.TH pdfroff @MAN1EXT@ "@MDATE@" "groff @VERSION@" | |
1 | +.TH pdfroff @MAN1EXT@ "@MDATE@" "groff-pdfmark @VERSION@" | |
2 | 2 | .SH Name |
3 | 3 | pdfroff \- generate Portable Document Format files using |
4 | 4 | .I groff |
@@ -8,7 +8,7 @@ | ||
8 | 8 | .\" Legal Terms |
9 | 9 | .\" ==================================================================== |
10 | 10 | .\" |
11 | -.\" Copyright (C) 2005-2020, 2023, Free Software Foundation, Inc. | |
11 | +.\" Copyright (C) 2005-2020, 2023, 2024, Free Software Foundation, Inc. | |
12 | 12 | .\" |
13 | 13 | .\" This file is part of groff, the GNU roff type-setting system. |
14 | 14 | .\" |
@@ -1012,7 +1012,7 @@ | ||
1012 | 1012 | \:wiki/\:\%FrontPage |
1013 | 1013 | his |
1014 | 1014 | .I \%groff-pdfmark |
1015 | -OSDN site | |
1015 | +OSDN \%web-site | |
1016 | 1016 | .UE . |
1017 | 1017 | . |
1018 | 1018 | The version distributed with |