Re: cppinternals.texi: Document MI optimization

["Joseph S. Myers" <jsm28 at cam dot ac dot uk>]

On Fri, 5 Oct 2001, Neil Booth wrote:

> -@code{parsing_args} is non-zero when the preprocessor is collecting the
> +@var{parsing_args} is non-zero when the preprocessor is collecting the

@var is for metasyntactic variables, not for programming language
variables.  See the Texinfo manual.

> -@code{parsing_args} is set to 2.  It doesn't set it if it meets a new
> -line when @code{parsing_args} is 1, since then code like
> +@var{parsing_args} is set to 2.  It doesn't set it if it meets a new
> +line when @var{parsing_args} is 1, since then code like

> -line if the variable @code{keep_tokens} is zero.  Line-buffering is
> +line if the variable @var{keep_tokens} is zero.  Line-buffering is

Likewise.

> +appears in a subsequent @code{#include} directive and @var{FOO} is

Likewise, unless you also use @var{FOO} in the example (which might be the
preferred fix here).

> +@code{_stack_include_file} sets the controlling macro @var{mi_cmacro} to
> +@code{NULL}, and sets @var{mi_valid} to @code{true}.  This indicates

@code, @code.

> +@code{_cpp_lex_token} sets @var{mi_valid} to @code{false}.  This

@code.

> +@var{mi_valid} to true and stores the controlling macro in
> +@var{mi_cmacro}.

@code, @code.

> +@code{_cpp_handle_directive} clears @var{mi_valid} when processing any

@code.

> +Note that whilst we are inside the conditional block, @var{mi_valid} is

@code.

> +was not followed by any tokens, @var{mi_valid} is @code{true} and

@code.

> +@display
> +#if !defined FOO
> +@end display

Why (here and elsewhere) are you using @display rather than @example for
code examples?

> +@var{mi_ind_cmacro}, and otherwise set it to @code{NULL}.

@code.

> +@code{enter_macro_context} sets @var{mi_valid} to false, so if a macro

@code.

-- 
Joseph S. Myers
jsm28@cam.ac.uk