doc: @var fixes.

gcc/:
	* doc/cppopts.texi: Use @var when appropriate.
	* doc/extend.texi (Structure-Packing Pragmas): Likewise.
	* doc/gimple.texi (Logical Operators)
	(Adding a new GIMPLE statement code): Likewise.
	* doc/invoke.texi (Target Options, Precompiled Headers):
	Likewise.
	* doc/plugins.texi (Plugins): Likewise.

From-SVN: r168081
This commit is contained in:
Ralf Wildenhues 2010-12-20 07:26:12 +00:00 committed by Ralf Wildenhues
parent 987977840a
commit 917e11d7fd
6 changed files with 26 additions and 18 deletions

View File

@ -1,5 +1,13 @@
2010-12-20 Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
* doc/cppopts.texi: Use @var when appropriate.
* doc/extend.texi (Structure-Packing Pragmas): Likewise.
* doc/gimple.texi (Logical Operators)
(Adding a new GIMPLE statement code): Likewise.
* doc/invoke.texi (Target Options, Precompiled Headers):
Likewise.
* doc/plugins.texi (Plugins): Likewise.
* doc/install.texi (Configuration, Building, Testing, Specific):
Remove leading whitespace from examples.

View File

@ -330,10 +330,10 @@ header is used.
@opindex fpch-preprocess
This option allows use of a precompiled header (@pxref{Precompiled
Headers}) together with @option{-E}. It inserts a special @code{#pragma},
@code{#pragma GCC pch_preprocess "<filename>"} in the output to mark
the place where the precompiled header was found, and its filename. When
@option{-fpreprocessed} is in use, GCC recognizes this @code{#pragma} and
loads the PCH@.
@code{#pragma GCC pch_preprocess "@var{filename}"} in the output to mark
the place where the precompiled header was found, and its @var{filename}.
When @option{-fpreprocessed} is in use, GCC recognizes this @code{#pragma}
and loads the PCH@.
This option is off by default, because the resulting preprocessed output
is only really suitable as input to GCC@. It is switched on by

View File

@ -12989,7 +12989,7 @@ to be a small power of two and specifies the new alignment in bytes.
@item @code{#pragma pack(@var{n})} simply sets the new alignment.
@item @code{#pragma pack()} sets the alignment to the one that was in
effect when compilation started (see also command-line option
@option{-fpack-struct[=<n>]} @pxref{Code Gen Options}).
@option{-fpack-struct[=@var{n}]} @pxref{Code Gen Options}).
@item @code{#pragma pack(push[,@var{n}])} pushes the current alignment
setting on an internal stack and then optionally sets the new alignment.
@item @code{#pragma pack(pop)} restores the alignment setting to the one

View File

@ -635,7 +635,7 @@ access the operands.
When adding a new operand to a gimple statement, the operand will
be validated according to what each tuple accepts in its operand
vector. These predicates are called by the
@code{gimple_<name>_set_...()}. Each tuple will use one of the
@code{gimple_@var{name}_set_...()}. Each tuple will use one of the
following predicates (Note, this list is not exhaustive):
@deftypefn {GIMPLE function} is_gimple_operand (tree t)
@ -2497,7 +2497,7 @@ in @code{gimple.c}.
You will probably want to create a function to build the new
gimple statement in @code{gimple.c}. The function should be called
@code{gimple_build_<@code{NEW_TUPLE_NAME}>}, and should return the new tuple
@code{gimple_build_@var{new-tuple-name}}, and should return the new tuple
of type gimple.
If your new statement requires accessors for any members or

View File

@ -9856,10 +9856,10 @@ proper position among the other output files.
@cindex compiler version, specifying
@cindex target machine, specifying
The usual way to run GCC is to run the executable called @file{gcc}, or
@file{<machine>-gcc} when cross-compiling, or
@file{<machine>-gcc-<version>} to run a version other than the one that
was installed last.
The usual way to run GCC is to run the executable called @command{gcc}, or
@command{@var{machine}-gcc} when cross-compiling, or
@command{@var{machine}-gcc-@var{version}} to run a version other than the
one that was installed last.
@node Submodel Options
@section Hardware Models and Configurations
@ -18479,7 +18479,7 @@ precompiled header. The following are known to be safe:
@gccoptlist{-fmessage-length= -fpreprocessed -fsched-interblock @gol
-fsched-spec -fsched-spec-load -fsched-spec-load-dangerous @gol
-fsched-verbose=<number> -fschedule-insns -fvisibility= @gol
-fsched-verbose=@var{number} -fschedule-insns -fvisibility= @gol
-pedantic-errors}
@end itemize

View File

@ -16,16 +16,16 @@ process.
Plugins are loaded with
@option{-fplugin=/path/to/NAME.so} @option{-fplugin-arg-NAME-<key1>[=<value1>]}
@option{-fplugin=/path/to/@var{name}.so} @option{-fplugin-arg-@var{name}-@var{key1}[=@var{value1}]}
The plugin arguments are parsed by GCC and passed to respective
plugins as key-value pairs. Multiple plugins can be invoked by
specifying multiple @option{-fplugin} arguments.
A plugin can be simply given by its short name (no dots or
slashes). When simply passing @option{-fplugin=NAME}, the plugin is
loaded from the @file{plugin} directory, so @option{-fplugin=NAME} is
the same as @option{-fplugin=`gcc -print-file-name=plugin`/NAME.so},
slashes). When simply passing @option{-fplugin=@var{name}}, the plugin is
loaded from the @file{plugin} directory, so @option{-fplugin=@var{name}} is
the same as @option{-fplugin=`gcc -print-file-name=plugin`/@var{name}.so},
using backquote shell syntax to query the @file{plugin} directory.
@section Plugin API
@ -45,8 +45,8 @@ If this symbol does not exist, the compiler will emit a fatal error
and exit with the error message:
@smallexample
fatal error: plugin <name> is not licensed under a GPL-compatible license
<name>: undefined symbol: plugin_is_GPL_compatible
fatal error: plugin @var{name} is not licensed under a GPL-compatible license
@var{name}: undefined symbol: plugin_is_GPL_compatible
compilation terminated
@end smallexample