commit ca398fdfdff82c6e07679771194cbde26cb2c23e
parent d0bceb14493ea099d37610a689ca8bdc8992e659
Author: Benno Schulenberg <bensberg@telfort.nl>
Date: Sun, 20 Dec 2020 16:51:43 +0100
docs: explain the purpose of --markmatch / -^ / 'set markmatch'
Also, colorize 'set markmatch' as a valid option in a nanorc file.
Diffstat:
5 files changed, 29 insertions(+), 1 deletion(-)
diff --git a/doc/nano.1 b/doc/nano.1
@@ -337,6 +337,12 @@ and \fBS\fR when soft-wrapping.
When the buffer is modified, a star (\fB*\fR) is shown after the
filename in the center of the title bar.
.TP
+.BR \-^ ", " \-\-markmatch
+After a search, set the mark at the end of the found match
+(if there is any) so that it gets highlighted. This makes
+the match more visible, but also allows deleting the match
+with a single keystroke.
+.TP
.BR \-_ ", " \-\-minibar
Suppress the title bar and instead show information about
the current buffer at the bottom of the screen, in the space
diff --git a/doc/nano.texi b/doc/nano.texi
@@ -477,6 +477,13 @@ and @code{S} when soft-wrapping.
When the buffer is modified, a star (@code{*}) is shown after the
filename in the center of the title bar.
+@item -^
+@itemx --markmatch
+After a search, set the mark at the end of the found match
+(if there is any) so that it gets highlighted. This makes
+the match more visible, but also allows deleting the match
+with a single keystroke.
+
@item -_
@itemx --minibar
Suppress the title bar and instead show information about
@@ -919,6 +926,12 @@ try using libmagic to determine the applicable syntax.
(Calling libmagic can be relatively time consuming.
It is therefore not done by default.)
+@item set markmatch
+After a search, set the mark at the end of the found match
+(if there is any) so that it gets highlighted. This makes
+the match more visible, but also allows deleting the match
+with a single keystroke.
+
@anchor{@code{set matchbrackets}}
@item set matchbrackets "@var{characters}"
Specify the opening and closing brackets that can be found by bracket
diff --git a/doc/nanorc.5 b/doc/nanorc.5
@@ -176,6 +176,12 @@ try using libmagic to determine the applicable syntax.
(Calling libmagic can be relatively time consuming.
It is therefore not done by default.)
.TP
+.B set markmatch
+After a search, set the mark at the end of the found match
+(if there is any) so that it gets highlighted. This makes
+the match more visible, but also allows deleting the match
+with a single keystroke.
+.TP
.BI "set matchbrackets """ characters """
Specify the opening and closing brackets that can be found by bracket
searches. This may not include blank characters. The opening set must
diff --git a/doc/sample.nanorc.in b/doc/sample.nanorc.in
@@ -79,6 +79,9 @@
## Fall back to slow libmagic to try and determine an applicable syntax.
# set magic
+# After a search, set the mark at the end of the found match (if any).
+# set markmatch
+
## The opening and closing brackets that can be found by bracket
## searches. They cannot contain blank characters. The former set must
## come before the latter set, and both must be in the same order.
diff --git a/syntax/nanorc.nanorc b/syntax/nanorc.nanorc
@@ -7,7 +7,7 @@ comment "#"
color brightred ".*"
# Keywords
-color brightgreen "^[[:space:]]*(set|unset)[[:space:]]+(afterends|allow_insecure_backup|atblanks|autoindent|backup|boldtext|breaklonglines|casesensitive|constantshow|cutfromcursor|emptyline|historylog|indicator|jumpyscrolling|linenumbers|locking|magic|minibar|mouse|multibuffer|noconvert|nohelp|nonewlines|positionlog|preserve|quickblank|rawsequences|rebinddelete|regexp|saveonexit|showcursor|smarthome|softwrap|stateflags|suspendable|tabstospaces|trimblanks|unix|wordbounds|zap)\>"
+color brightgreen "^[[:space:]]*(set|unset)[[:space:]]+(afterends|allow_insecure_backup|atblanks|autoindent|backup|boldtext|breaklonglines|casesensitive|constantshow|cutfromcursor|emptyline|historylog|indicator|jumpyscrolling|linenumbers|locking|magic|markmatch|minibar|mouse|multibuffer|noconvert|nohelp|nonewlines|positionlog|preserve|quickblank|rawsequences|rebinddelete|regexp|saveonexit|showcursor|smarthome|softwrap|stateflags|suspendable|tabstospaces|trimblanks|unix|wordbounds|zap)\>"
color yellow "^[[:space:]]*set[[:space:]]+((error|function|key|number|prompt|scroller|selected|status|stripe|title)color)[[:space:]]+(bold,)?(italic,)?(bright|light)?(white|black|red|blue|green|yellow|magenta|cyan|normal|pink|purple|mauve|lagoon|mint|lime|peach|orange|latte)?(,(light)?(white|black|red|blue|green|yellow|magenta|cyan|normal|pink|purple|mauve|lagoon|mint|lime|peach|orange|latte))?\>"
color brightgreen "^[[:space:]]*set[[:space:]]+(backupdir|brackets|errorcolor|functioncolor|keycolor|matchbrackets|numbercolor|operatingdir|promptcolor|punct|quotestr|scrollercolor|selectedcolor|speller|statuscolor|stripecolor|titlecolor|whitespace|wordchars)[[:space:]]+"
color brightgreen "^[[:space:]]*set[[:space:]]+(fill[[:space:]]+-?[[:digit:]]+|(guidestripe|tabsize)[[:space:]]+[1-9][0-9]*)\>"
