btw, from proc(5) for Linux:

user   (1) Time spent in user mode.

nice   (2) Time spent in user mode with low priority (nice).

system (3) Time spent in system mode.

idle   (4) Time spent in the idle task.  This value should be USER_HZ times the second entry in the /proc/uptime pseudo-file.

iowait (since Linux 2.5.41)
      (5) Time waiting for I/O to complete.

irq (since Linux 2.6.0-test4)
      (6) Time servicing interrupts.

softirq (since Linux 2.6.0-test4)
      (7) Time servicing softirqs.

[…]

I’d expect these values to mean similar things on other OS, so it might be worth using descriptions based on these?

s/operating-system related/operating system-related/

According to the current list of valid operating systems in configure and the name changes in node.gyp, this list should be:

• aix
• android
• darwin
• freebsd
• linux
• openbsd
• sunos
• win32

uname(3) should have a posix link like other such man page links now have in the docs.

e.g. in the fs docs.

Man page references are automatically converted to links by the doctool, so there’s no real need for that.

I've seen capitalization differing in various parts of all of the docs. Should we stick to capitals or no?

I'm planning to make a second pass to improve the consistency of argument types. For now I'm focusing primarily on making sure that arguments are even listed in the first place.