From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.org/gmane.linux.lib.musl.general/3521 Path: news.gmane.org!not-for-mail From: Rob Landley Newsgroups: gmane.linux.lib.musl.general Subject: Re: Request for volunteers Date: Sun, 30 Jun 2013 22:13:23 -0500 Message-ID: <1372648403.5019.0@driftwood> References: <20130630055202.GA16580@brightrain.aerifal.cx> <20130630121345.GR29800@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; DelSp=Yes; Format=Flowed Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1372648429 9801 80.91.229.3 (1 Jul 2013 03:13:49 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 1 Jul 2013 03:13:49 +0000 (UTC) Cc: musl@lists.openwall.com To: musl@lists.openwall.com Original-X-From: musl-return-3525-gllmg-musl=m.gmane.org@lists.openwall.com Mon Jul 01 05:13:51 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 1UtUYo-0003OO-Sq for gllmg-musl@plane.gmane.org; Mon, 01 Jul 2013 05:13:50 +0200 Original-Received: (qmail 26309 invoked by uid 550); 1 Jul 2013 03:13:49 -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 26301 invoked from network); 1 Jul 2013 03:13:49 -0000 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=date:from:subject:to:cc:references:in-reply-to:x-mailer:message-id :mime-version:content-type:content-disposition :content-transfer-encoding:x-gm-message-state; bh=vba8DzaJY+2NHmcZyhC96s8H0JLg3JxmzyTRQOUGadE=; b=oPbBKM+vL+P11b2XtiXozK5y7PPQc9Fhkxczcp6H/tuajfbK5+JlLNJNzt4fdXg0f9 6m+N0fwu/EAy+iI5Ir5sQ1atlYCMiH0bEUW423aQarG7i8F6xbXf67YJBFoilkUtDzyM HnJnkW6hAgLxT3fZLA8Od23Te47jR3k4AyKULTAkgxzQTqhvb2aHPLrKv+cKd/0jdblj mR+Dht7s/XMRLgyQLRSN9Mu0vNid6Ul5jR49Cx0w/pSm7LhsJj7pbI0GWUqKq3IcsaS/ FBA/uITLnXGQvjaa9ROmAOSVDuuAwUucn8ud8LWwuMgBj35D6lCUCZ7NSm77xpJXT7fu Y+AQ== X-Received: by 10.50.118.74 with SMTP id kk10mr13639804igb.2.1372648417482; Sun, 30 Jun 2013 20:13:37 -0700 (PDT) In-Reply-To: <20130630121345.GR29800@brightrain.aerifal.cx> (from dalias@aerifal.cx on Sun Jun 30 07:13:45 2013) X-Mailer: Balsa 2.4.11 Content-Disposition: inline X-Gm-Message-State: ALoCoQmc69iwEG7+Ah0ye2UPcWmuSI1cVaY/AWfp6VuHCMxyBJ5v+cVpkdiUgVrbuNqP/Xx7Osf8 Xref: news.gmane.org gmane.linux.lib.musl.general:3521 Archived-At: On 06/30/2013 07:13:45 AM, Rich Felker wrote: > On Sun, Jun 30, 2013 at 01:02:03PM +0200, Daniel Cegie=C5=82ka wrote: > > Rich, you missed something: > > > > 6. Man pages for musl. We need to describe the functions and > > namespaces in header files. >=20 > 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.) Michael Kerrisk does man pages. The best thing to do is feed him =20 information about musl-specific stuff. He can probably do some kind of =20 inline notation in his (docbook?) masters to make musl versions and =20 glibc versions. Reinventing this wheel would suck. > 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. I note that the guy who did the posix man pages ten years ago was: =20 Michael Kerrisk. (Honestly, posix seems to be slipping into some kind of dotage. One if =20 its driving forces these days is Jorg Schilling. Let that sink in for a =20 bit.) > 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). Interface with the linux man pages project. They don't have strong =20 glibc loyalty, they're just trying to document what people actually use. Rob =