On Wed, 23 Apr 2008, Michael Kerrisk wrote:
We perhaps disagree a little on the balance between that and other
factors, but I think we fundamentally agree on what's good to aim for.
I think so. I had written rather more on the subject but deleted it as I
thought I would be unlikely to convince you!
PS I added a subheaduing in mmap.2 and am wondering about whether
msgop.2, semop.2, shmop.2, and getopt.3 could do with some
restructuring and/or headings to make their structure clearer.
The odd thing about msgop(2) is that there is no msgop(2). I suggest fixing
that by removing the text "msgop" from the page, and renaming it to msgsnd.2
or msgrcv.2, and having msgop.2 link to it.
Other than that I have no problem with the structure of the page, as one
probably needs to understand sending and receiving together.
In getopt.3 I would have a heading for the long variants.
shmop.2 has the same problem as msgop.2, and looks like it could do with
per-function headings.
semop.2 actually exists! and I have no problem with its layout.
--
http://rrt.sc3d.org/ | Floc: an egregiously good aperitif
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
