PATCH: tidy documentation of ld command-line option syntax

[Sandra Loosemore]

Dave Korn wrote:
> 
>   Yeah.  Your suggestion is nice: I agree the joined forms are less clear for
> the single-letter options.  How about we append a bit to the bit about passing
> options via the driver just to mention the joined forms are the easier to use
> in that context, so people don't think "I can't use -o=value so I have to use
> -Xlinker -o -Xlinker value" when they see only "-o VALUE" and not "-oVALUE"?

OK.  How's this version of the patch?

-Sandra


2009-02-23  Sandra Loosemore  <sandra@codesourcery.com>

	ld/
	* ld.texinfo (Options): Recommend using joined forms of syntax for
	passing options with arguments from a driver.
	(-a): Use consistent syntax for documenting option arguments.
	Clean up indexing and markup.
	(-A/--architecture): Likewise.
	(-f/--auxiliary): Likewise.
	(-F/--filter): Likewise.
	(-fini): Likewise.
	(-G/--gpsize): Likewise.
	(-h/-soname):Likewise.
	(-init): Likewise.
	(-l/--library): Likewise.
	(-L/--library-path): Likewise.
	(-m): Likewise.
	(--defsym): Likewise.
	(-I/--dynamic-linker): Likewise.
	(-Map): Likewise.
	(--oformat): Likewise.
	(--retain-symbols-file): Likewise.
	(-rpath): Likewise.
	(-rpath-link): Likewise.
	(--sort-common): Likewise.
	(--sort-section): Likewise.
	(--split-by-file): Likewise.
	(--split-by-reloc): Likewise.
	(--sysroot): Likewise.
	(--section-start): Likewise.
	(-Tbss, -Tdata, -Ttext): Likewise.
	(-Ttext-segment): Likewise.
	(--version-script): Likewise.
	(--wrap): Likewise.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: binutils.patch
Type: text/x-patch
Size: 13540 bytes
Desc: not available
URL: <https://sourceware.org/pipermail/binutils/attachments/20090223/ed89448f/attachment.bin>