* Date in emacs man-file @ 2020-09-13 10:50 Colin Baxter 2020-09-13 12:12 ` Stefan Kangas 0 siblings, 1 reply; 6+ messages in thread From: Colin Baxter @ 2020-09-13 10:50 UTC (permalink / raw) To: emacs-devel Hello, I notice the second line of the file man/emacs.1.in has "2007 April 13". Therefore "man emacs <RET>" will give this date at the foot of the manual, along side the emacs version (27.1 in the case of the latest release). Should not this date be amended to something more recent? Best wishes, Colin Baxter. ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Date in emacs man-file 2020-09-13 10:50 Date in emacs man-file Colin Baxter @ 2020-09-13 12:12 ` Stefan Kangas 2020-09-16 11:24 ` Colin Baxter 2020-10-11 11:49 ` Stefan Kangas 0 siblings, 2 replies; 6+ messages in thread From: Stefan Kangas @ 2020-09-13 12:12 UTC (permalink / raw) To: Colin Baxter, emacs-devel Colin Baxter <m43cap@yandex.com> writes: > I notice the second line of the file man/emacs.1.in has "2007 April > 13". Therefore "man emacs <RET>" will give this date at the foot of the > manual, along side the emacs version (27.1 in the case of the latest > release). Should not this date be amended to something more recent? "man 7 man-pages" says: date The date of the last nontrivial change that was made to the man page. (Within the man-pages project, the necessary updates to these timestamps are handled automatically by scripts, so there is no need to manually update them as part of a patch.) Dates should be written in the form YYYY-MM-DD. Perhaps we could add a local timestamp variable to update it automatically? It would catch even insignificant changes, but it would be up to the committer to update the timestamp or not. ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Date in emacs man-file 2020-09-13 12:12 ` Stefan Kangas @ 2020-09-16 11:24 ` Colin Baxter 2020-10-11 11:49 ` Stefan Kangas 1 sibling, 0 replies; 6+ messages in thread From: Colin Baxter @ 2020-09-16 11:24 UTC (permalink / raw) To: emacs-devel >>>>> Stefan Kangas <stefankangas@gmail.com> writes: > Colin Baxter <m43cap@yandex.com> writes: >> I notice the second line of the file man/emacs.1.in has "2007 >> April 13". Therefore "man emacs <RET>" will give this date at the >> foot of the manual, along side the emacs version (27.1 in the >> case of the latest release). Should not this date be amended to >> something more recent? > "man 7 man-pages" says: > date The date of the last nontrivial change that was made > to the man page. (Within the man-pages project, the necessary > updates to these timestamps are handled automatically by scripts, > so there is no need to manually update them as part of a patch.) > Dates should be written in the form YYYY-MM-DD. > Perhaps we could add a local timestamp variable to update it > automatically? It would catch even insignificant changes, but it > would be up to the committer to update the timestamp or not. Curiously, there's a recent reddit enquiry on just this very issue. https://www.reddit.com/r/emacs/comments/hszg0a/hook_for_updating_manpage_timestamp_in_line_1/ The proposed lisp defun works on the first line only of the nroff file, for a different date format - but it does work. Best wishes, Colin Baxter. ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Date in emacs man-file 2020-09-13 12:12 ` Stefan Kangas 2020-09-16 11:24 ` Colin Baxter @ 2020-10-11 11:49 ` Stefan Kangas 2020-10-11 15:14 ` Colin Baxter 1 sibling, 1 reply; 6+ messages in thread From: Stefan Kangas @ 2020-10-11 11:49 UTC (permalink / raw) To: Colin Baxter, emacs-devel [-- Attachment #1: Type: text/plain, Size: 1263 bytes --] Stefan Kangas <stefankangas@gmail.com> writes: > Colin Baxter <m43cap@yandex.com> writes: > >> I notice the second line of the file man/emacs.1.in has "2007 April >> 13". Therefore "man emacs <RET>" will give this date at the foot of the >> manual, along side the emacs version (27.1 in the case of the latest >> release). Should not this date be amended to something more recent? > > "man 7 man-pages" says: > > date The date of the last nontrivial change that was made to the man > page. (Within the man-pages project, the necessary updates to > these timestamps are handled automatically by scripts, so there > is no need to manually update them as part of a patch.) Dates > should be written in the form YYYY-MM-DD. > > Perhaps we could add a local timestamp variable to update it > automatically? It would catch even insignificant changes, but it would > be up to the committer to update the timestamp or not. How does the attached patch look? In addition to fixing the dates, I added a time-stamp-pattern and updated the title lines to match the recommendations in "man man-pages". (I also took a look at the gcc man page and made sure they use the "GNU" header like I do here.) [-- Attachment #2: 0001-Fix-man-page-title-lines-and-timestamps.patch --] [-- Type: text/x-diff, Size: 3576 bytes --] From e253edcb7060c436b33f544450deb300d36bb594 Mon Sep 17 00:00:00 2001 From: Stefan Kangas <stefan@marxist.se> Date: Sun, 11 Oct 2020 13:12:47 +0200 Subject: [PATCH] Fix man page title lines and timestamps * doc/man/ebrowse.1: * doc/man/emacs.1.in: * doc/man/emacsclient.1: * doc/man/etags.1: Update date to match last significant change. Set file local variable time-stamp-pattern. Fix title line to match the recommendations in "man man-pages". Ref: https://lists.gnu.org/r/emacs-devel/2020-09/msg01002.html --- doc/man/ebrowse.1 | 6 +++++- doc/man/emacs.1.in | 6 +++++- doc/man/emacsclient.1 | 6 +++++- doc/man/etags.1 | 6 +++++- 4 files changed, 20 insertions(+), 4 deletions(-) diff --git a/doc/man/ebrowse.1 b/doc/man/ebrowse.1 index 686658b20f..330c1ea523 100644 --- a/doc/man/ebrowse.1 +++ b/doc/man/ebrowse.1 @@ -1,5 +1,5 @@ .\" See section COPYING for copyright and redistribution information. -.TH EBROWSE 1 +.TH EBROWSE 1 "2008-12-14" "GNU Emacs" "GNU" .SH NAME ebrowse \- create a class hierarchy database .SH SYNOPSIS @@ -98,3 +98,7 @@ document into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the Free Software Foundation. . + +.\" Local Variables: +.\" time-stamp-pattern: "3/.TH EBROWSE 1 \"%Y-%02m-%02d\" \"GNU Emacs\" \"GNU\"$" +.\" End: diff --git a/doc/man/emacs.1.in b/doc/man/emacs.1.in index 5a164e98cd..3a5758e1aa 100644 --- a/doc/man/emacs.1.in +++ b/doc/man/emacs.1.in @@ -1,5 +1,5 @@ .\" See section COPYING for copyright and redistribution information. -.TH EMACS 1 "2007 April 13" "GNU Emacs @version@" +.TH EMACS 1 "2020-04-05" "GNU Emacs @version@" "GNU" . . .SH NAME @@ -673,3 +673,7 @@ document into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the Free Software Foundation. . + +.\" Local Variables: +.\" time-stamp-pattern: "3/.TH EMACS 1 \"%Y-%02m-%02d\" \"GNU Emacs @version@\" \"GNU\"$" +.\" End: diff --git a/doc/man/emacsclient.1 b/doc/man/emacsclient.1 index 3bdaafbfc5..9d14d0fe75 100644 --- a/doc/man/emacsclient.1 +++ b/doc/man/emacsclient.1 @@ -1,5 +1,5 @@ .\" See section COPYING for conditions for redistribution. -.TH EMACSCLIENT 1 +.TH EMACSCLIENT 1 "2019-08-02" "GNU Emacs" "GNU" .\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection .\" other params are allowed: see man(7), man(1) .SH NAME @@ -114,3 +114,7 @@ This manual page was written by Stephane Bortzmeyer <bortzmeyer@debian.org>, for the Debian GNU/Linux system (but may be used by others). .SH COPYING This manual page is in the public domain. + +.\" Local Variables: +.\" time-stamp-pattern: "3/.TH EMACSCLIENT 1 \"%Y-%02m-%02d\" \"GNU Emacs\" \"GNU\"$" +.\" End: diff --git a/doc/man/etags.1 b/doc/man/etags.1 index e10fb840ca..8053e863fc 100644 --- a/doc/man/etags.1 +++ b/doc/man/etags.1 @@ -1,5 +1,5 @@ .\" See section COPYING for copyright and redistribution information. -.TH etags 1 "23nov2001" "GNU Tools" "GNU Tools" +.TH ETAGS 1 "2019-06-24" "GNU Tools" "GNU" .de BP .sp .ti -.2i @@ -296,3 +296,7 @@ Permission is granted to copy and distribute translations of this document into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the Free Software Foundation. + +.\" Local Variables: +.\" time-stamp-pattern: "3/.TH ETAGS 1 \"%Y-%02m-%02d\" \"GNU Tools\" \"GNU\"$" +.\" End: -- 2.28.0 ^ permalink raw reply related [flat|nested] 6+ messages in thread
* Re: Date in emacs man-file 2020-10-11 11:49 ` Stefan Kangas @ 2020-10-11 15:14 ` Colin Baxter 2020-10-12 19:05 ` Stefan Kangas 0 siblings, 1 reply; 6+ messages in thread From: Colin Baxter @ 2020-10-11 15:14 UTC (permalink / raw) To: emacs-devel >>>>> Stefan Kangas <stefankangas@gmail.com> writes: > Stefan Kangas <stefankangas@gmail.com> writes: >> Colin Baxter <m43cap@yandex.com> writes: >> >>> I notice the second line of the file man/emacs.1.in has "2007 >>> April 13". Therefore "man emacs <RET>" will give this date at >>> the foot of the manual, along side the emacs version (27.1 in >>> the case of the latest release). Should not this date be amended >>> to something more recent? >> >> "man 7 man-pages" says: >> >> date The date of the last nontrivial change that was made to the >> man page. (Within the man-pages project, the necessary updates >> to these timestamps are handled automatically by scripts, so >> there is no need to manually update them as part of a patch.) >> Dates should be written in the form YYYY-MM-DD. >> >> Perhaps we could add a local timestamp variable to update it >> automatically? It would catch even insignificant changes, but it >> would be up to the committer to update the timestamp or not. > How does the attached patch look? In addition to fixing the > dates, I added a time-stamp-pattern and updated the title lines to > match the recommendations in "man man-pages". (I also took a look > at the gcc man page and made sure they use the "GNU" header like I > do here.) I've added the patch to a test branch of my local emacs git repository and the man pages ebrowse.1, emacs.1.in, emacsclient.1, etags.1 all look great. Thanks. Best wishes, Colin Baxter. Colin Baxter URL: http://www.Colin-Baxter.com --------------------------------------------------------------------- GnuPG fingerprint: 68A8 799C 0230 16E7 BF68 2A27 BBFA 2492 91F5 41C8 --------------------------------------------------------------------- ^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Date in emacs man-file 2020-10-11 15:14 ` Colin Baxter @ 2020-10-12 19:05 ` Stefan Kangas 0 siblings, 0 replies; 6+ messages in thread From: Stefan Kangas @ 2020-10-12 19:05 UTC (permalink / raw) To: Colin Baxter, emacs-devel Colin Baxter <m43cap@yandex.com> writes: > I've added the patch to a test branch of my local emacs git repository > and the man pages ebrowse.1, emacs.1.in, emacsclient.1, etags.1 all look > great. Thanks for testing. Pushed to master as commit a6c22271bc. ^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2020-10-12 19:05 UTC | newest] Thread overview: 6+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2020-09-13 10:50 Date in emacs man-file Colin Baxter 2020-09-13 12:12 ` Stefan Kangas 2020-09-16 11:24 ` Colin Baxter 2020-10-11 11:49 ` Stefan Kangas 2020-10-11 15:14 ` Colin Baxter 2020-10-12 19:05 ` Stefan Kangas
Code repositories for project(s) associated with this public inbox https://git.savannah.gnu.org/cgit/emacs.git This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).