From 47dd3f008663cb4f47eb3129e0fe721731bd4b57 Mon Sep 17 00:00:00 2001 From: David Kalnischkies Date: Wed, 2 Nov 2022 13:04:11 +0100 Subject: Do not document path to be repeatable in apt-ftparchive cmds The manpage for apt-ftparchive {packages,sources} claims that the path argument can be repeated, but that logically conflicts with having two optional arguments after that and isn't implemented in code either, so we just adapt the documentation to reality here. So, since when is this documentation wrong? The manpage is currently written in xml (since 2004), but the sgml before that had the same mistake included all the way back to a time in which time itself is not stable (the commit is dated in git 2004, but the commit message says 2001 while including a d/changelog stanza dated 2000) in my favorite commit "Join with aliencode" which brought in a whole lot of stuff adding also (quoting said d/changelog entry) "apt-ftparchive the all dancing all singing FTP archive maintenance program". In other words: It was documented this way for more than 22 years. Reported-By: Michael Tokarev on IRC --- doc/apt-verbatim.ent | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'doc') diff --git a/doc/apt-verbatim.ent b/doc/apt-verbatim.ent index b67b7a060..6e08a73c4 100644 --- a/doc/apt-verbatim.ent +++ b/doc/apt-verbatim.ent @@ -403,7 +403,7 @@ &synopsis-param-filename; &synopsis-help; "> -&synopsis-path;&synopsis-override;&synopsis-pathprefix;"> +&synopsis-path;&synopsis-override;&synopsis-pathprefix;"> apt-ftparchive -- cgit v1.2.3-70-g09d2