Manpage broken

[Sven Herzberg]

...
       -Y on/off
       --proxy=on/off
           Turn proxy support on or off. The proxy is on by default if the
           appropriate environment variable is defined.

           For more information about the use of proxies with Wget,

       -Q quota
       --quota=quota
...

The sentence has been cut a bit too short :)

[Matt Zimmerman (mdz)]

The wget man page is generated from pod, which is generated from texinfo. The
bug is likely either in pod2man or texi2pod.pl

[Adam Conrad (adconrad)]

The sentence is cut short because in the original info docs, the remainder
of the sentence is dedicated to pointing you toward another info node. If
these sentences (there are two of them) were rearranged to "*Note Foo::,
for more information about bar.", the conversion tools would completely
remove them, instead of leaving them dangling, and no one would be the
wiser.

It's purely a cosmetic issue, mind you, as the rearranged (and now
disappearing) sentences would provide you with no more information than
before.

[Ralph Corderoy (ralph-inputplus)]

It's texi2pod.pl that's dropping some of the *.texi on the floor.
There's another instance where it happens too.

    $ grep -1 '^ *For more info' wget.{texi,pod,1}
    wget.texi-
    wget.texi:For more information about the use of proxies with Wget,
@xref{Proxies}.
    wget.texi-
    --
    wget.texi-
    wget.texi:For more information about security issues with Wget, @xref{Security
    wget.texi-Considerations}.
    --
    wget.pod-
    wget.pod:For more information about the use of proxies with Wget,
    wget.pod-
    --
    wget.pod-
    wget.pod:For more information about security issues with Wget,
    wget.pod-
    --
    wget.1-.Sp
    wget.1:For more information about the use of proxies with Wget,
    wget.1-.IP "\fB\-Q\fR \fIquota\fR" 4
    --
    wget.1-.Sp
    wget.1:For more information about security issues with Wget,
    wget.1-.IP "\fB\-C on/off\fR" 4
    $

It would be nice to get this fixed, even if it's just to re-word
wget.texi so the whole sentence disappears, in order that others don't
spot the problem and have to investigate before finding out it's a known
bug.

[Daniel Robitaille (robitaille)]

Still present in Dapper.

[Simon Law (sfllaw)]

texi2pod also fails to handle @pxref macros properly.

[Lionel Le Folgoc (mrpouit)]

Still present in edgy.

[Ralph Corderoy (ralph-inputplus)]

It seems all the texi2pod.pl's that are found in various packages may all have descended from gcc's. Perhaps gcc's latest version fixes some of these problems, or maybe that's the version to look at fixing so other improvements aren't discarded. Other projects may refresh their copy by grabbing the latest gcc version in the future. http://gcc.gnu.org/viewcvs/trunk/contrib/texi2pod.pl?view=log

[Micah Cowan (micahcowan)]

This issue has been fixed in upstream sources, Wget version 1.11. The best option is probably to wait for the next sync (after the Debian package has been issued). See relevant upstream changesets http://hg.addictivecode.org/wget/1.11/rev/35cd2b77a6ac and http://hg.addictivecode.org/wget/1.11/rev/5221ff559215.

[Colin Watson (cjwatson)]

Intrepid now has wget 1.11.3-1ubuntu1, fixing this bug as Micah described.