All of lore.kernel.org
 help / color / mirror / Atom feed
From: "Michael Kerrisk (man-pages)" <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
To: "linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org"
	<linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org>
Cc: mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org,
	Andrew Josey <ajosey-7882/jkIBncuagvECLh61g@public.gmane.org>,
	Felix Janda <felix.janda-1KBjaw7Xf1+zQB+pC5nmwQ@public.gmane.org>,
	Rich Felker <dalias-/miJ2pyFWUyWIDz0JBNUog@public.gmane.org>,
	John Spencer
	<maillist-musl-Am5OCHYCrcUb1SvskN2V4Q@public.gmane.org>,
	Rob Landley <rob-VoJi6FS/r0vR7s880joybQ@public.gmane.org>,
	Matthew Dempsky <matthew-bfSpyvURsAhAfugRpC6u6w@public.gmane.org>
Subject: POSIX.1-2013 man pages for review
Date: Thu, 19 Sep 2013 09:59:42 +0200	[thread overview]
Message-ID: <523AAEEE.5090602@gmail.com> (raw)

Hello all,

Recently, the Linux man-pages project received kind permission 
from the IEEE and The Open Group to distribute the interface 
specifications from POSIX.1-2013 (also known as POSIX.1-2008 + 
Technical Corrigendum 1) as a set of manual pages. This
allows us to repeat the exercise that was performed in 2004, 
whereby the POSIX.1-2003 man pages were distributed as man pages
for Linux in sections 0p, 1p, and 3p.

Thanks to some work by Felix Janda, we now have a set of
scripts that convert the source format that we received from
IEEE/TOG to the man pages using the "man" macros. Felix has
done some excellent work, and I've spent quite some time 
reviewing the results. However, before definitively releasing
these pages, I would like to have further review of the pages,
and I am soliciting that review with this mail

The main purposes of this review are to:
* detect any problems injected by the conversion process
  (e.g., spurious text added or deleted)
* find any formatting issues with the resulting pages.

If you are interested to help with reviewing these pages, the
amount of time required is up to you: it's simply a question of
how many (randomly selected) pages you care to check over.
Even checking just a half dozen pages is helpful, so long
as you let me know how many pages you checked and whether
you found problems or whether everything looked okay.

A tarball of the converted pages can be found here:

http://man7.org/linux/posix-man-pages/posix-man-pages-130917-draft.tar.gz

Once you have unpacked the tarball, individual pages can be read
using the command

    man -l <pagename>

If desired you can compare the pages against the HTML versions of the 
standard online here:
http://pubs.opengroup.org/onlinepubs/9699919799/

If you would prefer to compare the converted pages against the PFDF 
version of the standard, I believe it is possible to register (without 
cost) at The Open Group website:

https://www2.opengroup.org/ogsys/catalog/t101

to obtain a PDF version of the standard.

Thank you,

Michael
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

             reply	other threads:[~2013-09-19  7:59 UTC|newest]

Thread overview: 13+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2013-09-19  7:59 Michael Kerrisk (man-pages) [this message]
     [not found] ` <523AAEEE.5090602-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2013-09-19  8:44   ` POSIX.1-2013 man pages for review John Spencer
     [not found]     ` <523AB978.2080607-Am5OCHYCrcUb1SvskN2V4Q@public.gmane.org>
2013-09-19 11:00       ` Michael Kerrisk (man-pages)
     [not found]         ` <CAKgNAki+jTS9rkORvcPNxWcStNjnNTnt_jqBYcfoaYm7d4GxqQ-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2013-09-19 17:47           ` Felix Janda
2013-09-20 13:09           ` John Spencer
     [not found]             ` <523C48EF.5080309-Am5OCHYCrcUb1SvskN2V4Q@public.gmane.org>
2013-09-20 17:50               ` Simon Paillard
2013-09-20 17:54               ` Felix Janda
2013-09-21 12:20                 ` John Spencer
     [not found]                   ` <523D8F06.9060801-Am5OCHYCrcUb1SvskN2V4Q@public.gmane.org>
2013-09-22 19:25                     ` Felix Janda
2013-09-24 13:30                       ` John Spencer
2013-10-01 23:16                     ` Rob Landley
  -- strict thread matches above, loose matches on Subject: below --
2013-12-09 17:58 Xose Vazquez Perez
     [not found] ` <52A604CD.6040502-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2014-01-04 10:17   ` Michael Kerrisk (man-pages)

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=523AAEEE.5090602@gmail.com \
    --to=mtk.manpages-re5jqeeqqe8avxtiumwx3w@public.gmane.org \
    --cc=ajosey-7882/jkIBncuagvECLh61g@public.gmane.org \
    --cc=dalias-/miJ2pyFWUyWIDz0JBNUog@public.gmane.org \
    --cc=felix.janda-1KBjaw7Xf1+zQB+pC5nmwQ@public.gmane.org \
    --cc=linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org \
    --cc=maillist-musl-Am5OCHYCrcUb1SvskN2V4Q@public.gmane.org \
    --cc=matthew-bfSpyvURsAhAfugRpC6u6w@public.gmane.org \
    --cc=rob-VoJi6FS/r0vR7s880joybQ@public.gmane.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.