Le 09/05/2016 19:56, Patrick Gundlach a écrit :
> Hello Vincent,
>
> I think I was unclear in my (hasty) mail.
>
> Take for example the command "\newcommand" (12. definitions)
>
> @item cmd
> Required; @code{\@var{cmd}} is the command name. For @code{\newcommand}, it
> must not be already defined and must not begin with @code{\end}. For
> @code{\renewcommand}, it must already be defined.
>
> @item nargs
> Optional; an integer from 0 to 9, specifying the number of arguments
> that the command will take. If this argument is not present, the
> default is for the command to have no arguments. When redefining a
> command, the new version can have a different number of arguments than
> the old version.
>
>
> I am unable to take from the texi file that "nargs" is optional. It is
> written there, but it is not extractable. This is the kind of
> information I'd like to include in ltxref.org
OK. We could modify the texi file so that it is written like this:
@item @RequiredArg{cmd}
@code{\@var{cmd}} is the command name. For @code{\newcommand}, it
must not be already defined and must not begin with @code{\end}. For
@code{\renewcommand}, it must already be defined.
@item @OptionalArg{nargs}
an integer from 0 to 9, specifying the number of arguments
that the command will take. If this argument is not present, the
default is for the command to have no arguments. When redefining a
command, the new version can have a different number of arguments than
the old version.
Both RequiredArg and OptionalArg would be macros, defined as follows:
@macro RequiredArg \x\
\x\
@argindex \x\, required
Required;
@end macro
@macro RequiredArg \x\
\x\
@argindex \x\, optional
Optional;
@end macro
with also in the preamble
@defindex arg
Plus some node 'Argument Index' compiled under flag condition with
@printindex arg
So you would have the information extractable from the 'Argument index'
node page with all links to the arguments.
For the normal production of the manual the argument index flag would
not be set, so there would be no change.
Vincent
>
> Patrick
>
