[doc, committed] add/fix @opindex entries

Sandra Loosemore sandra@codesourcery.com
Sat Jan 3 21:38:00 GMT 2015


This is another in my series of cleanups to the GCC user documentation.

I noticed that some recently-added options documented in invoke.texi 
were missing @opindex entries, or had incorrect ones.  I made a pass 
through the whole file to try to fix all the mistakes of this sort that 
I spotted -- I probably missed some, but at least this is an incremental 
improvement.

The manual isn't consistent about whether the no-* forms of options are 
explicitly listed and/or given entries in the index.  (In some cases 
there are index entries without specific listing of the no-* option in 
the documentation, too.)  In general I did not mess with that, except 
for the very long group of i386 -mmmx, -msse, etc options.  Some of 
these had negative forms listed and others didn't, and because the list 
was so long (spanning multiple pages) already, I thought it better to 
remove the existing entries for the -mno-* guys rather than make the 
list even bigger by adding the missing ones.  While I was at it, I 
diddled with the formatting a bit to allow page breaks to be inserted 
anywhere in this long @itemx sequence.

Since this is all boring tech writer stuff rather than substantive 
changes, I've checked it in under the obvious fix rule.

-Sandra

2015-01-03  Sandra Loosemore  <sandra@codesourcery.com>

	gcc/
	* doc/invoke.texi ([-fplan9-extensions]): Add/fix @opindex.
	([-fvtv-debug]): Likewise.
	([-Wc++-compat]): Likewise.
	([-Wc++11-compat]): Likewise.
	([-Wc++14-compat]): Likewise.
	([-Wno-sized-deallocation]): Likewise.
	([-femit-class-debug-always]): Likewise.
	([-femit-struct-debug-detailed]): Likewise.
	([-fno-keep-inline-dllexport]): Likewise.
	([-fira-algorithm]): Likewise.
	([-fira-region]): Likewise.
	([-flra-remat]): Likewise.
	([-fipa-ra]): Likewise.
	([-fhoist-adjacent-loads]): Likewise.
	([-fisolate-erroneous-paths-dereference]): Likewise.
	([-fisolate-erroneous-paths-attribute]): Likewise.
	([-ftree-switch-conversion]): Likewise.
	([-ftree-tail-merge]): Likewise.
	([-ftree-loop-if-convert]): Likewise.
	([-ftree-loop-if-convert-stores]): Likewise.
	([-ftree-loop-distribution]): Likewise.
	([-ftree-loop-distribute-patterns]): Likewise.
	([-flto-compression-level]): Likewise.
	([-flto-report]): Likewise.
	([-flto-report-wpa]): Likewise.
	([-fuse-linker-plugin]): Likewise.
	([-mfix-cortex-a53-835769]): Likewise.
	([-mno-fix-cortex-a53-835769]): Likewise.
	([-mmmx]...[-mno-3dnow]): Remove the -mno- forms from the
	explicit listing; add a note to the discussion indicating they
	exist.  Reorder table to group similar options.  Add missing
	@opindex entries.  Add @need commands throughout the table to
	allow it to be split across multiple pages.
	([-m8bit-idiv]): Fix @opindex.
	([-mavx256-split-unaligned-load]): Likewise.
	([-mavx256-split-unaligned-store]): Likewise.
	([-mstack-protector-guard]): Likewise.
	([-mcpu=]): Likewise.
	([-mcpu]): Likewise.
	([-mpointer-size=]): Likewise.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: opindex.patch
Type: text/x-patch
Size: 14940 bytes
Desc: not available
URL: <http://gcc.gnu.org/pipermail/gcc-patches/attachments/20150103/cc1d32e0/attachment.bin>


More information about the Gcc-patches mailing list