Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 27 Apr 2014 23:50:37 +0200
From:      Polytropon <freebsd@edvax.de>
To:        "Ronald F. Guilmette" <rfg@tristatelogic.com>
Cc:        freebsd-questions@freebsd.org
Subject:   Re: missing man pages
Message-ID:  <20140427235037.c0e94eb6.freebsd@edvax.de>
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 Sun, 27 Apr 2014 14:37:38 -0700, Ronald F. Guilmette 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

Those are "desktop related" and mainly come from "Linux land",
so don't expect documentation be present in manpages named after
the binary.

Regarding HAL, see "man hal". Also check if there's local
documentation installed in /usr/local/share/doc or maybe
in a different directory beneath /usr/local, depending on
the port.



> Does anyone other than me think that this is something that should be
> rectified?

No. Because nobody needs documentation these days. :-)

Honestly: The attitude towards documentation is quite different
in "Linux land" (where many applications, ported to FreeBSD,
initially come from). You'll find documentation somewhere,
that's not the point, but it might be outdated, incorrect,
scattered across the web, in web forums, user pages, wikis,
somewhere in your local file system, or via --help et al.
command line options.

In comparison, FreeBSD is a dreamland for developers: There's
a manpage for virtually everything: System binaries, file
formats, kernel interfaces, library functions, device drivers,
maintenance procedures - all accessible locally.



> 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.

I have a "man 8 polkitd" on my FreeBSD 8 home system, so
at least it has been present. Maybe it has "moved to the
project's wiki"?

(Some similarly sad thing has happened to the excellent
documentation of TSK which is not available locally anymore,
just a "friendly pointer" to a web resource remains...)



> Should I file PRs on these things?

Probably yes. See if there is someone among the maintainers
who is interested in making manpages available.



-- 
Polytropon
Magdeburg, Germany
Happy FreeBSD user since 4.0
Andra moi ennepe, Mousa, ...



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20140427235037.c0e94eb6.freebsd>