Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 28 Apr 2014 20:18:07 -0400
From:      "illoai@gmail.com" <illoai@gmail.com>
To:        "Ronald F. Guilmette" <rfg@tristatelogic.com>
Cc:        "freebsd-questions@freebsd.org" <freebsd-questions@freebsd.org>
Subject:   Re: missing man pages
Message-ID:  <CAHHBGkowe3LtCrncHMUfC9GDUwPfnXXgT0UaKLqb=dSdh21cQA@mail.gmail.com>
In-Reply-To: <43930.1398634658@server1.tristatelogic.com>
References:  <43930.1398634658@server1.tristatelogic.com>

next in thread | previous in thread | raw e-mail | index | archive | help
On 27 April 2014 17:37, Ronald F. Guilmette <rfg@tristatelogic.com> wrote:
>
> I just now noticed a few processes running (via ps -ax) that don't
> appear to have associated man pages:
>
> gconfd-2
> polkitd
> console-kit-daemon
> hald-addon-mouse-sysmouse:
> hald-runner
>
>
> Does anyone other than me think that this is something that should be
> rectified?
>
> Note that there does appear to exist a man page elsewhere for at least
> one of the above:
>
>    http://www.freedesktop.org/software/polkit/docs/latest/polkitd.8.html
>
> I have no idea why that didn't get installed on my FreeBSD (9.1) system.
>

It's up to a maddening combination of third-party developers
(who may be prejudiced against useful tools like man(1)) and
port maintainers (who may be confused, uncaring, jaded, or
wrong) to provide the man pages for third-party applications.

It used to be that debian did man pages for a lot of things that
(misguided) linux kids didn't want to document well (info(1) is
such a lame attempt, guys.  Stop already), but you'd have to
count on the maintainer to pull those in.

For stuff from the ports tree, I'd suggest a polite question to
the maintainer before you fire off a PR: there may be good
reasons they don't come with decent documentation.

You can also do the tedious:
% pkg which /path/to/offending file
% pkg info -R resulting_pkg_name | grep /usr/local/man

or some equivalent nonsense.  Maybe it will give you
something, but don't count on it.

Fr'instance, the obnoxious devel/dbus installs no man pages,
so you have to guess at its true purpose.  Maybe it makes hot-
dogs, maybe it just e-mails the NSA when you utter profanities,
maybe it does something else.  Good luck!

-- 
--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAHHBGkowe3LtCrncHMUfC9GDUwPfnXXgT0UaKLqb=dSdh21cQA>