From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.org/gmane.linux.lib.musl.general/3560 Path: news.gmane.org!not-for-mail From: Justin Cormack Newsgroups: gmane.linux.lib.musl.general Subject: Re: Re: Linux manpages (was Re: [musl] Request for volunteers) Date: Sun, 7 Jul 2013 00:04:04 +0100 Message-ID: References: <20130701174411.GA1631@gauss> <20130706215227.GC26987@newbook> Reply-To: musl@lists.openwall.com NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/alternative; boundary=047d7b33da14ee69f604e0dfd374 X-Trace: ger.gmane.org 1373151857 14790 80.91.229.3 (6 Jul 2013 23:04:17 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 6 Jul 2013 23:04:17 +0000 (UTC) Cc: Isaac To: musl@lists.openwall.com Original-X-From: musl-return-3564-gllmg-musl=m.gmane.org@lists.openwall.com Sun Jul 07 01:04:19 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 1UvbWc-0003JT-BS for gllmg-musl@plane.gmane.org; Sun, 07 Jul 2013 01:04:18 +0200 Original-Received: (qmail 32392 invoked by uid 550); 6 Jul 2013 23:04:17 -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 32384 invoked from network); 6 Jul 2013 23:04:17 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=specialbusservice.com; s=google; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=eW2OSqO1/HICYPwMylhuhz+JzUno3ZxSevjHQxDRzE4=; b=BLLvz7E7W+xmecNtgk1LEglDQro8PFd3jOz1CDzjOeyiTmsCpBJhVKR0sXs8OAaT49 hFfjZZnxd7cl5Wbrz2H3e2jukhIS4HJLQM30YvDvXahIi2GY1xpJy4HmAW+1fd9e6nVM UP93xmimzP+xD/9aoTvVwTTvrInRma2wUBUeQ= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type:x-gm-message-state; bh=eW2OSqO1/HICYPwMylhuhz+JzUno3ZxSevjHQxDRzE4=; b=IEzMnuB0fv4x2WLkbxpedJ/svdX9/TwC532Z3JAkhG0gU818c0hXu0xeoQPuFmlToU A38o4d7AMzRUz0BMmoR+SkWyEQB1SRE4Bvk+LV6v5kYfFi3H4Sxv7z5M38bHGwoYPsNp cr6BZO3NAAsZ6Wu1tr9fHSmLJVyNeU4ntSBhSAyfDkNAuWXzR4ikpxEaA2JGB0aj1KPA gM1ZD4MMHPsIn+wieFmZ1IAXIORoL8Jcy/TZjtVfAhZFTndgDVA7/6ra7ck3FvcrfG2t lz5QbMCj0E8/gBSX8pBxxwYGuUbLI0DFpFg4VKJKIQwdxyy7PLPTyx2NTJO0P1U7GlZH n1vg== X-Received: by 10.68.232.41 with SMTP id tl9mr15235320pbc.204.1373151844783; Sat, 06 Jul 2013 16:04:04 -0700 (PDT) In-Reply-To: X-Gm-Message-State: ALoCoQmgtFlhTsvN8ybystHopBWAT/sfddjpNk2yGYnAJ/UkuOJcAnkfwLSZI+RhfZ0VSTmfTb1z Xref: news.gmane.org gmane.linux.lib.musl.general:3560 Archived-At: --047d7b33da14ee69f604e0dfd374 Content-Type: text/plain; charset=UTF-8 On 6 Jul 2013 23:12, "Michael Kerrisk (man-pages)" wrote: > > Hello Isaac, > > On Sat, Jul 6, 2013 at 11:52 PM, Isaac wrote: > > Hello, > > On Tue, Jul 02, 2013 at 03:08:52AM +0200, Michael Kerrisk (man-pages) wrote: > >> Gidday, > >> > >> On Mon, Jul 1, 2013 at 7:44 PM, Felix Janda wrote: > >> > Hello, > >> > > >> > Rich Felker wrote: > > > >> >> Maybe someone should contact him about all the stuff we're discussing. > >> > > >> > I asked him some time ago about the posix man pages and offered help with the > >> > conversion. > >> > > >> > He has interest in creating new posix man pages for the SUSV4 TC1. The status > >> > from beginning of June was that he had contacted The Open Group asking for > >> > permission. Possibly, we might get troff sources. > >> > >> As of a few days ago, the necessary permissions are granted. I do not > >> yet have the source files (and so am unsure of the source format), but > >> I expect that they will become available to us in the next couple of > >> weeks. > > > > On a slightly related note, would you be interested in patches for the > > Linux manpages briefly documenting places where musl differs from glibc > > (in the NOTES section, along the same lines as the notes about libc4/libc5)? > > Historically, man-pages has primarily documented glibc + syscalls, but > there's nothing firm about that. It's more been about limited time > resources and the fact that glibc is the most widely used libc. I'd > have no objection to musl-specific notes in the man-pages. Perhaps a > patch to libc(7) would be a good place to start. The man(2) section is rather glibc specific and makes the syscall details rather subsidiary. I will try to send some patches if these would be welcome. Justin > Cheers, > > Michael > > > -- > Michael Kerrisk > Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ > Author of "The Linux Programming Interface"; http://man7.org/tlpi/ --047d7b33da14ee69f604e0dfd374 Content-Type: text/html; charset=UTF-8


On 6 Jul 2013 23:12, "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com> wrote:
>
> Hello Isaac,
>
> On Sat, Jul 6, 2013 at 11:52 PM, Isaac <idunham@lavabit.com> wrote:
> > Hello,
> > On Tue, Jul 02, 2013 at 03:08:52AM +0200, Michael Kerrisk (man-pages) wrote:
> >> Gidday,
> >>
> >> On Mon, Jul 1, 2013 at 7:44 PM, Felix Janda <felix.janda@posteo.de> wrote:
> >> > Hello,
> >> >
> >> > Rich Felker wrote:
> >
> >> >> Maybe someone should contact him about all the stuff we're discussing.
> >> >
> >> > I asked him some time ago about the posix man pages and offered help with the
> >> > conversion.
> >> >
> >> > He has interest in creating new posix man pages for the SUSV4 TC1. The status
> >> > from beginning of June was that he had contacted The Open Group asking for
> >> > permission. Possibly, we might get troff sources.
> >>
> >> As of a few days ago, the necessary permissions are granted. I do not
> >> yet have the source files (and so am unsure of the source format), but
> >> I expect that they will become available to us in the next couple of
> >> weeks.
> >
> > On a slightly related note, would you be interested in patches for the
> > Linux manpages briefly documenting places where musl differs from glibc
> > (in the NOTES section, along the same lines as the notes about libc4/libc5)?
>
> Historically, man-pages has primarily documented glibc + syscalls, but
> there's nothing firm about that. It's more been about limited time
> resources and the fact that glibc is the most widely used libc. I'd
> have no objection to musl-specific notes in the man-pages. Perhaps a
> patch to libc(7) would be a good place to start.

The man(2) section is rather glibc specific and makes the syscall details rather subsidiary. I will try to send some patches if these would be welcome.

Justin

> Cheers,
>
> Michael
>
>
> --
> Michael Kerrisk
> Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
> Author of "The Linux Programming Interface"; http://man7.org/tlpi/

--047d7b33da14ee69f604e0dfd374--