From 6cd8314e76468edbbe0629d4f8f0596214d2e812 Mon Sep 17 00:00:00 2001 From: Benno Schulenberg Date: Mon, 3 Mar 2014 18:49:52 +0000 Subject: [PATCH] Synchronizing the texinfo and nanorc docs, and improving alphabetization. git-svn-id: svn://svn.savannah.gnu.org/nano/trunk/nano@4635 35c25a1d-7b9e-4130-9fde-d3aeb78583b8 --- ChangeLog | 2 ++ doc/man/nanorc.5 | 25 +++++++++++++------------ doc/texinfo/nano.texi | 40 ++++++++++++++++++++++++++++++++++++---- 3 files changed, 51 insertions(+), 16 deletions(-) diff --git a/ChangeLog b/ChangeLog index e81c4e76..a8666f9a 100644 --- a/ChangeLog +++ b/ChangeLog @@ -8,6 +8,8 @@ the scrolling behaviour when softwrap is off -- the construct (amount ? amount : 1) wasn't doing what I intended. * doc/man/nano{.1,rc.5} - Slightly improve formatting and wording. + * doc/{texinfo/nano.texi,man/nanorc.5} - Add some missing options + to the texinfo documentation, and improve alphabetization a bit. 2014-03-01 Chris Allegretta * global.c (shortcut_init) - fix an issue with the split diff --git a/doc/man/nanorc.5 b/doc/man/nanorc.5 index a4beebd8..dcd57da6 100644 --- a/doc/man/nanorc.5 +++ b/doc/man/nanorc.5 @@ -144,6 +144,9 @@ subdirectories. Also, the current directory is changed to here, so files are inserted from this directory. By default, the operating directory feature is turned off. .TP +.B set/unset poslog +Save the cursor position of files between editing sessions. +.TP .B set/unset preserve Preserve the XON and XOFF keys (^Q and ^S). .TP @@ -153,15 +156,15 @@ paragraphs. They cannot contain blank characters. Only closing punctuation, optionally followed by closing brackets, can end sentences. The default value is "\fI!.?\fP". .TP -.B set/unset quiet -\fBnano\fP will not report errors in the \fInanorc\fP file and ask them -to be acknowledged by pressing enter at startup. If this is used it -should be placed at the top of the file to be fully effective. -.TP .B set/unset quickblank Do quick statusbar blanking. Statusbar messages will disappear after 1 keystroke instead of 25. .TP +.B set/unset quiet +\fBnano\fP will not report errors in the \fInanorc\fP file nor ask them +to be acknowledged by pressing enter at startup. If this is used it +should be placed at the top of the file to be fully effective. +.TP .B set quotestr "\fIstring\fP" The email-quote string, used to justify email-quoted paragraphs. This is an extended regular expression if your system supports them, @@ -183,9 +186,6 @@ won't work properly with this option enabled. .B set/unset regexp Do extended regular expression searches by default. .TP -.B set/unset poslog -Save the cursor position of files between editing sessions. -.TP .B set/unset smarthome Make the Home key smarter. When Home is pressed anywhere but at the very beginning of non-whitespace characters on a line, the cursor will @@ -206,6 +206,10 @@ calls \fIspell\fP. .B set/unset suspend Allow \fBnano\fP to be suspended. .TP +.B set/unset suspendenable +If \fBnano\fP is allowed to be suspended, allow the suspend key +(usually ^Z) to actually suspend it. +.TP .B set tabsize \fIn\fP Use a tab size of \fIn\fP columns. The value of \fIn\fP must be greater than 0. The default value is 8. @@ -222,9 +226,6 @@ Enable experimental generic-purpose undo code. .B set/unset view Disallow file modification. .TP -.B set/unset softwrap -Enable soft line wrapping for easier viewing of very long lones. -.TP .B set whitespace "\fIstring\fP" Set the two characters used to display the first characters of tabs and spaces. They must be single-column characters. @@ -245,7 +246,7 @@ the same as not having a syntax at all. The \fIdefault\fP syntax is special: it takes no \fIfileregex\fP, and applies to files that don't match any other syntax's \fIfileregex\fP. .TP -.B linter \fIprogram\fP [\fIargs\fP ... ] +.B linter \fIprogram\fP [\fIarg\fP ... ] For the currently defined syntax, use the given \fIprogram\fR to invoke the linter (this overrides the speller function when defined). diff --git a/doc/texinfo/nano.texi b/doc/texinfo/nano.texi index 841e3abb..2288a1b7 100644 --- a/doc/texinfo/nano.texi +++ b/doc/texinfo/nano.texi @@ -501,6 +501,11 @@ The supported commands and arguments are: @table @code +@item set/unset allow_insecure_backup +When backing up files, allow the backup to succeed even if its +permissions can't be (re)set due to special OS considerations. +You should NOT enable this option unless you are sure you need it. + @item set/unset autoindent Use auto-indentation. @@ -544,6 +549,9 @@ length will be the screen width less "n" columns. The default value is @item set/unset historylog Enable ~/.nano_history for saving and reading search/replace strings. +@ item set/unset locking +Enable vim-style lock-files for when editing files. + @item set matchbrackets "string" Set the opening and closing brackets that can be found by bracket searches. They cannot contain blank characters. The former set must @@ -585,6 +593,9 @@ subdirectories. Also, the current directory is changed to here, so files are inserted from this directory. By default, the operating directory feature is turned off. +@item set/unset poslog +Save the cursor position of files between editing sessions. + @item set/unset preserve Preserve the XON and XOFF keys (^Q and ^S). @@ -598,6 +609,11 @@ The default value is @code{"!.?"}. Do quick statusbar blanking. Statusbar messages will disappear after 1 keystroke instead of 25. +@item set/unset quiet +When set, @code{nano} will not report errors in the nanorc file nor ask them +to be acknowledged by pressing Enter at startup. If this option is used, it +should be placed at the top of the file to be fully effective. + @item set quotestr "string" The email-quote string, used to justify email-quoted paragraphs. This is an extended regular expression if your system supports them, @@ -634,7 +650,7 @@ line. Use smooth scrolling by default. @item set/unset softwrap -Use soft wrapping by default. +Enable soft line wrapping for easier viewing of very long lines. @item set speller "spellprog" Use spelling checker "spellprog" instead of the built-in one, which @@ -683,6 +699,16 @@ same as not having a syntax at all. The "default" syntax is special: it takes no "fileregex", and applies to files that don't match any other syntax's "fileregex". +@item linter program [arg @dots{} ] +For the currently defined syntax, use the given program to invoke the +linter (this overrides the speller function when defined). + +@item magic ["regex" @dots{} ] +For the currently defined syntax, add one or more regexes which will be +compared against the magic database when attempting to determine which +highlighting rules to use for a given file. This functionality only works +when libmagic is installed on the system and will be silently ignored otherwise. + @item color fgcolor,bgcolor "regex" @dots{} For the currently defined syntax, display all expressions matching the extended regular expression "regex" with foreground color "fgcolor" and @@ -711,6 +737,12 @@ Same as above, except that the expression matching is case insensitive. Read in self-contained color syntaxes from "syntaxfile". Note that "syntaxfile" can only contain "syntax", "color", and "icolor" commands. +@item extendsyntax str directive [arg @dots{} ] +Extend the syntax previously defined as str to include new information. +Allows you to add a new color, icolor, magic, header, or linter directive +to an already defined syntax. Useful when you want to add to definitions +from the system-installed syntax definitions (which are normally not writable). + @end table @@ -827,8 +859,8 @@ line option, which allows specifying an alternate spell checker. Disable the tab completion code when reading or writing files. @item --disable-wrapping -Disable all long line wrapping. This also eliminates the -w command -line option, which enables long line wrapping. +Disable all long-line wrapping. This also eliminates the -w command +line option, which enables long-line wrapping. @item --enable-tiny This option disables all the above. It also disables some of the larger @@ -866,7 +898,7 @@ Disables Native Language support. This will disable use of the available GNU @code{nano} translations. @item --disable-wrapping-as-root -Disable long line wrapping by default when nano is run as root. +Disable long-line wrapping by default when @code{nano} is run as root. @item --enable-utf8 Enable support for reading and writing Unicode files. This will require