1
1

tweaks: unabbreviate "argument" in the documentation

Also, show that the argument in the extendsyntax format is not optional,
as any command requires at least one argument.  Also mention 'tabgives'
among the commands that are allowed in an included file.
Этот коммит содержится в:
Benno Schulenberg 2020-02-04 12:23:58 +01:00
родитель da68ee19e7
Коммит d141e849a3
3 изменённых файлов: 15 добавлений и 13 удалений

Просмотреть файл

@ -282,7 +282,7 @@ at the width of the screen minus \fInumber\fR columns, allowing the wrap
point to vary along with the width of the screen if the screen is resized. point to vary along with the width of the screen if the screen is resized.
The default value is \-8. The default value is \-8.
.TP .TP
.B "\-s ""\fIprogram\fR [\fIarg\fR...]\fB""\fR, \fB\-\-speller=""\fIprogram\fR [\fIarg\fR...]\fB""" .B "\-s ""\fIprogram\fR [\fIargument \fR...]\fB""\fR, \fB\-\-speller=""\fIprogram\fR [\fIargument \fR...]\fB"""
Use this command to perform spell checking and correcting, instead of Use this command to perform spell checking and correcting, instead of
using the built-in corrector that calls \fBhunspell\fR or GNU \fBspell\fR. using the built-in corrector that calls \fBhunspell\fR or GNU \fBspell\fR.
.TP .TP

Просмотреть файл

@ -403,8 +403,8 @@ point to vary along with the width of the screen if the screen is resized.
The default value is @t{-8}. The default value is @t{-8}.
@anchor{@option{--speller}} @anchor{@option{--speller}}
@item -s "@var{program} [@var{arg} @dots{}]" @item -s "@var{program} [@var{argument} @dots{}]"
@itemx --speller="@var{program} [@var{arg} @dots{}]" @itemx --speller="@var{program} [@var{argument} @dots{}]"
Use the given program to do spell checking and correcting. By default, Use the given program to do spell checking and correcting. By default,
@command{nano} uses the command specified in the @env{SPELL} environment @command{nano} uses the command specified in the @env{SPELL} environment
variable. If @env{SPELL} is not set, and @option{--speller} is variable. If @env{SPELL} is not set, and @option{--speller} is
@ -935,7 +935,7 @@ When needed, use @code{unset jumpyscrolling} instead.
@item set softwrap @item set softwrap
Enable soft line wrapping for easier viewing of very long lines. Enable soft line wrapping for easier viewing of very long lines.
@item set speller "@var{program} [@var{arg} @dots{}]" @item set speller "@var{program} [@var{argument} @dots{}]"
Use the given program to do spell checking and correcting. Use the given program to do spell checking and correcting.
@xref{@option{--speller}} for details. @xref{@option{--speller}} for details.
@ -1058,13 +1058,13 @@ file, to determine whether this syntax should be used for it.
(This functionality only works when @code{libmagic} is installed (This functionality only works when @code{libmagic} is installed
on the system and will be silently ignored otherwise.) on the system and will be silently ignored otherwise.)
@item formatter @var{program} [@var{arg} @dots{}] @item formatter @var{program} [@var{argument} @dots{}]
Run the given @var{program} on the full contents of the current buffer. Run the given @var{program} on the full contents of the current buffer.
(The current buffer is written out to a temporary file, the program is (The current buffer is written out to a temporary file, the program is
run on it, and then the temporary file is read back in, replacing the run on it, and then the temporary file is read back in, replacing the
contents of the buffer.) contents of the buffer.)
@item linter @var{program} [@var{arg} @dots{}] @item linter @var{program} [@var{argument} @dots{}]
Use the given @var{program} to do a syntax check on the current buffer. Use the given @var{program} to do a syntax check on the current buffer.
@item comment "@var{string}" @item comment "@var{string}"
@ -1117,10 +1117,11 @@ Read in self-contained color syntaxes from "syntaxfile". Note that
"syntaxfile" may contain only the above commands, from @code{syntax} "syntaxfile" may contain only the above commands, from @code{syntax}
to @code{icolor}. to @code{icolor}.
@item extendsyntax @var{name} @var{command} [@var{arg} @dots{}] @item extendsyntax @var{name} @var{command} @var{argument} @dots{}
Extend the syntax previously defined as "@var{name}" with another @var{command}. Extend the syntax previously defined as "@var{name}" with another @var{command}.
This allows you to add a new @code{color}, @code{icolor}, @code{header}, This allows you to add a new @code{color}, @code{icolor}, @code{header},
@code{magic}, @code{comment}, @code{linter}, or @code{formatter} command to an already @code{magic}, @code{formatter}, @code{linter}, @code{comment},
or @code{tabgives} command to an already
defined syntax --- useful when you want to slightly improve a syntax defined defined syntax --- useful when you want to slightly improve a syntax defined
in one of the system-installed files (which normally are not writable). in one of the system-installed files (which normally are not writable).

