Re: [PATCH/RFC 0/6] ld.so.8: some improvements from Debian

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Sorry I took so long to get around to reviewing this. Some comments:

-       /lib/ld-linux.so.*  [OPTIONS] [PROGRAM [ARGUMENTS]]
+       /lib/ld-linux.so.*  [--list] [--verify] [--library-path
+       paths] [--inhibit-rpath objects] [--audit auditors] program
+       [arg...]

Unless the options to a program are very short, I don't like to see
them all listed in a synopsis, as it's too long-winded.

Also, I prefer upper-case for metasyntactic variables in man pages. So
in fact, the original is fine, though I do like ellipsis to indicate
multiple arguments, so:

-       /lib/ld-linux.so.*  [OPTIONS] [PROGRAM [ARGUMENTS]]
+       /lib/ld-linux.so.*  [OPTION...] [PROGRAM [ARGUMENT...]]

I don't think the phrase '"turn-key"' is helpful here; I'd remove it.

+       hardware capabilities such as /usr/lib/sse2/. The dynamic

Insert comma after "hardware capabilities".

+       CPU. The following names are currently recognized: Alpha ev4,
+       ev5, ev56, ev6, ev67

Insert para break before "Alpha".

+              multiple version of the same library is

version → versions

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


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux