708 lines
24 KiB
HTML
708 lines
24 KiB
HTML
|
<!-- Creator : groff version 1.22.4 -->
|
||
|
|
<!-- CreationDate: Wed Jan 18 08:46:05 2023 -->
|
||
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
|
||
|
|
"http://www.w3.org/TR/html4/loose.dtd">
|
||
|
|
<html>
|
||
|
|
<head>
|
||
|
|
<meta name="generator" content="groff -Thtml, see www.gnu.org">
|
||
|
|
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
|
||
|
|
<meta name="Content-Style" content="text/css">
|
||
|
|
<style type="text/css">
|
||
|
|
p { margin-top: 0; margin-bottom: 0; vertical-align: top }
|
||
|
|
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
|
||
|
|
table { margin-top: 0; margin-bottom: 0; vertical-align: top }
|
||
|
|
h1 { text-align: center }
|
||
|
|
</style>
|
||
|
|
<title>NANO</title>
|
||
|
|
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
|
||
|
|
<h1 align="center">NANO</h1>
|
||
|
|
|
||
|
|
<a href="#NAME">NAME</a><br>
|
||
|
|
<a href="#SYNOPSIS">SYNOPSIS</a><br>
|
||
|
|
<a href="#DESCRIPTION">DESCRIPTION</a><br>
|
||
|
|
<a href="#EDITING">EDITING</a><br>
|
||
|
|
<a href="#OPTIONS">OPTIONS</a><br>
|
||
|
|
<a href="#TOGGLES">TOGGLES</a><br>
|
||
|
|
<a href="#FILES">FILES</a><br>
|
||
|
|
<a href="#NOTES">NOTES</a><br>
|
||
|
|
<a href="#BUGS">BUGS</a><br>
|
||
|
|
<a href="#HOMEPAGE">HOMEPAGE</a><br>
|
||
|
|
<a href="#SEE ALSO">SEE ALSO</a><br>
|
||
|
|
|
||
|
|
<hr>
|
||
|
|
|
||
|
|
|
||
|
|
<h2>NAME
|
||
|
|
<a name="NAME"></a>
|
||
|
|
</h2>
|
||
|
|
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em">nano -
|
||
|
|
Nano’s ANOther editor, inspired by Pico</p>
|
||
|
|
|
||
|
|
<h2>SYNOPSIS
|
||
|
|
<a name="SYNOPSIS"></a>
|
||
|
|
</h2>
|
||
|
|
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em"><b>nano</b>
|
||
|
|
[<i>options</i>]
|
||
|
|
[[<b>+</b><i>line</i>[<b>,</b><i>column</i>]]
|
||
|
|
<i>file</i>]...</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em"><b>nano</b>
|
||
|
|
[<i>options</i>]
|
||
|
|
[[<b>+</b>[<b>crCR</b>](<b>/</b>|<b>?</b>)<i>string</i>]
|
||
|
|
<i>file</i>]...</p>
|
||
|
|
|
||
|
|
<h2>DESCRIPTION
|
||
|
|
<a name="DESCRIPTION"></a>
|
||
|
|
</h2>
|
||
|
|
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em"><b>nano</b> is
|
||
|
|
a small and friendly editor. It copies the look and feel of
|
||
|
|
Pico, but is free software, and implements several features
|
||
|
|
that Pico lacks, such as: opening multiple files, scrolling
|
||
|
|
per line, undo/redo, syntax coloring, line numbering, and
|
||
|
|
soft-wrapping overlong lines.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em">When giving a
|
||
|
|
filename on the command line, the cursor can be put on a
|
||
|
|
specific line by adding the line number with a plus sign
|
||
|
|
(<b>+</b>) before the filename, and even in a specific
|
||
|
|
column by adding it with a comma. (Negative numbers count
|
||
|
|
from the end of the file or line.) The cursor can be put on
|
||
|
|
the first or last occurrence of a specific string by
|
||
|
|
specifying that string after <b>+/</b> or <b>+?</b> before
|
||
|
|
the filename. The string can be made case sensitive and/or
|
||
|
|
caused to be interpreted as a regular expression by
|
||
|
|
inserting <b>c</b> and/or <b>r</b> after the <b>+</b> sign.
|
||
|
|
These search modes can be explicitly disabled by using the
|
||
|
|
uppercase variant of those letters: <b>C</b> and/or
|
||
|
|
<b>R</b>. When the string contains spaces, it needs to be
|
||
|
|
enclosed in quotes. To give an example: to open a file at
|
||
|
|
the first occurrence of the word "Foo", you would
|
||
|
|
do:</p>
|
||
|
|
|
||
|
|
<p style="margin-left:17%; margin-top: 1em"><b>nano
|
||
|
|
+c/Foo</b> <i>file</i></p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em">As a special
|
||
|
|
case: if instead of a filename a dash (<b>-</b>) is given,
|
||
|
|
<b>nano</b> will read data from standard input.</p>
|
||
|
|
|
||
|
|
<h2>EDITING
|
||
|
|
<a name="EDITING"></a>
|
||
|
|
</h2>
|
||
|
|
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em">Entering text
|
||
|
|
and moving around in a file is straightforward: typing the
|
||
|
|
letters and using the normal cursor movement keys. Commands
|
||
|
|
are entered by using the Control (^) and the Alt or Meta
|
||
|
|
(M-) keys. Typing <b>^K</b> deletes the current line and
|
||
|
|
puts it in the cutbuffer. Consecutive <b>^K</b>s will put
|
||
|
|
all deleted lines together in the cutbuffer. Any cursor
|
||
|
|
movement or executing any other command will cause the next
|
||
|
|
<b>^K</b> to overwrite the cutbuffer. A <b>^U</b> will paste
|
||
|
|
the current contents of the cutbuffer at the current cursor
|
||
|
|
position.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em">When a more
|
||
|
|
precise piece of text needs to be cut or copied, you can
|
||
|
|
mark its start with <b>^6</b>, move the cursor to its end
|
||
|
|
(the marked text will be highlighted), and then use
|
||
|
|
<b>^K</b> to cut it, or <b>M-6</b> to copy it to the
|
||
|
|
cutbuffer. You can also save the marked text to a file with
|
||
|
|
<b>^O</b>, or spell check it with <b>^T^T</b>.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em">On some
|
||
|
|
terminals, text can be selected also by holding down Shift
|
||
|
|
while using the arrow keys. Holding down the Ctrl or Alt key
|
||
|
|
too will increase the stride. Any cursor movement without
|
||
|
|
Shift being held will cancel such a selection.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em">Any valid
|
||
|
|
Unicode code point can be inserted into the buffer by typing
|
||
|
|
<b>M-V</b> followed by the hexadecimal digits of the code
|
||
|
|
point (concluded with <b><Space></b> or
|
||
|
|
<b><Enter></b> when it are fewer than six digits). A
|
||
|
|
literal control code (except <b>^J</b>) can be inserted by
|
||
|
|
typing <b>M-V</b> followed by the pertinent keystroke.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em">The two lines
|
||
|
|
at the bottom of the screen show some important commands;
|
||
|
|
the built-in help (<b>^G</b>) lists all the available ones.
|
||
|
|
The default key bindings can be changed via a <i>nanorc</i>
|
||
|
|
file -- see <b>nanorc</b>(5).</p>
|
||
|
|
|
||
|
|
<h2>OPTIONS
|
||
|
|
<a name="OPTIONS"></a>
|
||
|
|
</h2>
|
||
|
|
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em"><b>-A</b>,
|
||
|
|
<b>--smarthome</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">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.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-B</b>, <b>--backup</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">When saving a file, back up the
|
||
|
|
previous version of it, using the current filename suffixed
|
||
|
|
with a tilde (<b>~</b>).</p>
|
||
|
|
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-C </b><i>directory</i>,
|
||
|
|
<b>--backupdir=</b><i>directory</i></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">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
|
||
|
|
(<b>-B</b>). The uniquely numbered files are stored in the
|
||
|
|
specified <i>directory</i>.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-D</b>,
|
||
|
|
<b>--boldtext</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">For the interface, use bold
|
||
|
|
instead of reverse video. This will be overridden by setting
|
||
|
|
the options <b>titlecolor</b>, <b>statuscolor</b>,
|
||
|
|
<b>keycolor</b>, <b>functioncolor</b>, <b>numbercolor</b>,
|
||
|
|
and/or <b>selectedcolor</b> in your nanorc file. See
|
||
|
|
<b>nanorc</b>(5).</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-E</b>,
|
||
|
|
<b>--tabstospaces</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Convert each typed tab to
|
||
|
|
spaces -- to the number of spaces that a tab at that
|
||
|
|
position would take up.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-F</b>,
|
||
|
|
<b>--multibuffer</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Read a file into a new buffer
|
||
|
|
by default.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-G</b>, <b>--locking</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Use vim-style file locking when
|
||
|
|
editing files.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-H</b>,
|
||
|
|
<b>--historylog</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Save the last hundred search
|
||
|
|
strings and replacement strings and executed commands, so
|
||
|
|
they can be easily reused in later sessions.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-I</b>,
|
||
|
|
<b>--ignorercfiles</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Don’t look at the
|
||
|
|
system’s <i>nanorc</i> nor at the user’s
|
||
|
|
<i>nanorc</i>.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-J </b><i>number</i>,
|
||
|
|
<b>--guidestripe=</b><i>number</i></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Draw a vertical stripe at the
|
||
|
|
given column, to help judge the width of the text. (The
|
||
|
|
color of the stripe can be changed with <b>set
|
||
|
|
stripecolor</b> in your <i>nanorc</i> file.)</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-K</b>,
|
||
|
|
<b>--rawsequences</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Interpret escape sequences
|
||
|
|
directly, instead of asking <b>ncurses</b> to translate
|
||
|
|
them. (If you need this option to get some keys to work
|
||
|
|
properly, it means that the terminfo terminal description
|
||
|
|
that is used does not fully match the actual behavior of
|
||
|
|
your terminal. This can happen when you ssh into a BSD
|
||
|
|
machine, for example.) Using this option disables
|
||
|
|
<b>nano</b>’s mouse support.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-L</b>,
|
||
|
|
<b>--nonewlines</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Don’t automatically add a
|
||
|
|
newline when a text does not end with one. (This can cause
|
||
|
|
you to save non-POSIX text files.)</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-M</b>,
|
||
|
|
<b>--trimblanks</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Snip trailing whitespace from
|
||
|
|
the wrapped line when automatic hard-wrapping occurs or when
|
||
|
|
text is justified.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-N</b>,
|
||
|
|
<b>--noconvert</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Disable automatic conversion of
|
||
|
|
files from DOS/Mac format.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-O</b>,
|
||
|
|
<b>--bookstyle</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">When justifying, treat any line
|
||
|
|
that starts with whitespace as the beginning of a paragraph
|
||
|
|
(unless auto-indenting is on).</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-P</b>,
|
||
|
|
<b>--positionlog</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">For the 200 most recent files,
|
||
|
|
log the last position of the cursor, and place it at that
|
||
|
|
position again upon reopening such a file.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-Q
|
||
|
|
"</b><i>regex</i><b>"</b>,
|
||
|
|
<b>--quotestr="</b><i>regex</i><b>"</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Set the regular expression for
|
||
|
|
matching the quoting part of a line. The default value is
|
||
|
|
"<b>^([ \t]*([!#%:;>|}]|//))+</b>". (Note
|
||
|
|
that <b>\t</b> stands for an actual Tab.) This makes it
|
||
|
|
possible to rejustify blocks of quoted text when composing
|
||
|
|
email, and to rewrap blocks of line comments when writing
|
||
|
|
source code.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-R</b>,
|
||
|
|
<b>--restricted</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Restricted mode: don’t
|
||
|
|
read or write to any file not specified on the command line.
|
||
|
|
This means: don’t read or write history files;
|
||
|
|
don’t allow suspending; don’t allow spell
|
||
|
|
checking; don’t allow a file to be appended to,
|
||
|
|
prepended to, or saved under a different name if it already
|
||
|
|
has one; and don’t make backup files. Restricted mode
|
||
|
|
can also be activated by invoking <b>nano</b> with any name
|
||
|
|
beginning with ’r’ (e.g. "rnano").</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-S</b>,
|
||
|
|
<b>--softwrap</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Display over multiple screen
|
||
|
|
rows lines that exceed the screen’s width. (You can
|
||
|
|
make this soft-wrapping occur at whitespace instead of
|
||
|
|
rudely at the screen’s edge, by using also
|
||
|
|
<b>--atblanks</b>.) (The old short option, <b>-$</b>, is
|
||
|
|
deprecated.)</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-T </b><i>number</i>,
|
||
|
|
<b>--tabsize=</b><i>number</i></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Set the size (width) of a tab
|
||
|
|
to <i>number</i> columns. The value of <i>number</i> must be
|
||
|
|
greater than 0. The default value is <b>8</b>.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-U</b>,
|
||
|
|
<b>--quickblank</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Make status-bar messages
|
||
|
|
disappear after 1 keystroke instead of after 20. Note that
|
||
|
|
option <b>-c</b> (<b>--constantshow</b>) overrides this.
|
||
|
|
When option <b>--minibar</b> or <b>--zero</b> is in effect,
|
||
|
|
<b>--quickblank</b> makes a message disappear after 0.8
|
||
|
|
seconds instead of after the default 1.5 seconds.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-V</b>, <b>--version</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Show the current version number
|
||
|
|
and exit.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-W</b>,
|
||
|
|
<b>--wordbounds</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Detect word boundaries
|
||
|
|
differently by treating punctuation characters as part of a
|
||
|
|
word.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-X
|
||
|
|
"</b><i>characters</i><b>"</b>,
|
||
|
|
<b>--wordchars="</b><i>characters</i><b>"</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Specify which other characters
|
||
|
|
(besides the normal alphanumeric ones) should be considered
|
||
|
|
as part of a word. When using this option, you probably want
|
||
|
|
to omit <b>-W</b> (<b>--wordbounds</b>).</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-Y </b><i>name</i>,
|
||
|
|
<b>--syntax=</b><i>name</i></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Specify the name of the syntax
|
||
|
|
highlighting to use from among the ones defined in the
|
||
|
|
<i>nanorc</i> files.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-Z</b>, <b>--zap</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Let an unmodified Backspace or
|
||
|
|
Delete erase the marked region (instead of a single
|
||
|
|
character, and without affecting the cutbuffer).</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-a</b>,
|
||
|
|
<b>--atblanks</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">When doing soft line wrapping,
|
||
|
|
wrap lines at whitespace instead of always at the edge of
|
||
|
|
the screen.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-b</b>,
|
||
|
|
<b>--breaklonglines</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Automatically hard-wrap the
|
||
|
|
current line when it becomes overlong. (This option is the
|
||
|
|
opposite of <b>-w</b> (<b>--nowrap</b>) -- the last one
|
||
|
|
given takes effect.)</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-c</b>,
|
||
|
|
<b>--constantshow</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Constantly show the cursor
|
||
|
|
position on the status bar. Note that this overrides option
|
||
|
|
<b>-U</b> (<b>--quickblank</b>).</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-d</b>,
|
||
|
|
<b>--rebinddelete</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Interpret the Delete and
|
||
|
|
Backspace keys differently so that both Backspace and Delete
|
||
|
|
work properly. You should only use this option when on your
|
||
|
|
system either Backspace acts like Delete or Delete acts like
|
||
|
|
Backspace.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-e</b>,
|
||
|
|
<b>--emptyline</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Do not use the line below the
|
||
|
|
title bar, leaving it entirely blank.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-f </b><i>file</i>,
|
||
|
|
<b>--rcfile=</b><i>file</i></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Read only this <i>file</i> for
|
||
|
|
setting nano’s options, instead of reading both the
|
||
|
|
system-wide and the user’s nanorc files.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-g</b>,
|
||
|
|
<b>--showcursor</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Make the cursor visible in the
|
||
|
|
file browser (putting it on the highlighted item) and in the
|
||
|
|
help viewer. Useful for braille users and people with poor
|
||
|
|
vision.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-h</b>, <b>--help</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Show a summary of the available
|
||
|
|
command-line options and exit.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-i</b>,
|
||
|
|
<b>--autoindent</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">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).</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-j</b>,
|
||
|
|
<b>--jumpyscrolling</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Scroll the buffer contents per
|
||
|
|
half-screen instead of per line.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-k</b>,
|
||
|
|
<b>--cutfromcursor</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Make the ’Cut Text’
|
||
|
|
command (normally <b>^K</b>) cut from the current cursor
|
||
|
|
position to the end of the line, instead of cutting the
|
||
|
|
entire line.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-l</b>,
|
||
|
|
<b>--linenumbers</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Display line numbers to the
|
||
|
|
left of the text area. (Any line with an anchor additionally
|
||
|
|
gets a mark in the margin.)</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-m</b>, <b>--mouse</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">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.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-n</b>, <b>--noread</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Treat any name given on the
|
||
|
|
command line as a new file. This allows <b>nano</b> to write
|
||
|
|
to named pipes: it will start with a blank buffer, and will
|
||
|
|
write to the pipe when the user saves the "file".
|
||
|
|
This way <b>nano</b> can be used as an editor in combination
|
||
|
|
with for instance <b>gpg</b> without having to write
|
||
|
|
sensitive data to disk first.</p>
|
||
|
|
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-o </b><i>directory</i>,
|
||
|
|
<b>--operatingdir=</b><i>directory</i></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Set the operating directory.
|
||
|
|
This makes <b>nano</b> set up something similar to a
|
||
|
|
chroot.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-p</b>,
|
||
|
|
<b>--preserve</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Preserve the XON and XOFF
|
||
|
|
sequences (<b>^Q</b> and <b>^S</b>) so they will be caught
|
||
|
|
by the terminal.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-q</b>,
|
||
|
|
<b>--indicator</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Display a "scrollbar"
|
||
|
|
on the righthand side of the edit window. It shows the
|
||
|
|
position of the viewport in the buffer and how much of the
|
||
|
|
buffer is covered by the viewport.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-r </b><i>number</i>,
|
||
|
|
<b>--fill=</b><i>number</i></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Set the target width for
|
||
|
|
justifying and automatic hard-wrapping at this <i>number</i>
|
||
|
|
of columns. If the value is 0 or less, wrapping will occur
|
||
|
|
at the width of the screen minus <i>number</i> columns,
|
||
|
|
allowing the wrap point to vary along with the width of the
|
||
|
|
screen if the screen is resized. The default value is
|
||
|
|
<b>-8</b>.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-s "</b><i>program</i>
|
||
|
|
[<i>argument</i> ...]<b>"</b>,
|
||
|
|
<b>--speller="</b><i>program</i> [<i>argument</i>
|
||
|
|
...]<b>"</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Use this command to perform
|
||
|
|
spell checking and correcting, instead of using the built-in
|
||
|
|
corrector that calls <b>hunspell</b>(1) or
|
||
|
|
<b>spell</b>(1).</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-t</b>,
|
||
|
|
<b>--saveonexit</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Save a changed buffer without
|
||
|
|
prompting (when exiting with <b>^X</b>).</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-u</b>, <b>--unix</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">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 <b>--noconvert</b>.)</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-v</b>, <b>--view</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Just view the file and disallow
|
||
|
|
editing: read-only mode. This mode allows the user to open
|
||
|
|
also other files for viewing, unless <b>--restricted</b> is
|
||
|
|
given too.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-w</b>, <b>--nowrap</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Do not automatically hard-wrap
|
||
|
|
the current line when it becomes overlong. This is the
|
||
|
|
default. (This option is the opposite of <b>-b</b>
|
||
|
|
(<b>--breaklonglines</b>) -- the last one given takes
|
||
|
|
effect.)</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-x</b>, <b>--nohelp</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Don’t show the two help
|
||
|
|
lines at the bottom of the screen.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-y</b>,
|
||
|
|
<b>--afterends</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Make Ctrl+Right and Ctrl+Delete
|
||
|
|
stop at word ends instead of beginnings.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-!</b>, <b>--magic</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">When neither the file’s
|
||
|
|
name nor its first line give a clue, try using libmagic to
|
||
|
|
determine the applicable syntax.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-%</b>,
|
||
|
|
<b>--stateflags</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Use the top-right corner of the
|
||
|
|
screen for showing some state flags: <b>I</b> when
|
||
|
|
auto-indenting, <b>M</b> when the mark is on, <b>L</b> when
|
||
|
|
hard-wrapping (breaking long lines), <b>R</b> when recording
|
||
|
|
a macro, and <b>S</b> when soft-wrapping. When the buffer is
|
||
|
|
modified, a star (<b>*</b>) is shown after the filename in
|
||
|
|
the center of the title bar.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-_</b>, <b>--minibar</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Suppress the title bar and
|
||
|
|
instead show information about the current buffer at the
|
||
|
|
bottom of the screen, in the space for the status bar. In
|
||
|
|
this "minibar" the filename is shown on the left,
|
||
|
|
followed by an asterisk if the buffer has been modified. On
|
||
|
|
the right are displayed the current line and column number,
|
||
|
|
the code of the character under the cursor (in Unicode
|
||
|
|
format: U+xxxx), the same flags as are shown by
|
||
|
|
<b>--stateflags</b>, and a percentage that expresses how far
|
||
|
|
the cursor is into the file (linewise). When a file is
|
||
|
|
loaded or saved, and also when switching between buffers,
|
||
|
|
the number of lines in the buffer is displayed after the
|
||
|
|
filename. This number is cleared upon the next keystroke, or
|
||
|
|
replaced with an [i/n] counter when multiple buffers are
|
||
|
|
open. The line plus column numbers and the character code
|
||
|
|
are displayed only when <b>--constantshow</b> is used, and
|
||
|
|
can be toggled on and off with <b>M-C</b>. The state flags
|
||
|
|
are displayed only when <b>--stateflags</b> is used.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%;"><b>-0</b>, <b>--zero</b></p>
|
||
|
|
|
||
|
|
<p style="margin-left:22%;">Hide all elements of the
|
||
|
|
interface (title bar, status bar, and help lines) and use
|
||
|
|
all rows of the terminal for showing the contents of the
|
||
|
|
buffer. The status bar appears only when there is a
|
||
|
|
significant message, and disappears after 1.5 seconds or
|
||
|
|
upon the next keystroke. With <b>M-Z</b> the title bar plus
|
||
|
|
status bar can be toggled. With <b>M-X</b> the help
|
||
|
|
lines.</p>
|
||
|
|
|
||
|
|
<h2>TOGGLES
|
||
|
|
<a name="TOGGLES"></a>
|
||
|
|
</h2>
|
||
|
|
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em">Several of the
|
||
|
|
above options can be switched on and off also while
|
||
|
|
<b>nano</b> is running. For example, <b>M-L</b> toggles the
|
||
|
|
hard-wrapping of long lines, <b>M-S</b> toggles
|
||
|
|
soft-wrapping, <b>M-N</b> toggles line numbers, <b>M-M</b>
|
||
|
|
toggles the mouse, <b>M-I</b> auto-indentation, and
|
||
|
|
<b>M-X</b> the help lines. See at the end of the <b>^G</b>
|
||
|
|
help text for a complete list.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em">The <b>M-X</b>
|
||
|
|
toggle is special: it works in all menus except the help
|
||
|
|
viewer and the linter. All other toggles work in the main
|
||
|
|
menu only.</p>
|
||
|
|
|
||
|
|
<h2>FILES
|
||
|
|
<a name="FILES"></a>
|
||
|
|
</h2>
|
||
|
|
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em">When
|
||
|
|
<b>--rcfile</b> is given, <b>nano</b> will read just the
|
||
|
|
specified file for setting its options and syntaxes and key
|
||
|
|
bindings. Without that option, <b>nano</b> will read two
|
||
|
|
configuration files: first the system’s <i>nanorc</i>
|
||
|
|
(if it exists), and then the user’s <i>nanorc</i> (if
|
||
|
|
it exists), either <i>~/.nanorc</i> or
|
||
|
|
<i>$XDG_CONFIG_HOME/nano/nanorc</i> or
|
||
|
|
<i>~/.config/nano/nanorc</i>, whichever is encountered
|
||
|
|
first. See <b>nanorc</b>(5) for more information on the
|
||
|
|
possible contents of those files.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em">See
|
||
|
|
<i>/usr/share/nano/</i> and <i>/usr/share/nano/extra/</i>
|
||
|
|
for available syntax-coloring definitions.</p>
|
||
|
|
|
||
|
|
<h2>NOTES
|
||
|
|
<a name="NOTES"></a>
|
||
|
|
</h2>
|
||
|
|
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em">Option
|
||
|
|
<b>-z</b> (<b>--suspendable</b>) has been removed.
|
||
|
|
Suspension is enabled by default, reachable via <b>^T^Z</b>.
|
||
|
|
(If you want a plain <b>^Z</b> to suspend nano, add <b>bind
|
||
|
|
^Z suspend main</b> to your nanorc.)</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em">If no
|
||
|
|
alternative spell checker command is specified on the
|
||
|
|
command line nor in one of the <i>nanorc</i> files,
|
||
|
|
<b>nano</b> will check the <b>SPELL</b> environment variable
|
||
|
|
for one.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em">In some cases
|
||
|
|
<b>nano</b> will try to dump the buffer into an emergency
|
||
|
|
file. This will happen mainly if <b>nano</b> receives a
|
||
|
|
SIGHUP or SIGTERM or runs out of memory. It will write the
|
||
|
|
buffer into a file named <i>nano.save</i> if the buffer
|
||
|
|
didn’t have a name already, or will add a
|
||
|
|
".save" suffix to the current filename. If an
|
||
|
|
emergency file with that name already exists in the current
|
||
|
|
directory, it will add ".save" plus a number (e.g.
|
||
|
|
".save.1") to the current filename in order to
|
||
|
|
make it unique. In multibuffer mode, <b>nano</b> will write
|
||
|
|
all the open buffers to their respective emergency
|
||
|
|
files.</p>
|
||
|
|
|
||
|
|
<h2>BUGS
|
||
|
|
<a name="BUGS"></a>
|
||
|
|
</h2>
|
||
|
|
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em">The recording
|
||
|
|
and playback of keyboard macros works correctly only on a
|
||
|
|
terminal emulator, not on a Linux console (VT), because the
|
||
|
|
latter does not by default distinguish modified from
|
||
|
|
unmodified arrow keys.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em">Please report
|
||
|
|
any other bugs that you encounter via: <i><br>
|
||
|
|
https://savannah.gnu.org/bugs/?group=nano</i>.</p>
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em">When nano
|
||
|
|
crashes, it will save any modified buffers to emergency
|
||
|
|
.save files. If you are able to reproduce the crash and you
|
||
|
|
want to get a backtrace, define the environment variable
|
||
|
|
<b>NANO_NOCATCH</b>.</p>
|
||
|
|
|
||
|
|
<h2>HOMEPAGE
|
||
|
|
<a name="HOMEPAGE"></a>
|
||
|
|
</h2>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em"><i>https://nano-editor.org/</i></p>
|
||
|
|
|
||
|
|
<h2>SEE ALSO
|
||
|
|
<a name="SEE ALSO"></a>
|
||
|
|
</h2>
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em"><i><b>nanorc</b></i>(5)</p>
|
||
|
|
|
||
|
|
|
||
|
|
<p style="margin-left:11%; margin-top: 1em"><i>/usr/share/doc/nano/</i>
|
||
|
|
(or equivalent on your system)</p>
|
||
|
|
<hr>
|
||
|
|
</body>
|
||
|
|
</html>
|