Page MenuHome GnuPG

online libgcrypt manual 1.8.5 2020-05-04 has false UPDATED date
Closed, ResolvedPublic

Description

https://gnupg.org/documentation/manuals/gcrypt/ has

"This manual is for Libgcrypt (version 1.8.5, 19 November 2018),"

which is wrong, as 1.8.5 was released on 2019-08-29 according to its NEWS file.

doc/gcrypt.texi has (version @value{VERSION}, @value{UPDATED}) there, so it is the UPDATED value that is wrong somehow.

Details

Version
1.8.5

Event Timeline

bernhard renamed this task from online libgcrypt manual has false UPDATED date to online libgcrypt manual 1.8.5 2020-05-04 has false UPDATED date.May 4 2020, 5:33 PM
bernhard created this task.
werner claimed this task.
werner added a project: Not A Bug.
werner added a subscriber: werner.

Nope, that is correct, the last update of the manual was

Author:     Andreas Metzler <ametzler@bebt.de>
AuthorDate: Sun Nov 18 16:01:21 2018 +0100

and commited a day later. It is a GNU standard to separate the release and update dates of manuals.

Ah, okay, then the phrasing is missleading, the sentence looks like libgcrypt was released on this date and not the manual.

Taking a look at other GNU manuals, both GNU make and GNU Bison have a better phrasing,
so I suggest the Bison way (https://www.gnu.org/software/bison/manual/html_node/index.html):

This manual (7 December 2019) is for GNU Bison (version 3.5), the GNU parser generator.

Here the patch I suggest (I can push this to master and LIBGCRYPT-1.8-BRANCH if you want.

patch
diff --git a/doc/gcrypt.texi b/doc/gcrypt.texi
index 3a1590a3..42000ccf 100644
--- a/doc/gcrypt.texi
+++ b/doc/gcrypt.texi
@@ -8,8 +8,8 @@
 @syncodeindex pg fn
 @c %**end of header
 @copying
-This manual is for Libgcrypt
-(version @value{VERSION}, @value{UPDATED}),
+This manual (@value{UPDATED})
+is for Libgcrypt (version @value{VERSION}),
 which is GNU's library of cryptographic building blocks.
 
 @noindent