Просмотреть файл

@ -264,7 +264,7 @@ When needed, use \fBunset jumpyscrolling\fR instead.
.B set softwrap .B set softwrap
Enable soft line wrapping for easier viewing of very long lines. Enable soft line wrapping for easier viewing of very long lines.
.TP .TP
.B set speller """\fIprogram\fR [\fIarg\fR...]\fB""" .B set speller """\fIprogram\fR [\fIargument \fR...]\fB"""
Use the given \fIprogram\fR to do spell checking and correcting, instead of Use the given \fIprogram\fR to do spell checking and correcting, instead of
using the built-in corrector that calls \fBhunspell\fR or GNU \fBspell\fR. using the built-in corrector that calls \fBhunspell\fR or GNU \fBspell\fR.
.TP .TP
@ -385,13 +385,13 @@ file, to determine whether this syntax should be used for it.
(This functionality only works when \fBlibmagic\fP is installed on the (This functionality only works when \fBlibmagic\fP is installed on the
system and will be silently ignored otherwise.) system and will be silently ignored otherwise.)
.TP .TP
.BI formatter " program " \fR[ "arg " \fR...] .BI formatter " program " \fR[ "argument " \fR...]
Run the given \fIprogram\fR on the full contents of the current buffer. Run the given \fIprogram\fR on the full contents of the current buffer.
(The current buffer is written out to a temporary file, the program is (The current buffer is written out to a temporary file, the program is
run on it, and then the temporary file is read back in, replacing the run on it, and then the temporary file is read back in, replacing the
contents of the buffer.) contents of the buffer.)
.TP .TP
.BI linter " program " \fR[ "arg " \fR...] .BI linter " program " \fR[ "argument " \fR...]
Use the given \fIprogram\fR to run a syntax check on the current buffer. Use the given \fIprogram\fR to run a syntax check on the current buffer.
.TP .TP
.BI "comment """ string """ .BI "comment """ string """
@ -444,10 +444,11 @@ Read in self-contained color syntaxes from \fIsyntaxfile\fP. Note that
\fIsyntaxfile\fP may contain only the above commands, from \fBsyntax\fP \fIsyntaxfile\fP may contain only the above commands, from \fBsyntax\fP
to \fBicolor\fP. to \fBicolor\fP.
.TP .TP
.BI extendsyntax " name command " \fR[ "arg " \fR...] .BI extendsyntax " name command argument " \fR...
Extend the syntax previously defined as \fIname\fR with another Extend the syntax previously defined as \fIname\fR with another
\fIcommand\fR. This allows adding a new \fBcolor\fP, \fBicolor\fP, \fIcommand\fR. This allows adding a new \fBcolor\fP, \fBicolor\fP,
\fBheader\fP, \fBmagic\fP, \fBcomment\fP, \fBlinter\fP, or \fBformatter\fR \fBheader\fR, \fBmagic\fR, \fBformatter\fR, \fBlinter\fR, \fBcomment\fR,
or \fBtabgives\fR
command to an already defined syntax -- useful when you want to command to an already defined syntax -- useful when you want to
slightly improve a syntax defined in one of the system-installed slightly improve a syntax defined in one of the system-installed
files (which normally are not writable). files (which normally are not writable).