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

Reuben Thomas
2011-11-07T08:41:38Z

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

--