help-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Conconformity between Menu and sectioning


From: Christopher Dimech
Subject: Conconformity between Menu and sectioning
Date: Mon, 19 Oct 2020 15:01:42 +0200

I am writing an texinfo manual file, and makeinfo to giving the
following two warnings even if what is in the menu and the sectioning
is correct.

./01-gela-intro.texi:831: warning: node `Cmd-ArgDescr' is next for 
`Intactv-Function' in menu but not in sectioning
./01-gela-intro.texi:856: warning: node `Intactv-Function' is prev for 
`Cmd-ArgDescr' in menu but not in sectioning

In the file I have

> @c ======================================================================
> @ignore
> * [Intactv-Function] Interactive Functions
>  ___     _           _         ___
> |_ _|_ _| |_ __ _ __| |___ __ | __| _  __
>  | || ' \  _/ _` / _|  _\ V / | _| ' \/ _|
> |___|_||_\__\__,_\__|\__|\_/  |_||_||_\__|
>
> @end ignore
>
> @node Intactv-Function
> @section Interactive Function
>
> Interactive functions can be called from Emacs by the user via "M-x" or
> via a keybinding.  An Elisp function becomes an interactive command when
> its body contains the interactive declaration.
>
>   (interactive &optional Arg-Descriptor)
>
> The interactive declaration allows users to pass arguments to a User
> Defined Function.  Passing parameters to functions can be done via (1)
> the Universal Prefix Argument, or (2) from a Mini-Buffer Prompt that
> displays a message to help the user input the command argument.
>
> When the Arg-Descriptor is not used, no arguments are used when calling
> the command.  Thusly, no arguments are passed to the interactive
> command.
>
> @c ----------------------------------------------------------------------
> @ignore
> ** [Cmd-ArgDescr] Interactive options for Arg-Descriptor
> @end ignore
>
> @node Cmd-ArgDescr
> @subsection Interactive options for Arg-Descriptor
>
> @noindent There are three possibilities for the Interactive Argument
> Descriptor:
>
> @c No item marks displayed with @w{}
> @itemize @w{}
>    @item -String-
>    @* @ @ @ Code Letters used to interpret parameter.
>
>    @item -Emacs Lisp Expression-
>    @* @ @ @ Evaluates to a list of the actual arguments.
>
>    @item -Argument Omitted, or set to 'nil'-
>    @* @ @ @ Function will not take parameter arguments.
> @end itemize
>
>
>  @c ----------------------------------------------------------------------
>  @ignore
>  ** [Numrv-CodeLtr] Interactive String Arg-Descriptor for Numeric Values
> @end ignore
>
> @node Numrv-CodeLtr
> @subsection Interactive String Arg-Descriptor for Numeric Values
>
> When the Interactive Arg-Descriptor is a String, Code Letters are used
> to define the argument and how the argument is passed.  For numeric
> values, the Code Letters 'N', 'p', and 'n' are frequently used.  When
> using the Code Letter 'N', the numeric value can be passed in two ways.
> When using the Mini-Buffer Prompt, a message is appended after the Code
> Letter.  The message appears in the Mini-Buffer to help the user input
> the argument for the command he wants executed.
>
> @multitable @columnfractions 0.01 0.05 0.95
>   @item @tab "N" @tab
>      Uses Mini-Buffer Prompt or Universal Prefix.
>
>   @item @tab "p" @tab
>      Utilises Universal Prefix converted to number.  Does not use Prompt.
>      @* @* @ @ @ C-u Arg M-x Command-Name
>
>   @item @tab "n" @tab
>      Uses Mini-Buffer Prompt.  Not designed to use Prefix.
>      @* @* @ @ @ M-x Command-Name <Ret> Arg
> @end multitable








reply via email to

[Prev in Thread] Current Thread [Next in Thread]