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
next 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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).