865 lines
29 KiB
Groff
865 lines
29 KiB
Groff
.\" Copyright (C) 2003-2011, 2013-2017 Free Software Foundation, Inc.
|
|
.\"
|
|
.\" This document is dual-licensed. You may distribute and/or modify it
|
|
.\" under the terms of either of the following licenses:
|
|
.\"
|
|
.\" * The GNU General Public License, as published by the Free Software
|
|
.\" Foundation, version 3 or (at your option) any later version. You
|
|
.\" should have received a copy of the GNU General Public License
|
|
.\" along with this program. If not, see
|
|
.\" <http://www.gnu.org/licenses/>.
|
|
.\"
|
|
.\" * The GNU Free Documentation License, as published by the Free
|
|
.\" Software Foundation, version 1.2 or (at your option) any later
|
|
.\" version, with no Invariant Sections, no Front-Cover Texts, and no
|
|
.\" Back-Cover Texts. You should have received a copy of the GNU Free
|
|
.\" Documentation License along with this program. If not, see
|
|
.\" <http://www.gnu.org/licenses/>.
|
|
.\"
|
|
.TH NANORC 5 "version 3.1" "September 2018"
|
|
|
|
.SH NAME
|
|
nanorc \- GNU nano's configuration file
|
|
|
|
.SH DESCRIPTION
|
|
The \fInanorc\fP file contains the default settings for \fBnano\fP, a
|
|
small and friendly editor. The file should be in Unix format, not in
|
|
DOS or Mac format. During startup, \fBnano\fP will first read the
|
|
system-wide settings, from \fB/etc/nanorc\fP (the exact path might be
|
|
different on your system), and then the user-specific settings, either
|
|
from \fB~/.nanorc\fR or from \fI$XDG_CONFIG_HOME\fB/nano/nanorc\fR
|
|
or from \fB~/.config/nano/nanorc\fR, whichever is encountered first.
|
|
|
|
.SH OPTIONS
|
|
The configuration file accepts a series of \fBset\fP and \fBunset\fP
|
|
commands, which can be used to configure nano on startup without using
|
|
command-line options. Additionally, there are some commands to define
|
|
syntax highlighting and to rebind keys -- see the two separate sections
|
|
on those. \fBnano\fP reads one command per line.
|
|
.PP
|
|
Options in \fInanorc\fP files take precedence over nano's defaults, and
|
|
command-line options override \fInanorc\fP settings. Also, options that
|
|
do not take an argument are unset by default. So using the \fBunset\fR
|
|
command is only needed when wanting to override a setting of the system's
|
|
\fInanorc\fR file in your own \fInanorc\fR. Options that take an
|
|
argument cannot be unset.
|
|
.PP
|
|
Below, the \fIstring\fR parameters need to be enclosed in double quotes.
|
|
Quotes inside these string parameters don't have to be escaped with
|
|
backslashes. The last double quote in the string will be treated as its
|
|
end. For example, for the \fBbrackets\fP option, "\fB"')>]}\fP" will
|
|
match \fB"\fP, \fB'\fP, \fB)\fP, \fB>\fP, \fB]\fP, and \fB}\fP.
|
|
.PP
|
|
The supported commands and arguments are:
|
|
|
|
.TP 3
|
|
.B set afterends
|
|
Make Ctrl+Right stop at word ends instead of beginnings.
|
|
.TP
|
|
.B set 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.
|
|
.TP
|
|
.B set atblanks
|
|
When soft line wrapping is enabled, make it wrap lines at blank characters
|
|
(tabs and spaces) instead of always at the edge of the screen.
|
|
.TP
|
|
.B set autoindent
|
|
Automatically indent a newly created line to the same number of tabs
|
|
and/or spaces as the previous line (or as the next line if the previous
|
|
line is the beginning of a paragraph).
|
|
.TP
|
|
.B set backup
|
|
When saving a file, create a backup file by adding a tilde (\fB~\fP) to
|
|
the file's name.
|
|
.TP
|
|
.B set backupdir "\fIdirectory\fP"
|
|
Make and keep not just one backup file, but make and keep a uniquely
|
|
numbered one every time a file is saved -- when backups are enabled
|
|
with \fBset backup\fR or \fB\-\-backup\fR or \fB\-B\fR.
|
|
The uniquely numbered files are stored in the specified \fIdirectory\fR.
|
|
.TP
|
|
.B set boldtext
|
|
Use bold instead of reverse video for the title bar, status bar, key combos,
|
|
function tags, line numbers, and selected text. This can be overridden by
|
|
setting the options \fBtitlecolor\fP, \fBstatuscolor\fP, \fBkeycolor\fP,
|
|
\fBfunctioncolor\fP, \fBnumbercolor\fP, and \fBselectedcolor\fP.
|
|
.TP
|
|
.B set brackets "\fIstring\fP"
|
|
Set the characters treated as closing brackets when justifying
|
|
paragraphs. This may not include blank characters. Only closing
|
|
punctuation (see \fBset punct\fP), optionally followed by the specified
|
|
closing brackets, can end sentences. The default value is "\fB"')>]}\fP".
|
|
.TP
|
|
.B set casesensitive
|
|
Do case-sensitive searches by default.
|
|
.TP
|
|
.B set constantshow
|
|
Constantly display the cursor position in the status bar.
|
|
This overrides the option \fBquickblank\fR.
|
|
.TP
|
|
.B set cutfromcursor
|
|
Use cut-from-cursor-to-end-of-line by default, instead of cutting the whole line.
|
|
(The old form of this option, '\fBset cut\fR', is deprecated.)
|
|
.TP
|
|
.B set errorcolor \fIfgcolor\fR,\fIbgcolor\fR
|
|
Use this color combination for the status bar when an error message is displayed.
|
|
See \fBset titlecolor\fR for valid color names.
|
|
.TP
|
|
.B set fill \fInumber\fR
|
|
Hard-wrap lines at column number \fInumber\fR. If \fInumber\fR is 0 or less,
|
|
the maximum line length will be the screen width less \fInumber\fP columns.
|
|
The default value is \fB\-8\fR. This option conflicts with
|
|
\fBnowrap\fR -- the last one given takes effect.
|
|
.TP
|
|
.B set functioncolor \fIfgcolor\fR,\fIbgcolor\fR
|
|
Specify the color combination to use for the function descriptions
|
|
in the two help lines at the bottom of the screen.
|
|
See \fBset titlecolor\fR for more details.
|
|
.TP
|
|
.B set historylog
|
|
Save the last hundred search strings and replacement strings and
|
|
executed commands, so they can be easily reused in later sessions.
|
|
.TP
|
|
.B set keycolor \fIfgcolor\fR,\fIbgcolor\fR
|
|
Specify the color combination to use for the shortcut key combos
|
|
in the two help lines at the bottom of the screen.
|
|
See \fBset titlecolor\fR for more details.
|
|
.TP
|
|
.B set linenumbers
|
|
Display line numbers to the left of the text area.
|
|
.TP
|
|
.B set locking
|
|
Enable vim-style lock-files for when editing files.
|
|
.TP
|
|
.B set matchbrackets "\fIstring\fP"
|
|
Set the opening and closing brackets that can be found by bracket
|
|
searches. This may not include blank characters. The opening set must
|
|
come before the closing set, and the two sets must be in the same order.
|
|
The default value is "\fB(<[{)>]}\fP".
|
|
.TP
|
|
.B set morespace
|
|
Use the blank line below the title bar as extra editing space.
|
|
.TP
|
|
.B set mouse
|
|
Enable mouse support, if available for your system. When enabled, mouse
|
|
clicks can be used to place the cursor, set the mark (with a double
|
|
click), and execute shortcuts. The mouse will work in the X Window
|
|
System, and on the console when gpm is running. Text can still be
|
|
selected through dragging by holding down the Shift key.
|
|
.TP
|
|
.B set multibuffer
|
|
When reading in a file with ^R, insert it into a new buffer by default.
|
|
.TP
|
|
.B set noconvert
|
|
Don't convert files from DOS/Mac format.
|
|
.TP
|
|
.B set nohelp
|
|
Don't display the two help lines at the bottom of the screen.
|
|
.TP
|
|
.B set nonewlines
|
|
When a file does not end with a newline, don't automatically add one.
|
|
.TP
|
|
.B set nopauses
|
|
Don't pause between warnings at startup. This means that only
|
|
the last one will be visible (when there are multiple ones).
|
|
.TP
|
|
.B set nowrap
|
|
Don't hard-wrap text at all. This option conflicts with
|
|
\fBfill\fR -- the last one given takes effect.
|
|
.TP
|
|
.B set numbercolor \fIfgcolor\fR,\fIbgcolor\fR
|
|
Specify the color combination to use for line numbers.
|
|
See \fBset titlecolor\fR for more details.
|
|
.TP
|
|
.B set operatingdir "\fIdirectory\fP"
|
|
\fBnano\fP will only read and write files inside \fIdirectory\fP and its
|
|
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 positionlog
|
|
Save the cursor position of files between editing sessions.
|
|
The cursor position is remembered for the 200 most-recently edited files.
|
|
.TP
|
|
.B set preserve
|
|
Preserve the XON and XOFF keys (^Q and ^S).
|
|
.TP
|
|
.B set punct "\fIstring\fP"
|
|
Set the characters treated as closing punctuation when justifying
|
|
paragraphs. This may not include blank characters. Only the
|
|
specfified closing punctuation, optionally followed by closing brackets
|
|
(see \fBbrackets\fP), can end sentences. The default value is "\fB!.?\fP".
|
|
.TP
|
|
.B set quickblank
|
|
Do quick status-bar blanking: status-bar messages will disappear after 1
|
|
keystroke instead of 25. The option \fBconstantshow\fR overrides this.
|
|
.TP
|
|
.B set quiet
|
|
Obsolete option. Recognized but ignored.
|
|
.TP
|
|
.B set quotestr "\fIregex\fP"
|
|
The email-quote string, used to justify email-quoted paragraphs. This
|
|
is an extended regular expression. The default value is
|
|
"\fB^([\ \\t]*([#:>|}]|//))+\fP". Note that \fB\\t\fR stands for an actual
|
|
Tab character.
|
|
.TP
|
|
.B set rebinddelete
|
|
Interpret the Delete key differently so that both Backspace and Delete
|
|
work properly. You should only need to use this option if Backspace
|
|
acts like Delete on your system.
|
|
.TP
|
|
.B set rebindkeypad
|
|
Interpret the numeric keypad keys so that they all work properly. You
|
|
should only need to use this option if they don't, as mouse support
|
|
won't work properly with this option enabled.
|
|
.TP
|
|
.B set regexp
|
|
Do extended regular expression searches by default.
|
|
.TP
|
|
.B set selectedcolor \fIfgcolor\fR,\fIbgcolor\fR
|
|
Specify the color combination to use for selected text.
|
|
See \fBset titlecolor\fR for more details.
|
|
.TP
|
|
.B set showcursor
|
|
Put the cursor on the highlighted item in the file browser, to aid
|
|
braille users.
|
|
.TP
|
|
.B set 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
|
|
jump to that beginning (either forwards or backwards). If the cursor is
|
|
already at that position, it will jump to the true beginning of the
|
|
line.
|
|
.TP
|
|
.B set smooth
|
|
Use smooth scrolling by default.
|
|
.TP
|
|
.B set softwrap
|
|
Enable soft line wrapping for easier viewing of very long lines.
|
|
.TP
|
|
.B set speller "\fIprogram\fP"
|
|
Use the given \fIprogram\fR to do spell checking and correcting,
|
|
instead of the built-in corrector that calls \fBspell\fR.
|
|
.TP
|
|
.B set statuscolor \fIfgcolor\fR,\fIbgcolor\fR
|
|
Specify the color combination to use for the status bar.
|
|
See \fBset titlecolor\fR for more details.
|
|
.TP
|
|
.B set suspend
|
|
Allow \fBnano\fP to be suspended.
|
|
.TP
|
|
.B set tabsize \fInumber\fR
|
|
Use a tab size of \fInumber\fR columns. The value of \fInumber\fP must be
|
|
greater than 0. The default value is \fB8\fR.
|
|
.TP
|
|
.B set tabstospaces
|
|
Convert typed tabs to spaces.
|
|
.TP
|
|
.B set tempfile
|
|
Save automatically on exit, don't prompt.
|
|
.TP
|
|
.B set titlecolor \fIfgcolor\fR,\fIbgcolor\fR
|
|
Specify the color combination to use for the title bar.
|
|
Valid names for the foreground and background colors are:
|
|
.BR white ", " black ", " blue ", " green ", " red ", "
|
|
.BR cyan ", " yellow ", " magenta ", and " normal
|
|
-- where \fBnormal\fR means the default foreground or background color.
|
|
The name of the foreground color may be prefixed with \fBbright\fR.
|
|
And either "\fIfgcolor\fR" or ",\fIbgcolor\fR" may be left out.
|
|
.TP
|
|
.B set trimblanks
|
|
Remove trailing whitespace from wrapped lines when automatic
|
|
hard-wrapping occurs or when text is justified.
|
|
(The old form of this option, '\fBset justifytrim\fR', is deprecated.)
|
|
.TP
|
|
.B set unix
|
|
Save a file by default in Unix format. This overrides nano's
|
|
default behavior of saving a file in the format that it had.
|
|
(This option has no effect when you also use \fBset noconvert\fR.)
|
|
.TP
|
|
.B set view
|
|
Disallow file modification: read-only mode.
|
|
This mode allows the user to open also other files for viewing,
|
|
unless \fB--restricted\fR is given on the command line.
|
|
.TP
|
|
.B set whitespace "\fIstring\fP"
|
|
Set the two characters used to indicate the presence of tabs and
|
|
spaces. They must be single-column characters. The default pair
|
|
for a UTF-8 locale is "\fB\[Fc]\[md]\fR", and for other locales "\fB>.\fR".
|
|
.TP
|
|
.B set wordbounds
|
|
Detect word boundaries differently by treating punctuation
|
|
characters as parts of words.
|
|
.TP
|
|
.B set wordchars \fIstring\fP
|
|
Specify which other characters (besides the normal alphanumeric ones)
|
|
should be considered as parts of words. This overrides the option
|
|
\fBwordbounds\fR.
|
|
.TP
|
|
.B set zap
|
|
Let an unmodified Backspace or Delete erase the marked region
|
|
(instead of a single character, and without affecting the cutbuffer).
|
|
|
|
.SH SYNTAX HIGHLIGHTING
|
|
Coloring the different syntactic elements of a file
|
|
is done via regular expressions (see the \fBcolor\fR command below).
|
|
This is inherently imperfect, because regular expressions are not
|
|
powerful enough to fully parse a file. Nevertheless, regular
|
|
expressions can do a lot and are easy to make, so they are a
|
|
good fit for a small editor like \fBnano\fR.
|
|
.sp
|
|
For each kind of file a separate syntax can be defined
|
|
via the following commands:
|
|
.TP
|
|
.BI syntax " name \fR[" """" fileregex """ " \fR...]
|
|
Start the definition of a syntax with this \fIname\fR.
|
|
All subsequent \fBcolor\fR and other such commands
|
|
will be added to this syntax, until a new \fBsyntax\fR
|
|
command is encountered.
|
|
|
|
When \fBnano\fR is run, this syntax will be automatically
|
|
activated if the current filename matches the extended regular
|
|
expression \fIfileregex\fR. Or the syntax can be explicitly
|
|
activated by using the \fB-Y\fR or \fB\-\-syntax\fR
|
|
command-line option followed by the \fIname\fR.
|
|
|
|
The syntax \fBdefault\fP is special: it takes no \fIfileregex\fR,
|
|
and applies to files that don't match any syntax's regexes.
|
|
The syntax \fBnone\fP is reserved; specifying it on the command line
|
|
is the same as not having a syntax at all.
|
|
.TP
|
|
.BI "header """ regex """ \fR...
|
|
If from all defined syntaxes no \fIfileregex\fR matched, then compare
|
|
this \fIregex\fR (or regexes) against the first line of the current file,
|
|
to determine whether this syntax should be used for it.
|
|
.TP
|
|
.BI "magic """ regex """ \fR...
|
|
If no \fIfileregex\fR matched and no \fBheader\fR regex matched
|
|
either, then compare this \fIregex\fR (or regexes) against the
|
|
result of querying the \fBmagic\fP database about the current
|
|
file, to determine whether this syntax should be used for it.
|
|
(This functionality only works when \fBlibmagic\fP is installed on the
|
|
system and will be silently ignored otherwise.)
|
|
.TP
|
|
.BI linter " program " \fR[ "arg " \fR...]
|
|
Use the given \fIprogram\fR to run a syntax check on the current buffer.
|
|
(This overrides the speller function.)
|
|
.TP
|
|
.BI "comment """ string """
|
|
Use the given \fIstring\fR for commenting and uncommenting lines.
|
|
If the string contains a vertical bar or pipe character (\fB|\fR),
|
|
this designates bracket-style comments; for example, "\fB/*|*/\fR" for
|
|
CSS files. The characters before the pipe are prepended to the line and the
|
|
characters after the pipe are appended at the end of the line. If no pipe
|
|
character is present, the full string is prepended; for example, "\fB#\fR"
|
|
for Python files. If empty double quotes are specified, the comment/uncomment
|
|
function is disabled; for example, "" for JSON.
|
|
The default value is "\fB#\fP".
|
|
.TP
|
|
.BI "color " fgcolor , bgcolor " """ regex """ " \fR...
|
|
Display all pieces of text that match
|
|
the extended regular expression \fIregex\fP with foreground color
|
|
\fIfgcolor\fP and background color \fIbgcolor\fP, at least one of which
|
|
must be specified. Valid names for foreground and background colors are:
|
|
.BR white ", " black ", " blue ", " green ", " red ", "
|
|
.BR cyan ", " yellow ", " magenta ", and " normal
|
|
-- where \fBnormal\fR means the default foreground or background color.
|
|
You may use the prefix \fBbright\fR to get a stronger color highlight for the
|
|
foreground. If your terminal supports transparency, not specifying a
|
|
\fIbgcolor\fP tells \fBnano\fP to attempt to use a transparent
|
|
background.
|
|
.TP
|
|
.BI "icolor " fgcolor , bgcolor " """ regex """ " \fR...
|
|
Same as above, except that the matching is case insensitive.
|
|
.TP
|
|
.BI "color " fgcolor , bgcolor " start=""" fromrx """ end=""" torx """
|
|
Display all pieces of text whose start matches extended regular expression
|
|
\fIfromrx\fP and whose end matches extended regular expression \fItorx\fP with
|
|
foreground color \fIfgcolor\fP and background color \fIbgcolor\fP,
|
|
at least one of which must be specified. This means that, after an
|
|
initial instance of \fIfromrx\fP, all text until the first instance of
|
|
\fItorx\fP will be colored. This allows syntax highlighting to span
|
|
multiple lines.
|
|
.TP
|
|
.BI "icolor " fgcolor , bgcolor " start=""" fromrx """ end=""" torx """
|
|
Same as above, except that the matching is case insensitive.
|
|
.TP
|
|
.BI "include """ syntaxfile """
|
|
Read in self-contained color syntaxes from \fIsyntaxfile\fP. Note that
|
|
\fIsyntaxfile\fP may contain only the above commands, from \fBsyntax\fP
|
|
to \fBicolor\fP.
|
|
.TP
|
|
.BI extendsyntax " name command " \fR[ "arg " \fR...]
|
|
Extend the syntax previously defined as \fIname\fR with another
|
|
\fIcommand\fR. This allows adding a new \fBcolor\fP, \fBicolor\fP,
|
|
\fBheader\fP, \fBmagic\fP, \fBcomment\fP, or \fBlinter\fP
|
|
command to an already defined syntax -- useful when you want to
|
|
slightly improve a syntax defined in one of the system-installed
|
|
files (which normally are not writable).
|
|
|
|
.P
|
|
Note: the \fBformatter\fR command has been removed. It was superseded by
|
|
a more general mechanism: the filtering of buffer or marked text through
|
|
an external command. Such filtering is done by typing \fB^R^X\fR and then
|
|
preceding your formatter command with the pipe symbol (\fB|\fR). It has
|
|
the added advantage that the operation can be undone.
|
|
.PP
|
|
If you use such a formatting command regularly, you could assign the relevant
|
|
series of keystrokes to a single key in your nanorc:
|
|
.PP
|
|
.RS
|
|
.B "bind M\-F \(dq^R^X|yourformatcommand^M\(dq main"
|
|
.RE
|
|
.PP
|
|
(Note that the \fB^R\fR, \fB^X\fR, and \fB^M\fR are each a single, literal
|
|
control character. You can enter them by preceding each with \fBM-V\fR.)
|
|
|
|
.SH REBINDING KEYS
|
|
Key bindings can be changed via the following three commands:
|
|
.RS 3
|
|
.TP
|
|
.BI bind " key function menu"
|
|
Rebinds the key \fIkey\fP to a new function named \fIfunction\fP in the
|
|
context of menu \fImenu\fP (or in all menus where the function exists
|
|
by using \fBall\fP).
|
|
.TP
|
|
.BI bind " key " """" string """" " menu"
|
|
Makes the given \fIkey\fR produce the given \fIstring\fR in the given
|
|
\fImenu\fR (or in all menus where the key exists when \fBall\fR is used).
|
|
The \fIstring\fR can consist of text or commands or a mix of them.
|
|
(To enter a command into the \fIstring\fR, precede its keystroke
|
|
with \fBM-V\fR.)
|
|
|
|
.TP
|
|
.BI unbind " key menu"
|
|
Unbinds the key \fIkey\fP from the menu named \fImenu\fP (or from all
|
|
menus where it exists by using \fBall\fP).
|
|
.RE
|
|
|
|
.TP
|
|
The format of \fIkey\fP should be one of:
|
|
.RS 3
|
|
.TP 3
|
|
.B ^
|
|
followed by a Latin letter, by one of several ASCII characters
|
|
(@, ], \\, ^, or _), or by the word "Space".
|
|
Example: ^C.
|
|
.TP
|
|
.B M-
|
|
followed by any ASCII character except [, or by the word "Space".
|
|
Example: M-C.
|
|
.TP
|
|
.B F
|
|
followed by a numeric value from 1 to 16.
|
|
Example: F10.
|
|
.TP
|
|
the word "Ins" or the word "Del".
|
|
.RE
|
|
|
|
.TP
|
|
Valid \fIfunction\fP names to be bound are:
|
|
.RS 3
|
|
.TP 2
|
|
.B help
|
|
Invokes the help viewer.
|
|
.TP
|
|
.B cancel
|
|
Cancels the current command.
|
|
.TP
|
|
.B exit
|
|
Exits from the program (or from the help viewer or the file browser).
|
|
.TP
|
|
.B writeout
|
|
Writes the current buffer to disk, asking for a name.
|
|
.TP
|
|
.B savefile
|
|
Writes the current file to disk without prompting.
|
|
.TP
|
|
.B insert
|
|
Inserts a file into the current buffer (at the current cursor position),
|
|
or into a new buffer when option \fBmultibuffer\fR is set.
|
|
.TP
|
|
.B whereis
|
|
Starts a forward search for text in the current buffer -- or for filenames
|
|
matching a string in the current list in the file browser.
|
|
.TP
|
|
.B wherewas
|
|
Starts a backward search for text in the current buffer -- or for filenames
|
|
matching a string in the current list in the file browser.
|
|
.TP
|
|
.B findprevious
|
|
Searches the next occurrence in the backward direction.
|
|
.TP
|
|
.B findnext
|
|
Searches the next occurrence in the forward direction.
|
|
.TP
|
|
.B replace
|
|
Interactively replaces text within the current buffer.
|
|
.TP
|
|
.B cut
|
|
Cuts and stores the current line (or the marked region).
|
|
.TP
|
|
.B copy
|
|
Copies the current line (or the marked region) without deleting it.
|
|
(The old form 'copytext' is deprecated.)
|
|
.TP
|
|
.B paste
|
|
Pastes the currently stored text into the current buffer at the
|
|
current cursor position.
|
|
(The old form 'uncut' is deprecated.)
|
|
.TP
|
|
.B zap
|
|
Throw away the current line (or the marked region).
|
|
(This function is bound by default to <Meta+Delete>.)
|
|
.TP
|
|
.B cutwordleft
|
|
Cuts from the cursor position to the beginning of the preceding word.
|
|
(This function is not bound by default. If your terminal produces
|
|
\fB^H\fR for <Ctrl+Backspace>, you can make <Ctrl+Backspace> delete
|
|
the word to the left of the cursor by rebinding ^H to this function.)
|
|
.TP
|
|
.B cutwordright
|
|
Cuts from the cursor position to the beginning of the next word.
|
|
(This function is bound by default to <Ctrl+Delete>.)
|
|
.TP
|
|
.B cutrestoffile
|
|
Cuts all text from the cursor position till the end of the buffer.
|
|
.TP
|
|
.B mark
|
|
Sets the mark at the current position, to start selecting text.
|
|
Or, when it is set, unsets the mark.
|
|
.TP
|
|
.B curpos
|
|
Shows the current cursor position: the line, column, and character positions.
|
|
.TP
|
|
.B wordcount
|
|
Counts the number of words, lines and characters in the current buffer.
|
|
.TP
|
|
.B speller
|
|
Invokes a spell-checking program (or linting program,
|
|
if the active syntax defines such a thing).
|
|
.TP
|
|
.B linter
|
|
A synonym of \fBspeller\fR (for when the speller has not been configured).
|
|
.TP
|
|
.B justify
|
|
Justifies the current paragraph. A paragraph is a group of contiguous lines
|
|
that, apart from possibly the first line, all have the same indentation. The
|
|
beginning of a paragraph is detected by either this lone line with a differing
|
|
indentation or by a preceding blank line.
|
|
.TP
|
|
.B fulljustify
|
|
Justifies the entire current buffer.
|
|
.TP
|
|
.B indent
|
|
Indents (shifts to the right) the currently marked text.
|
|
.TP
|
|
.B unindent
|
|
Unindents (shifts to the left) the currently marked text.
|
|
.TP
|
|
.B comment
|
|
Comments or uncomments the current line or marked lines, using the comment
|
|
style specified in the active syntax.
|
|
.TP
|
|
.B complete
|
|
Completes the fragment before the cursor to a full word found elsewhere
|
|
in the current buffer.
|
|
.TP
|
|
.B left
|
|
Goes left one position (in the editor or browser).
|
|
.TP
|
|
.B right
|
|
Goes right one position (in the editor or browser).
|
|
.TP
|
|
.B up
|
|
Goes one line up (in the editor or browser).
|
|
.TP
|
|
.B down
|
|
Goes one line down (in the editor or browser).
|
|
.TP
|
|
.B scrollup
|
|
Scrolls the viewport up one row (meaning that the text slides down)
|
|
while keeping the cursor in the same text position, if possible.
|
|
.TP
|
|
.B scrolldown
|
|
Scrolls the viewport down one row (meaning that the text slides up)
|
|
while keeping the cursor in the same text position, if possible.
|
|
.TP
|
|
.B prevword
|
|
Moves the cursor to the beginning of the previous word.
|
|
.TP
|
|
.B nextword
|
|
Moves the cursor to the beginning of the next word.
|
|
.TP
|
|
.B home
|
|
Moves the cursor to the beginning of the current line.
|
|
.TP
|
|
.B end
|
|
Moves the cursor to the end of the current line.
|
|
.TP
|
|
.B beginpara
|
|
Moves the cursor to the beginning of the current paragraph.
|
|
.TP
|
|
.B endpara
|
|
Moves the cursor to the end of the current paragraph.
|
|
.TP
|
|
.B prevblock
|
|
Moves the cursor to the beginning of the current or preceding block of text.
|
|
(Blocks are separated by one or more blank lines.)
|
|
.TP
|
|
.B nextblock
|
|
Moves the cursor to the beginning of the next block of text.
|
|
.TP
|
|
.B pageup
|
|
Goes up one screenful.
|
|
.TP
|
|
.B pagedown
|
|
Goes down one screenful.
|
|
.TP
|
|
.B firstline
|
|
Goes to the first line of the file.
|
|
.TP
|
|
.B lastline
|
|
Goes to the last line of the file.
|
|
.TP
|
|
.B gotoline
|
|
Goes to a specific line (and column if specified). Negative numbers count
|
|
from the end of the file (and end of the line).
|
|
.TP
|
|
.B findbracket
|
|
Moves the cursor to the bracket (brace, parenthesis, etc.) that matches
|
|
(pairs) with the one under the cursor.
|
|
.TP
|
|
.B prevbuf
|
|
Switches to editing/viewing the previous buffer when multiple buffers are open.
|
|
.TP
|
|
.B nextbuf
|
|
Switches to editing/viewing the next buffer when multiple buffers are open.
|
|
.TP
|
|
.B verbatim
|
|
Inserts the next keystroke verbatim into the file.
|
|
.TP
|
|
.B tab
|
|
Inserts a tab at the current cursor location.
|
|
.TP
|
|
.B enter
|
|
Inserts a new line below the current one.
|
|
.TP
|
|
.B delete
|
|
Deletes the character under the cursor.
|
|
.TP
|
|
.B backspace
|
|
Deletes the character before the cursor.
|
|
.TP
|
|
.B recordmacro
|
|
Starts the recording of keystrokes -- the keystrokes are stored
|
|
as a macro. When already recording, the recording is stopped.
|
|
.TP
|
|
.B runmacro
|
|
Replays the keystrokes of the last recorded macro.
|
|
.TP
|
|
.B undo
|
|
Undoes the last performed text action (add text, delete text, etc).
|
|
.TP
|
|
.B redo
|
|
Redoes the last undone action (i.e., it undoes an undo).
|
|
.TP
|
|
.B refresh
|
|
Refreshes the screen.
|
|
.TP
|
|
.B suspend
|
|
Suspends the editor (if the suspending function is enabled, see the
|
|
"suspendenable" entry below).
|
|
.TP
|
|
.B casesens
|
|
Toggles whether searching/replacing ignores or respects the case of
|
|
the given characters.
|
|
.TP
|
|
.B regexp
|
|
Toggles whether searching/replacing uses literal strings or regular expressions.
|
|
.TP
|
|
.B backwards
|
|
Toggles whether searching/replacing goes forward or backward.
|
|
.TP
|
|
.B older
|
|
Retrieves the previous (earlier) entry at a prompt.
|
|
.TP
|
|
.B newer
|
|
Retrieves the next (later) entry at a prompt.
|
|
.TP
|
|
.B flipreplace
|
|
Toggles between searching for something and replacing something.
|
|
.TP
|
|
.B flipgoto
|
|
Toggles between searching for text and targeting a line number.
|
|
(The form 'gototext' is deprecated.)
|
|
.TP
|
|
.B flipexecute
|
|
Toggles between inserting a file and executing a command.
|
|
.TP
|
|
.B flippipe
|
|
When executing a command, toggles whether the current buffer (or marked
|
|
region) is piped to the command.
|
|
.TP
|
|
.B flipnewbuffer
|
|
Toggles between inserting into the current buffer and into a new
|
|
empty buffer.
|
|
.TP
|
|
.B flipconvert
|
|
When reading in a file, toggles between converting and not converting
|
|
it from DOS/Mac format. Converting is the default.
|
|
.TP
|
|
.B dosformat
|
|
When writing a file, switches to writing a DOS format (CR/LF).
|
|
.TP
|
|
.B macformat
|
|
When writing a file, switches to writing a Mac format.
|
|
.TP
|
|
.B append
|
|
When writing a file, appends to the end instead of overwriting.
|
|
.TP
|
|
.B prepend
|
|
When writing a file, 'prepends' (writes at the beginning) instead of overwriting.
|
|
.TP
|
|
.B backup
|
|
When writing a file, creates a backup of the current file.
|
|
.TP
|
|
.B discardbuffer
|
|
When about to write a file, discard the current buffer without saving.
|
|
(This function is bound by default only when option \fB\-\-tempfile\fR
|
|
is in effect.)
|
|
.TP
|
|
.B browser
|
|
Starts the file browser, allowing to select a file from a list.
|
|
.TP
|
|
.B gotodir
|
|
Goes to a directory to be specified, allowing to browse anywhere
|
|
in the filesystem.
|
|
.TP
|
|
.B firstfile
|
|
Goes to the first file when using the file browser (reading or writing files).
|
|
.TP
|
|
.B lastfile
|
|
Goes to the last file when using the file browser (reading or writing files).
|
|
.TP
|
|
.B nohelp
|
|
Toggles the presence of the two-line list of key bindings at the bottom of the screen.
|
|
.TP
|
|
.B constantshow
|
|
Toggles the constant display of the current line, column, and character positions.
|
|
(The form 'constupdate' is deprecated.)
|
|
.TP
|
|
.B smoothscroll
|
|
Toggles smooth scrolling (when moving around with the arrow keys).
|
|
.TP
|
|
.B softwrap
|
|
Toggles the displaying of overlong lines on multiple screen lines.
|
|
.TP
|
|
.B linenumbers
|
|
Toggles the display of line numbers in front of the text.
|
|
.TP
|
|
.B whitespacedisplay
|
|
Toggles the showing of whitespace.
|
|
.TP
|
|
.B nosyntax
|
|
Toggles syntax highlighting.
|
|
.TP
|
|
.B smarthome
|
|
Toggles the smartness of the Home key.
|
|
.TP
|
|
.B autoindent
|
|
Toggles whether a newly created line will contain the same amount of leading
|
|
whitespace as the preceding line -- or as the next line if the preceding line
|
|
is the beginning of a paragraph.
|
|
.TP
|
|
.B cutfromcursor
|
|
Toggles whether cutting text will cut the whole line or just from the current cursor
|
|
position to the end of the line.
|
|
(The form 'cuttoend' is deprecated.)
|
|
.TP
|
|
.B nowrap
|
|
Toggles whether long lines will be hard-wrapped to the next line.
|
|
.TP
|
|
.B tabstospaces
|
|
Toggles whether typed tabs will be converted to spaces.
|
|
.TP
|
|
.B mouse
|
|
Toggles mouse support.
|
|
.TP
|
|
.B suspendenable
|
|
Toggles whether the suspend sequence (normally ^Z) will suspend the editor window.
|
|
.RE
|
|
|
|
.TP
|
|
Valid \fImenu\fP sections are:
|
|
.RS 3
|
|
.TP 2
|
|
.B main
|
|
The main editor window where text is entered and edited.
|
|
.TP
|
|
.B search
|
|
The search menu (AKA whereis).
|
|
.TP
|
|
.B replace
|
|
The 'search to replace' menu.
|
|
.TP
|
|
.B replacewith
|
|
The 'replace with' menu, which comes up after 'search to replace'.
|
|
.TP
|
|
.B yesno
|
|
The 'yesno' menu, where the Yes/No/All/Cancel question is asked.
|
|
.TP
|
|
.B gotoline
|
|
The 'goto line (and column)' menu.
|
|
.TP
|
|
.B writeout
|
|
The 'write file' menu.
|
|
.TP
|
|
.B insert
|
|
The 'insert file' menu.
|
|
.TP
|
|
.B extcmd
|
|
The menu for inserting output from an external command, reached from the insert menu.
|
|
.TP
|
|
.B help
|
|
The help-viewer menu.
|
|
.TP
|
|
.B spell
|
|
The interactive spell checker Yes/no menu.
|
|
.TP
|
|
.B linter
|
|
The linter menu.
|
|
.TP
|
|
.B browser
|
|
The file browser for inserting or writing a file.
|
|
.TP
|
|
.B whereisfile
|
|
The 'search for a file' menu in the file browser.
|
|
.TP
|
|
.B gotodir
|
|
The 'go to directory' menu in the file browser.
|
|
.TP
|
|
.B all
|
|
A special name that encompasses all menus.
|
|
For \fBbind\fR it means all menus where the specified \fIfunction\fR exists;
|
|
for \fBunbind\fR it means all menus where the specified \fIkey\fR exists.
|
|
.RE
|
|
|
|
.SH FILES
|
|
.TP
|
|
.B /etc/nanorc
|
|
System-wide configuration file.
|
|
.TP
|
|
.BR ~/.nanorc " or " \fI$XDG_CONFIG_HOME\fB/nano/nanorc " or " ~/.config/nano/nanorc
|
|
Per-user configuration file.
|
|
|
|
.SH SEE ALSO
|
|
.BR nano (1)
|
|
|
|
.SH AUTHOR
|
|
Chris Allegretta and others (see the files \fIAUTHORS\fP and
|
|
\fITHANKS\fP for details). This manual page was originally written by
|
|
Jordi Mallach for the Debian system (but may be used by others).
|