"Adam D. Barratt" <a...@adam-barratt.org.uk> writes:
> On Tue, 2011-04-12 at 07:06 +0200, Olivier Berger wrote:
>> man rmadison mentions :
>> "dak ls" several times where it would sound logical to read
>> "rmadison".
>
> So far as I can see, all of the mentions of "dak ls" are actually
> correct.
Maybe there's something on the server that runs dak ls when one uses
rmadison, but if your read the man page, you get :
NAME
rmadison -- Remotely query the Debian archive database about packages
SYNOPSIS
rmadison [OPTIONS] PACKAGE ...
DESCRIPTION
dak ls queries the Debian archive database ("projectb") and displays
which package version is registered per architecture/component/suite.
To me, it looks like the first sentence in the description should start
with "Rmadison queries, etc.", not "dak ls queries, etc." when I 'man rmadison'.
>
> The "description" paragraph mentions that rmadison is a front-end to a
> CGI which runs "dak ls"; that's correct.
>
Ok, maybe if the 2 sentences where reversed would it be more obvious ?
> In the "notes" section, an option which is accepted by "dak ls", but not
> by the CGI (and therefore not by rmadison) is highlighted, together with
> the fact that the back-end command used to be called "madison", hence
> the naming of "rmadison" as "remote madison".
>
This looks too much like copy/pasted man page of 'dak ls', if you never
heard of it and only care about what rmadison offers, IMHO.
>> I believe the program was renamed but this hasn't been fixed.
>>
>> Still the manpage mentions :
>> "dak ls was formerly called madison."
>>
>> Maybe this last paragraph needs an update too.
>
> It's correct. The parts of the dak suite used to have other names; the
> part which is now "dak ls" used to be called madison.
> I assume that
> note exists to explain why the script in devscripts is called
> "rmadison".
>
Actaully, not, AFAICT.
Thanks for caring.
Best regards,
--
Olivier BERGER
(OpenPGP: 4096R/7C5BB6A5)
http://www.olivierberger.com/weblog/
--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
