[gentoo-user] No ping man page

[gentoo-user] No ping man page

[reader]

Anyone else noticed there is no man page for ping?  I know I've looked
up things in man ping in the past, maybe quite far in the past and
possibly even on a different distribution, but still I thought maybe
my man page setup was borked but looking at: 
equery files net-misc/iputils (which contains ping) 

I see no man pages mentioned in the output.  



-- 
gentoo-user@lists.gentoo.org mailing list

Re: [gentoo-user] No ping man page

[Andrey Falko]

On Feb 12, 2008 11:06 AM,  <reader@newsguy.com> wrote:
> Anyone else noticed there is no man page for ping?  I know I've looked
> up things in man ping in the past, maybe quite far in the past and
> possibly even on a different distribution, but still I thought maybe
> my man page setup was borked but looking at:
> equery files net-misc/iputils (which contains ping)
>
> I see no man pages mentioned in the output.
>
>
There is a -doc use flag, which if problably disabled by default.....
USE="doc" emerge -1 iputils  ....this way you'll almost certainly get
the man page.
>
> --
> gentoo-user@lists.gentoo.org mailing list
>
>
-- 
gentoo-user@lists.gentoo.org mailing list

Re: [gentoo-user] No ping man page

[Willie Wong]

On Tue, Feb 12, 2008 at 11:12:47AM -0500, Andrey Falko wrote:
> On Feb 12, 2008 11:06 AM,  <reader@newsguy.com> wrote:
> > Anyone else noticed there is no man page for ping?  I know I've looked

I have a ping manpage.

> There is a -doc use flag, which if problably disabled by default.....
> USE="doc" emerge -1 iputils  ....this way you'll almost certainly get
> the man page.

Possibly:

[11:21 AM]wwong man8 $ equery belongs ping.8.bz2 
[ Searching for file(s) ping.8.bz2 in *... ]
net-misc/iputils-20070202 (/usr/share/man/man8/ping.8.bz2)
[11:21 AM]wwong man8 $ equery uses iputils
[ Searching for packages matching iputils... ]
[ Colour Code : set unset ]
[ Legend : Left column  (U) - USE flags from make.conf              ]
[        : Right column (I) - USE flags packages was installed with ]
[ Found these USE variables for net-misc/iputils-20070202 ]
 U I
 + + doc    : Adds extra documentation (API, Javadoc, etc)
 - - ipv6   : Adds support for IP version 6
 - - static : !!do not set this during bootstrap!! Causes binaries to be statically linked instead of dynamically

And, looking at the ebuild, 

        if use doc && type -p docbook2html ; then
                emake -j1 html man || die
        fi

So, yeah. 

W
-- 
Willie W. Wong                                      wwong@math.princeton.edu
408 Fine Hall,  Department of Mathematics,  Princeton University,  Princeton
A mathematician's reputation rests on the number of bad proofs he has given.
-- 
gentoo-user@lists.gentoo.org mailing list

Re: [gentoo-user] No ping man page

[Etaoin Shrdlu]

On Tuesday 12 February 2008, reader@newsguy.com wrote:
> Anyone else noticed there is no man page for ping?  I know I've looked
> up things in man ping in the past, maybe quite far in the past and
> possibly even on a different distribution, but still I thought maybe
> my man page setup was borked but looking at:
> equery files net-misc/iputils (which contains ping)
>
> I see no man pages mentioned in the output.

Short answer: according to Changelog, use USE=doc for iputils until next 
version of iputils comes out (but be prepared to pull in *lots* of stuff 
meanwhile).

Somewhat longer answer: read

http://bugs.gentoo.org/show_bug.cgi?id=158660

Essentially, building man pages for iputils requires openjade + various 
docbook/sgml/xml tools.
-- 
gentoo-user@lists.gentoo.org mailing list

Re: [gentoo-user] No ping man page

[Alan McKinnon]

On Tuesday 12 February 2008, Etaoin Shrdlu wrote:
> Short answer: according to Changelog, use USE=doc for iputils until
> next version of iputils comes out (but be prepared to pull in *lots*
> of stuff meanwhile).
>
> Somewhat longer answer: read
>
> http://bugs.gentoo.org/show_bug.cgi?id=158660
>
> Essentially, building man pages for iputils requires openjade +
> various docbook/sgml/xml tools.

<sigh> Code like this makes me want to vomit. The 
OS-that-shall-not-be-named pulls stunts like this, I really think FLOSS 
stuff should be better.

So, I have to emerge an entire sgml kit to generate a man page. Wow. 
Especially since last time I looked, man pages were not in sgml format 
or even any format that vaguely resembles mark-up

To the upstream iputils dev:

"Dude, wtf were you thinking?"

-- 
Alan McKinnon
alan dot mckinnon at gmail dot com

-- 
gentoo-user@lists.gentoo.org mailing list

[gentoo-user] Re: No ping man page

[reader]

Alan McKinnon <alan.mckinnon@gmail.com> writes:

> <sigh> Code like this makes me want to vomit. The 
> OS-that-shall-not-be-named pulls stunts like this, I really think FLOSS 
> stuff should be better.
>
> So, I have to emerge an entire sgml kit to generate a man page. Wow. 
> Especially since last time I looked, man pages were not in sgml format 
> or even any format that vaguely resembles mark-up
>
> To the upstream iputils dev:
>
> "Dude, wtf were you thinking?"

Yup, it does seem way over the top.  Surely though there is some
rhyme to the reason.  Man pages are such a large part of the very
essence of unix.  It seems a serious shame that a user is better off
googling for `linux man ping' than the long standing `man ping'.  The
more so since someone needing the man page for ping is somewhat more
likely to be having network troubles than the average bear, and may
not be able to google.

I took Alans' comment as at root, friendly, and maybe the devs if any
read it will too.  But please any developer who can ... explain what
is the reasoning here.

-- 
gentoo-user@lists.gentoo.org mailing list

Re: [gentoo-user] Re: No ping man page

[Alan McKinnon]

[-- Attachment #1: Type: text/plain, Size: 1185 bytes --]

On Tuesday 12 February 2008, reader@newsguy.com wrote:
> Yup, it does seem way over the top.  Surely though there is some
> rhyme to the reason.  Man pages are such a large part of the very
> essence of unix.  It seems a serious shame that a user is better off
> googling for `linux man ping' than the long standing `man ping'.

In the interest of benefiting the entire gentoo community, reducing 
frustration levels and helping fellow gentoo users from having to 
download 8M of stuff to get the ping man page restored to it's rightful 
place of honour, I hereby humbly offer the following miniscule 
attachment - the ping man page nicked off a conveniently located Ubuntu 
machine. At a mere 5539 bytes it's size is negligible compared to the 
bandwidth that will be otherwise consumed.

Save attachment as /usr/local/share/man/man8/ping.8.gz
then
chown root:root /usr/local/share/man/man8/ping.8.gz
chmod 0644 /usr/local/share/man/man8/ping.8.gz

To round off the package I can supply suitable man pages for arping and 
tracepath as well at the grand size of 1481 and 1785 bytes respectively

:-)


-- 
Alan McKinnon
alan dot mckinnon at gmail dot com


[-- Attachment #2: ping.8.gz --]
[-- Type: application/x-gzip, Size: 5539 bytes --]