From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Colin Baxter Newsgroups: gmane.emacs.devel Subject: Re: Date in emacs man-file Date: Sun, 11 Oct 2020 16:14:59 +0100 Message-ID: <87eem43ibw.fsf@yandex.com> References: <878sde2bn7.fsf@yandex.com> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="30881"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) To: emacs-devel@gnu.org Cancel-Lock: sha1:aocT4VhkfvaRJ8mmT/D2ARMsOq8= Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Oct 11 17:15:58 2020 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1kRd4n-0007tD-Sn for ged-emacs-devel@m.gmane-mx.org; Sun, 11 Oct 2020 17:15:57 +0200 Original-Received: from localhost ([::1]:51364 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kRd4m-0002zC-Ue for ged-emacs-devel@m.gmane-mx.org; Sun, 11 Oct 2020 11:15:56 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:35898) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kRd45-00029C-VR for emacs-devel@gnu.org; Sun, 11 Oct 2020 11:15:14 -0400 Original-Received: from static.214.254.202.116.clients.your-server.de ([116.202.254.214]:34042 helo=ciao.gmane.io) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kRd43-0003iM-D6 for emacs-devel@gnu.org; Sun, 11 Oct 2020 11:15:13 -0400 Original-Received: from list by ciao.gmane.io with local (Exim 4.92) (envelope-from ) id 1kRd3y-0006rx-LO for emacs-devel@gnu.org; Sun, 11 Oct 2020 17:15:06 +0200 X-Injected-Via-Gmane: http://gmane.org/ X-Face: BHjiJOg/Qmj'BQgsAKL@])L)e62P)C"Y=6T Face: iVBORw0KGgoAAAANSUhEUgAAAGQAAAAeBAMAAAAodabAAAAAB3RJTUUH1wQdAAY04/L8hgAA AAlwSFlzAAAewQAAHsEBw2lUUwAAAARnQU1BAACxjwv8YQUAAAASUExURc7OzpwAAAAAAP////8A AGNj/2aqqTQAAAA8SURBVHjaYzA2NnEBAmdj01D8wNgYpM7F2JiBgYFREAgEGJiU8AMGBpA6QaCG UVtGbRm1ZdSWUVsGjS0Aq20lJnMawnkAAAAASUVORK5CYII= Received-SPF: pass client-ip=116.202.254.214; envelope-from=ged-emacs-devel@m.gmane-mx.org; helo=ciao.gmane.io X-detected-operating-system: by eggs.gnu.org: First seen = 2020/10/11 11:15:07 X-ACL-Warn: Detected OS = Linux 2.2.x-3.x [generic] [fuzzy] X-Spam_score_int: -13 X-Spam_score: -1.4 X-Spam_bar: - X-Spam_report: (-1.4 / 5.0 requ) BAYES_00=-1.9, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.25, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:257370 Archived-At: >>>>> Stefan Kangas writes: > Stefan Kangas writes: >> Colin Baxter writes: >> >>> I notice the second line of the file man/emacs.1.in has "2007 >>> April 13". Therefore "man emacs " 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 ---------------------------------------------------------------------