[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH v2] Consistent variable name make less confusion
From: |
Cao jin |
Subject: |
Re: [PATCH v2] Consistent variable name make less confusion |
Date: |
Mon, 24 Jul 2017 14:03:54 +0800 |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.1.0 |
Could I know why it got ignored?
--
Sincerely,
Cao jin
On 06/27/2017 03:49 PM, Cao jin wrote:
> When @node "call Function" is outputted in Info format, there are inconsistent
> inconsistent variable names between example and description. @var is used to
> indicate metasyntactic variables, and will change the case of the argument to
> all uppercase in Info file. @code is more suitable in this case.
>
> Signed-off-by: Cao jin <address@hidden>
> ---
> doc/make.texi | 8 ++++----
> 1 file changed, 4 insertions(+), 4 deletions(-)
>
> diff --git a/doc/make.texi b/doc/make.texi
> index 343927b..57c8806 100644
> --- a/doc/make.texi
> +++ b/doc/make.texi
> @@ -7655,7 +7655,7 @@ foo = $(call reverse,a,b)
> @end smallexample
>
> @noindent
> -Here @var{foo} will contain @samp{b a}.
> +Here @code{foo} will contain @samp{b a}.
>
> This one is slightly more interesting: it defines a macro to search for
> the first instance of a program in @code{PATH}:
> @@ -7667,7 +7667,7 @@ LS := $(call pathsearch,ls)
> @end smallexample
>
> @noindent
> -Now the variable LS contains @code{/bin/ls} or similar.
> +Now the variable @code{LS} contains @code{/bin/ls} or similar.
>
> The @code{call} function can be nested. Each recursive invocation gets
> its own local values for @code{$(1)}, etc.@: that mask the values of
> @@ -7678,14 +7678,14 @@ higher-level @code{call}. For example, here is an
> implementation of a
> map = $(foreach a,$(2),$(call $(1),$(a)))
> @end smallexample
>
> -Now you can @var{map} a function that normally takes only one argument,
> +Now you can @code{map} a function that normally takes only one argument,
> such as @code{origin}, to multiple values in one step:
>
> @smallexample
> o = $(call map,origin,o map MAKE)
> @end smallexample
>
> -and end up with @var{o} containing something like @samp{file file default}.
> +and end up with @code{o} containing something like @samp{file file default}.
>
> A final caution: be careful when adding whitespace to the arguments to
> @code{call}. As with other functions, any whitespace contained in the
>
- Re: [PATCH v2] Consistent variable name make less confusion,
Cao jin <=