From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.devel Subject: Re: Date in emacs man-file Date: Sun, 11 Oct 2020 04:49:46 -0700 Message-ID: References: <878sde2bn7.fsf@yandex.com> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="000000000000519bd405b163c78e" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="28133"; mail-complaints-to="usenet@ciao.gmane.io" To: Colin Baxter , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Oct 11 13:51:04 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 1kRZsV-0007By-SS for ged-emacs-devel@m.gmane-mx.org; Sun, 11 Oct 2020 13:51:03 +0200 Original-Received: from localhost ([::1]:38360 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kRZsU-0000kR-UL for ged-emacs-devel@m.gmane-mx.org; Sun, 11 Oct 2020 07:51:02 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:39482) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kRZrL-0000Ai-Q2 for emacs-devel@gnu.org; Sun, 11 Oct 2020 07:49:51 -0400 Original-Received: from mail-ed1-x52d.google.com ([2a00:1450:4864:20::52d]:39004) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kRZrJ-000359-OS for emacs-devel@gnu.org; Sun, 11 Oct 2020 07:49:51 -0400 Original-Received: by mail-ed1-x52d.google.com with SMTP id t21so14002214eds.6 for ; Sun, 11 Oct 2020 04:49:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:in-reply-to:references:mime-version:date:message-id:subject:to; bh=r+Xaw8/VTKzgXCfqYUlGgrsgcaB1A9aJnH6CrsvvTAI=; b=Q3xLodAPxANfRbhoacQY97bcm6zPCQQ5gwbxSGHtVizhvlhxZBY5ppOZrfNCCSzYaq xL1cWY2k/LtewEXslrmfZN/XO/oO9VmtQrED22WW2hZkRiYS7hYZghndPW4vWghykNcG ce1d7u+DWl2X+7Sv5lO5YeBy5fqELw1ap/Hwl2gnOai6Dwg/TwcjlzmGKGNZxd9i4n5L nBcB99g3Y3hkowfxjPUyUt44shqQi/B8E9EUM9h8NEMhwveKz7ND2UgR93qMNrYZBOvL WU2xNX7WuV3KmvnnqlxpHh++NGFs1sUCmBwe/66mT8kzmshm4BvlDplafbO73qPnr8lD z0WQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:in-reply-to:references:mime-version:date :message-id:subject:to; bh=r+Xaw8/VTKzgXCfqYUlGgrsgcaB1A9aJnH6CrsvvTAI=; b=pjKxDDQIIajfTw1XA8b/RKfK0Or7GvDoFcVXpY/xYlbHsxuBs7Rx+ULfljoFCwoWc8 e/TDvsb48eAo02t77SOCYObE4J/WM1nNTpgB2bR3Cksc2NGpvOoc93Cb5uvyPYcDb3GO oruT1FfIK9l0JiO3AkOwMPbRnsHgSoJKei7EpBqtR+yeb0iPh9YqY/1lLFl1dz593wG2 2Q5wHRC4Tfxon+zUYNmY1n4KoN1ksHfDmnt6Q8d0cguQSyZFzA+VehPrjR5DosHvGD/3 OP8SiqiAkvHPT9AeL2tLpsNggFfVnC2nDEJlfbHAM+FgDYeOpkThGX7GXtmaMD5bE73Q 8DlQ== X-Gm-Message-State: AOAM532/9yzyFtIzJ+FAPrqAq072c4HjY/7U5uYmVuIdmRuOHVh7COeG T0It5ZbXvTg9yFP1LfA6hwAdhajUvKTM88D2zCg= X-Google-Smtp-Source: ABdhPJx7FsC//U4VybNpGssel7+JhRxCLnqn/ayF1S6FUNs7WdRqEUsWfPAVQ1na/9+KAZbY2WoiHLD94FbNmkT0ClI= X-Received: by 2002:a05:6402:31b3:: with SMTP id dj19mr8950055edb.210.1602416987436; Sun, 11 Oct 2020 04:49:47 -0700 (PDT) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sun, 11 Oct 2020 04:49:46 -0700 In-Reply-To: Received-SPF: pass client-ip=2a00:1450:4864:20::52d; envelope-from=stefankangas@gmail.com; helo=mail-ed1-x52d.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham 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:257355 Archived-At: --000000000000519bd405b163c78e Content-Type: text/plain; charset="UTF-8" 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.) --000000000000519bd405b163c78e Content-Type: text/x-diff; charset="US-ASCII"; name="0001-Fix-man-page-title-lines-and-timestamps.patch" Content-Disposition: attachment; filename="0001-Fix-man-page-title-lines-and-timestamps.patch" Content-Transfer-Encoding: base64 X-Attachment-Id: 93b3cc563b886a82_0.1 RnJvbSBlMjUzZWRjYjcwNjBjNDM2YjMzZjU0NDQ1MGRlYjMwMGQzNmJiNTk0IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBTdGVmYW4gS2FuZ2FzIDxzdGVmYW5AbWFyeGlzdC5zZT4KRGF0 ZTogU3VuLCAxMSBPY3QgMjAyMCAxMzoxMjo0NyArMDIwMApTdWJqZWN0OiBbUEFUQ0hdIEZpeCBt YW4gcGFnZSB0aXRsZSBsaW5lcyBhbmQgdGltZXN0YW1wcwoKKiBkb2MvbWFuL2Vicm93c2UuMToK KiBkb2MvbWFuL2VtYWNzLjEuaW46CiogZG9jL21hbi9lbWFjc2NsaWVudC4xOgoqIGRvYy9tYW4v ZXRhZ3MuMTogVXBkYXRlIGRhdGUgdG8gbWF0Y2ggbGFzdCBzaWduaWZpY2FudCBjaGFuZ2UuICBT ZXQKZmlsZSBsb2NhbCB2YXJpYWJsZSB0aW1lLXN0YW1wLXBhdHRlcm4uICBGaXggdGl0bGUgbGlu ZSB0byBtYXRjaCB0aGUKcmVjb21tZW5kYXRpb25zIGluICJtYW4gbWFuLXBhZ2VzIi4KUmVmOiBo dHRwczovL2xpc3RzLmdudS5vcmcvci9lbWFjcy1kZXZlbC8yMDIwLTA5L21zZzAxMDAyLmh0bWwK LS0tCiBkb2MvbWFuL2Vicm93c2UuMSAgICAgfCA2ICsrKysrLQogZG9jL21hbi9lbWFjcy4xLmlu ICAgIHwgNiArKysrKy0KIGRvYy9tYW4vZW1hY3NjbGllbnQuMSB8IDYgKysrKystCiBkb2MvbWFu L2V0YWdzLjEgICAgICAgfCA2ICsrKysrLQogNCBmaWxlcyBjaGFuZ2VkLCAyMCBpbnNlcnRpb25z KCspLCA0IGRlbGV0aW9ucygtKQoKZGlmZiAtLWdpdCBhL2RvYy9tYW4vZWJyb3dzZS4xIGIvZG9j L21hbi9lYnJvd3NlLjEKaW5kZXggNjg2NjU4YjIwZi4uMzMwYzFlYTUyMyAxMDA2NDQKLS0tIGEv ZG9jL21hbi9lYnJvd3NlLjEKKysrIGIvZG9jL21hbi9lYnJvd3NlLjEKQEAgLTEsNSArMSw1IEBA CiAuXCIgU2VlIHNlY3Rpb24gQ09QWUlORyBmb3IgY29weXJpZ2h0IGFuZCByZWRpc3RyaWJ1dGlv biBpbmZvcm1hdGlvbi4KLS5USCBFQlJPV1NFIDEKKy5USCBFQlJPV1NFIDEgIjIwMDgtMTItMTQi ICJHTlUgRW1hY3MiICJHTlUiCiAuU0ggTkFNRQogZWJyb3dzZSBcLSBjcmVhdGUgYSBjbGFzcyBo aWVyYXJjaHkgZGF0YWJhc2UKIC5TSCBTWU5PUFNJUwpAQCAtOTgsMyArOTgsNyBAQCBkb2N1bWVu dCBpbnRvIGFub3RoZXIgbGFuZ3VhZ2UsIHVuZGVyIHRoZSBhYm92ZSBjb25kaXRpb25zIGZvcgog bW9kaWZpZWQgdmVyc2lvbnMsIGV4Y2VwdCB0aGF0IHRoaXMgcGVybWlzc2lvbiBub3RpY2UgbWF5 IGJlIHN0YXRlZAogaW4gYSB0cmFuc2xhdGlvbiBhcHByb3ZlZCBieSB0aGUgRnJlZSBTb2Z0d2Fy ZSBGb3VuZGF0aW9uLgogLgorCisuXCIgTG9jYWwgVmFyaWFibGVzOgorLlwiIHRpbWUtc3RhbXAt cGF0dGVybjogIjMvLlRIIEVCUk9XU0UgMSBcIiVZLSUwMm0tJTAyZFwiIFwiR05VIEVtYWNzXCIg XCJHTlVcIiQiCisuXCIgRW5kOgpkaWZmIC0tZ2l0IGEvZG9jL21hbi9lbWFjcy4xLmluIGIvZG9j L21hbi9lbWFjcy4xLmluCmluZGV4IDVhMTY0ZTk4Y2QuLjNhNTc1OGUxYWEgMTAwNjQ0Ci0tLSBh L2RvYy9tYW4vZW1hY3MuMS5pbgorKysgYi9kb2MvbWFuL2VtYWNzLjEuaW4KQEAgLTEsNSArMSw1 IEBACiAuXCIgU2VlIHNlY3Rpb24gQ09QWUlORyBmb3IgY29weXJpZ2h0IGFuZCByZWRpc3RyaWJ1 dGlvbiBpbmZvcm1hdGlvbi4KLS5USCBFTUFDUyAxICIyMDA3IEFwcmlsIDEzIiAiR05VIEVtYWNz IEB2ZXJzaW9uQCIKKy5USCBFTUFDUyAxICIyMDIwLTA0LTA1IiAiR05VIEVtYWNzIEB2ZXJzaW9u QCIgIkdOVSIKIC4KIC4KIC5TSCBOQU1FCkBAIC02NzMsMyArNjczLDcgQEAgZG9jdW1lbnQgaW50 byBhbm90aGVyIGxhbmd1YWdlLCB1bmRlciB0aGUgYWJvdmUgY29uZGl0aW9ucyBmb3IKIG1vZGlm aWVkIHZlcnNpb25zLCBleGNlcHQgdGhhdCB0aGlzIHBlcm1pc3Npb24gbm90aWNlIG1heSBiZSBz dGF0ZWQKIGluIGEgdHJhbnNsYXRpb24gYXBwcm92ZWQgYnkgdGhlIEZyZWUgU29mdHdhcmUgRm91 bmRhdGlvbi4KIC4KKworLlwiIExvY2FsIFZhcmlhYmxlczoKKy5cIiB0aW1lLXN0YW1wLXBhdHRl cm46ICIzLy5USCBFTUFDUyAxIFwiJVktJTAybS0lMDJkXCIgXCJHTlUgRW1hY3MgQHZlcnNpb25A XCIgXCJHTlVcIiQiCisuXCIgRW5kOgpkaWZmIC0tZ2l0IGEvZG9jL21hbi9lbWFjc2NsaWVudC4x IGIvZG9jL21hbi9lbWFjc2NsaWVudC4xCmluZGV4IDNiZGFhZmJmYzUuLjlkMTRkMGZlNzUgMTAw NjQ0Ci0tLSBhL2RvYy9tYW4vZW1hY3NjbGllbnQuMQorKysgYi9kb2MvbWFuL2VtYWNzY2xpZW50 LjEKQEAgLTEsNSArMSw1IEBACiAuXCIgU2VlIHNlY3Rpb24gQ09QWUlORyBmb3IgY29uZGl0aW9u cyBmb3IgcmVkaXN0cmlidXRpb24uCi0uVEggRU1BQ1NDTElFTlQgMQorLlRIIEVNQUNTQ0xJRU5U IDEgIjIwMTktMDgtMDIiICJHTlUgRW1hY3MiICJHTlUiCiAuXCIgTkFNRSBzaG91bGQgYmUgYWxs IGNhcHMsIFNFQ1RJT04gc2hvdWxkIGJlIDEtOCwgbWF5YmUgdy8gc3Vic2VjdGlvbgogLlwiIG90 aGVyIHBhcmFtcyBhcmUgYWxsb3dlZDogc2VlIG1hbig3KSwgbWFuKDEpCiAuU0ggTkFNRQpAQCAt MTE0LDMgKzExNCw3IEBAIFRoaXMgbWFudWFsIHBhZ2Ugd2FzIHdyaXR0ZW4gYnkgU3RlcGhhbmUg Qm9ydHptZXllciA8Ym9ydHptZXllckBkZWJpYW4ub3JnPiwKIGZvciB0aGUgRGViaWFuIEdOVS9M aW51eCBzeXN0ZW0gKGJ1dCBtYXkgYmUgdXNlZCBieSBvdGhlcnMpLgogLlNIIENPUFlJTkcKIFRo aXMgbWFudWFsIHBhZ2UgaXMgaW4gdGhlIHB1YmxpYyBkb21haW4uCisKKy5cIiBMb2NhbCBWYXJp YWJsZXM6CisuXCIgdGltZS1zdGFtcC1wYXR0ZXJuOiAiMy8uVEggRU1BQ1NDTElFTlQgMSBcIiVZ LSUwMm0tJTAyZFwiIFwiR05VIEVtYWNzXCIgXCJHTlVcIiQiCisuXCIgRW5kOgpkaWZmIC0tZ2l0 IGEvZG9jL21hbi9ldGFncy4xIGIvZG9jL21hbi9ldGFncy4xCmluZGV4IGUxMGZiODQwY2EuLjgw NTNlODYzZmMgMTAwNjQ0Ci0tLSBhL2RvYy9tYW4vZXRhZ3MuMQorKysgYi9kb2MvbWFuL2V0YWdz LjEKQEAgLTEsNSArMSw1IEBACiAuXCIgU2VlIHNlY3Rpb24gQ09QWUlORyBmb3IgY29weXJpZ2h0 IGFuZCByZWRpc3RyaWJ1dGlvbiBpbmZvcm1hdGlvbi4KLS5USCBldGFncyAxICIyM25vdjIwMDEi ICJHTlUgVG9vbHMiICJHTlUgVG9vbHMiCisuVEggRVRBR1MgMSAiMjAxOS0wNi0yNCIgIkdOVSBU b29scyIgIkdOVSIKIC5kZSBCUAogLnNwCiAudGkgLS4yaQpAQCAtMjk2LDMgKzI5Niw3IEBAIFBl cm1pc3Npb24gaXMgZ3JhbnRlZCB0byBjb3B5IGFuZCBkaXN0cmlidXRlIHRyYW5zbGF0aW9ucyBv ZiB0aGlzCiBkb2N1bWVudCBpbnRvIGFub3RoZXIgbGFuZ3VhZ2UsIHVuZGVyIHRoZSBhYm92ZSBj b25kaXRpb25zIGZvcgogbW9kaWZpZWQgdmVyc2lvbnMsIGV4Y2VwdCB0aGF0IHRoaXMgcGVybWlz c2lvbiBub3RpY2UgbWF5IGJlIHN0YXRlZAogaW4gYSB0cmFuc2xhdGlvbiBhcHByb3ZlZCBieSB0 aGUgRnJlZSBTb2Z0d2FyZSBGb3VuZGF0aW9uLgorCisuXCIgTG9jYWwgVmFyaWFibGVzOgorLlwi IHRpbWUtc3RhbXAtcGF0dGVybjogIjMvLlRIIEVUQUdTIDEgXCIlWS0lMDJtLSUwMmRcIiBcIkdO VSBUb29sc1wiIFwiR05VXCIkIgorLlwiIEVuZDoKLS0gCjIuMjguMAoK --000000000000519bd405b163c78e--