diff options
| author | David Kalnischkies <david@kalnischkies.de> | 2022-11-02 13:04:11 +0100 |
|---|---|---|
| committer | David Kalnischkies <david@kalnischkies.de> | 2022-11-02 13:41:14 +0100 |
| commit | 47dd3f008663cb4f47eb3129e0fe721731bd4b57 (patch) | |
| tree | 0a8be6e804436ae349b039f635c5bc5878835f9c /doc | |
| parent | acb5002a7cd03253522978e70258589e9b262216 (diff) | |
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
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/apt-verbatim.ent | 2 |
1 files changed, 1 insertions, 1 deletions
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 @@ <arg choice='plain' rep='repeat'>&synopsis-param-filename;</arg> &synopsis-help; </cmdsynopsis></refsynopsisdiv>"> -<!ENTITY synopsis-arg-ftparchive "<arg choice='plain' rep='repeat'><replaceable>&synopsis-path;</replaceable></arg><arg><filename><replaceable>&synopsis-override;</replaceable></filename><arg><replaceable>&synopsis-pathprefix;</replaceable></arg></arg>"> +<!ENTITY synopsis-arg-ftparchive "<arg choice='plain'><replaceable>&synopsis-path;</replaceable></arg><arg><filename><replaceable>&synopsis-override;</replaceable></filename><arg><replaceable>&synopsis-pathprefix;</replaceable></arg></arg>"> <!ENTITY synopsis-command-apt-ftparchive "<refsynopsisdiv><cmdsynopsis> <command>apt-ftparchive</command> <arg><option>-dsq</option></arg> |