From owner-freebsd-questions@FreeBSD.ORG Tue Apr 29 00:18:09 2014 Return-Path: Delivered-To: freebsd-questions@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id BB9E4E3B for ; Tue, 29 Apr 2014 00:18:09 +0000 (UTC) Received: from mail-wg0-x22e.google.com (mail-wg0-x22e.google.com [IPv6:2a00:1450:400c:c00::22e]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 57B5413D3 for ; Tue, 29 Apr 2014 00:18:09 +0000 (UTC) Received: by mail-wg0-f46.google.com with SMTP id a1so1641861wgh.29 for ; Mon, 28 Apr 2014 17:18:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=oys2D9Omkh+oQOD456lD9ZYgFhAOXgQRIjirCNSWV90=; b=JHjXgoNa9G9GsuXFu1XwD2ezYZ5K/Au+iWUy54i2asis4Eo1QI3R2mX5OLsAFUJs0E SQ/GrVQusmm/s1J+Bc2j0tQrJzme/iDGKxPvOMVC+IYReK52yCt90JrObEAnbwvuxoAm nC3JsvlKkIYd4RYeSoV8z9askZFljNK4rJlggvdCeM25wCIThpbqwLpt8mMqbSZc5qUx dSid63RgLBsqRGywvrVIiM1nIXdKmnfrQJ4Hhm9nnC+ultTwnc4pMjw0B8dHvokQ9cYI YbQIz9H7TVwvzU8Sjx7SOgToCZ6/wNjKKGXU4TzOC1dNGO4Cu00jRh9aqf5wAyDdjwqC vjvQ== MIME-Version: 1.0 X-Received: by 10.181.13.137 with SMTP id ey9mr17648453wid.54.1398730687618; Mon, 28 Apr 2014 17:18:07 -0700 (PDT) Received: by 10.216.86.145 with HTTP; Mon, 28 Apr 2014 17:18:07 -0700 (PDT) In-Reply-To: <43930.1398634658@server1.tristatelogic.com> References: <43930.1398634658@server1.tristatelogic.com> Date: Mon, 28 Apr 2014 20:18:07 -0400 Message-ID: Subject: Re: missing man pages From: "illoai@gmail.com" To: "Ronald F. Guilmette" Content-Type: text/plain; charset=UTF-8 Cc: "freebsd-questions@freebsd.org" X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 29 Apr 2014 00:18:09 -0000 On 27 April 2014 17:37, 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 > > > 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! -- --