Re: [Bug-wget] Bug#633702: simpleminded conversion from Info makes man page barfy looking

[Micah Cowan]

(07/12/2011 05:07 PM), address@hidden wrote:
> X-debbugs-Cc: address@hidden
> Package: wget
> Version: 1.12-3.1
> Severity: wishlist
> 
> Have you checked out the man page lately?
> The simple conversion from Info leaves some atrocious junk. Have a slice:
> 
>        server response, save: see "HTTP Options", .        (line 217)
> 
>        session cookies: see "HTTP Options", .        (line 141)
> 
>        signal handling: see "Signals", .             (line   6)
> 
>        spanning hosts: see "Spanning Hosts", .      (line   6)
> 
>        spider: see "Download Options", .    (line 186)
> 
> Plus the entire GPL.
> Also the whole list of boring contributors.
> Yes I know GNU projects are supposed to have "different" looking man
> pages, but this is the most "special" one I've yet seen :-(

Please note that Debian's wget manpage is created in a different way
than upstream's, which does not have such artifacts. This was a decision
made by the Debian package maintainer, and does not affect GNU's project.

I don't fault the Debian maintainer for choosing to do it his way. The
trade-off is that GNU's manpage lacks the completeness of the
information provided by the Texinfo manual; his direct conversion for
the Debian package is complete, but ugly.

-- 
Micah J. Cowan
http://micah.cowan.name/