From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.org/gmane.linux.lib.musl.general/3516 Path: news.gmane.org!not-for-mail From: Rich Felker Newsgroups: gmane.linux.lib.musl.general Subject: Re: Request for volunteers Date: Sun, 30 Jun 2013 08:13:45 -0400 Message-ID: <20130630121345.GR29800@brightrain.aerifal.cx> References: <20130630055202.GA16580@brightrain.aerifal.cx> Reply-To: musl@lists.openwall.com NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: ger.gmane.org 1372594437 19903 80.91.229.3 (30 Jun 2013 12:13:57 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 30 Jun 2013 12:13:57 +0000 (UTC) To: musl@lists.openwall.com Original-X-From: musl-return-3520-gllmg-musl=m.gmane.org@lists.openwall.com Sun Jun 30 14:13:59 2013 Return-path: Envelope-to: gllmg-musl@plane.gmane.org Original-Received: from mother.openwall.net ([195.42.179.200]) by plane.gmane.org with smtp (Exim 4.69) (envelope-from ) id 1UtGVy-0004ZJ-NV for gllmg-musl@plane.gmane.org; Sun, 30 Jun 2013 14:13:58 +0200 Original-Received: (qmail 10124 invoked by uid 550); 30 Jun 2013 12:13:58 -0000 Mailing-List: contact musl-help@lists.openwall.com; run by ezmlm Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: Original-Received: (qmail 10116 invoked from network); 30 Jun 2013 12:13:57 -0000 Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.21 (2010-09-15) Xref: news.gmane.org gmane.linux.lib.musl.general:3516 Archived-At: On Sun, Jun 30, 2013 at 01:02:03PM +0200, Daniel Cegiełka wrote: > Rich, you missed something: > > 6. Man pages for musl. We need to describe the functions and > namespaces in header files. This is a good topic for discussion. My documentation goal for 1.0 has been aligned with the earlier docs outline proposal I sent to the list a while back. Full man pages would be a much bigger task, and it's not even something a volunteer could do without some major collaboration with people who have a detailed understanding of every function in musl. (Sadly, wrong man pages are probably worse than no man pages.) What might be better for the near future is to get the POSIX man pages project updated to match POSIX-2008+TC1 so that users of musl who want man pages for libc functions can install them and have them match the current version. Separate man pages could then be made for nonstandard functions or functions that require significant implementation specific documentation, possibly based on the Linux man pages project, but with glibc-specific information just removed (for functions that are predominantly kernel-level) or changed (where documenting musl semantics matters). Rich