| Disable Functions: Path : /usr/share/nano/man-html/ |
| Current File : //usr/share/nano/man-html/nano.1.html |
<!-- Creator : groff version 1.22.2 -->
<!-- CreationDate: Tue Jun 10 04:47:52 2014 -->
<!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="#OPTIONS">OPTIONS</a><br>
<a href="#INITIALIZATION FILE">INITIALIZATION FILE</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>
<a href="#AUTHOR">AUTHOR</a><br>
<hr>
<h2>NAME
<a name="NAME"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">nano −
Nano’s ANOther editor, an enhanced free Pico clone</p>
<h2>SYNOPSIS
<a name="SYNOPSIS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>nano</b>
<i>[OPTIONS] [[+LINE,COLUMN] FILE]...</i></p>
<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">This manual
page briefly documents the <b>nano</b> command.</p>
<p style="margin-left:11%; margin-top: 1em"><b>nano</b> is
a small, free and friendly editor which aims to replace
Pico, the default editor included in the non-free Pine
package. Rather than just copying Pico’s look and
feel, <b>nano</b> also implements some missing (or disabled
by default) features in Pico, such as "search and
replace" and "go to line and column
number".</p>
<h2>OPTIONS
<a name="OPTIONS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>+</b><i>LINE</i><b>,</b><i>COLUMN</i></p>
<p style="margin-left:22%;">Places cursor at line number
<i>LINE</i> and column number <i>COLUMN</i> (at least one of
which must be specified) on startup, instead of the default
of line 1, column 1.</p>
<table width="100%" border="0" rules="none" frame="void"
cellspacing="0" cellpadding="0">
<tr valign="top" align="left">
<td width="11%"></td>
<td width="3%">
<p><b>−?</b></p></td>
<td width="8%"></td>
<td width="30%">
<p>Same as <b>-h (−−help)</b>.</p></td>
<td width="48%">
</td></tr>
</table>
<p style="margin-left:11%;"><b>−A
(−−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
(−−backup)</b></p>
<p style="margin-left:22%;">When saving a file, back up the
previous version of it to the current filename suffixed with
a ~.</p>
<p style="margin-left:11%;"><b>−C</b> <i>dir</i>
<b>(−−backupdir=</b><i>dir</i><b>)</b></p>
<p style="margin-left:22%;">Set the directory where
<b>nano</b> puts unique backup files if file backups are
enabled.</p>
<p style="margin-left:11%;"><b>−D
(−−boldtext)</b></p>
<p style="margin-left:22%;">Use bold text instead of
reverse video text.</p>
<p style="margin-left:11%;"><b>−E
(−−tabstospaces)</b></p>
<p style="margin-left:22%;">Convert typed tabs to
spaces.</p>
<p style="margin-left:11%;"><b>−F
(−−multibuffer)</b></p>
<p style="margin-left:22%;">Enable multiple file buffers,
if available.</p>
<p style="margin-left:11%;"><b>−H
(−−historylog)</b></p>
<p style="margin-left:22%;">Log search and replace strings
to <i>~/.nano_history</i>, so they can be retrieved in later
sessions, if <i>nanorc</i> support is available.</p>
<p style="margin-left:11%;"><b>−I
(−−ignorercfiles)</b></p>
<p style="margin-left:22%;">Don’t look at
<i>SYSCONFDIR/nanorc</i> or <i>~/.nanorc</i>, if
<i>nanorc</i> support is available.</p>
<p style="margin-left:11%;"><b>−K
(−−rebindkeypad)</b></p>
<p style="margin-left:22%;">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.</p>
<p style="margin-left:11%;"><b>−L
(−−nonewlines)</b></p>
<p style="margin-left:22%;">Don’t add newlines to the
ends of files.</p>
<p style="margin-left:11%;"><b>−N
(−−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
(−−morespace)</b></p>
<p style="margin-left:22%;">Use the blank line below the
titlebar as extra editing space.</p>
<p style="margin-left:11%;"><b>−P
(−−poslog)</b></p>
<p style="margin-left:22%;">Log & read location of
cursor position.</p>
<p style="margin-left:11%;"><b>−Q</b> <i>str</i>
<b>(−−quotestr=</b><i>str</i><b>)</b></p>
<p style="margin-left:22%;">Set the quoting string for
justifying. The default is
"<i>^([ \t]*[#:>\|}])+</i>" if extended
regular expression support is available, or
"<i>> </i>" otherwise. Note that <i>\t</i>
stands for a Tab.</p>
<p style="margin-left:11%;"><b>−R
(−−restricted)</b></p>
<p style="margin-left:22%;">Restricted mode: don’t
read or write to any file not specified on the command line;
read any <i>nanorc</i> files; allow suspending; allow a file
to be appended to, prepended to, or saved under a different
name if it already has one; or use backup files or spell
checking. Also accessible by invoking <b>nano</b> with any
name beginning with ’r’ (e.g.
"rnano").</p>
<p style="margin-left:11%;"><b>−S
(−−smooth)</b></p>
<p style="margin-left:22%;">Enable smooth scrolling. Text
will scroll line-by-line, instead of the usual
chunk-by-chunk behavior.</p>
<p style="margin-left:11%;"><b>−T</b> <i>cols</i>
<b>(−−tabsize=</b><i>cols</i><b>)</b></p>
<p style="margin-left:22%;">Set the size (width) of a tab
to <i>cols</i> columns. The value of <i>cols</i> must be
greater than 0. The default value is 8.</p>
<p style="margin-left:11%;"><b>−U
(−−quickblank)</b></p>
<p style="margin-left:22%;">Do quick statusbar blanking.
Statusbar messages will disappear after 1 keystroke instead
of 25. Note that <b>-c</b> overrides this.</p>
<p style="margin-left:11%;"><b>−V
(−−version)</b></p>
<p style="margin-left:22%;">Show the current version number
and exit.</p>
<p style="margin-left:11%;"><b>−W
(−−wordbounds)</b></p>
<p style="margin-left:22%;">Detect word boundaries more
accurately by treating punctuation characters as part of a
word.</p>
<p style="margin-left:11%;"><b>−Y</b> <i>str</i>
<b>(−−syntax=</b><i>str</i><b>)</b></p>
<p style="margin-left:22%;">Specify a specific syntax
highlighting from the <i>nanorc</i> to use, if
available.</p>
<p style="margin-left:11%;"><b>−c
(−−const)</b></p>
<p style="margin-left:22%;">Constantly show the cursor
position. Note that this overrides <b>-U</b>.</p>
<p style="margin-left:11%;"><b>−d
(−−rebinddelete)</b></p>
<p style="margin-left:22%;">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.</p>
<p style="margin-left:11%;"><b>−h
(−−help)</b></p>
<p style="margin-left:22%;">Show a summary of command line
options and exit.</p>
<p style="margin-left:11%;"><b>−i
(−−autoindent)</b></p>
<p style="margin-left:22%;">Indent new lines to the
previous line’s indentation. Useful when editing
source code.</p>
<p style="margin-left:11%;"><b>−k
(−−cut)</b></p>
<p style="margin-left:22%;">Enable cut from cursor to end
of line.</p>
<p style="margin-left:11%;"><b>−l
(−−nofollow)</b></p>
<p style="margin-left:22%;">If the file being edited is a
symbolic link, replace the link with a new file instead of
following it. Good for editing files in <i>/tmp</i>,
perhaps?</p>
<p style="margin-left:11%;"><b>−m
(−−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.</p>
<p style="margin-left:11%;"><b>−o</b> <i>dir</i>
<b>(−−operatingdir=</b><i>dir</i><b>)</b></p>
<p style="margin-left:22%;">Set operating directory. Makes
<b>nano</b> set up something similar to a chroot.</p>
<p style="margin-left:11%;"><b>−p
(−−preserve)</b></p>
<p style="margin-left:22%;">Preserve the XON and XOFF
sequences (^Q and ^S) so they will be caught by the
terminal.</p>
<p style="margin-left:11%;"><b>−q
(−−quiet)</b></p>
<p style="margin-left:22%;">Do not report errors in the
<i>nanorc</i> file and ask them to be acknowledged by
pressing Enter at startup.</p>
<p style="margin-left:11%;"><b>−r</b> <i>cols</i>
<b>(−−fill=</b><i>cols</i><b>)</b></p>
<p style="margin-left:22%;">Wrap lines at column
<i>cols</i>. If this value is 0 or less, wrapping will occur
at the width of the screen less <i>cols</i> columns,
allowing the wrap point to vary along with the width of the
screen if the screen is resized. The default value is
−8.</p>
<p style="margin-left:11%;"><b>−s</b> <i>prog</i>
<b>(−−speller=</b><i>prog</i><b>)</b></p>
<p style="margin-left:22%;">Enable alternative spell
checker command.</p>
<p style="margin-left:11%;"><b>−t
(−−tempfile)</b></p>
<p style="margin-left:22%;">Always save changed buffer
without prompting. Same as Pico’s <b>-t</b>
option.</p>
<p style="margin-left:11%;"><b>−u
(−−undo)</b></p>
<p style="margin-left:22%;">Enable experimental
generic-purpose undo code. By default, the undo and redo
shortcuts are Meta-U and Meta-E, respectively.</p>
<p style="margin-left:11%;"><b>−v
(−−view)</b></p>
<p style="margin-left:22%;">View file (read only) mode.</p>
<p style="margin-left:11%;"><b>−w
(−−nowrap)</b></p>
<p style="margin-left:22%;">Disable wrapping of long
lines.</p>
<p style="margin-left:11%;"><b>−x
(−−nohelp)</b></p>
<p style="margin-left:22%;">Disable help screen at bottom
of editor.</p>
<p style="margin-left:11%;"><b>−z
(−−suspend)</b></p>
<p style="margin-left:22%;">Enable suspend ability.</p>
<p style="margin-left:11%;"><b>−$
(−−softwrap)</b></p>
<p style="margin-left:22%;">Enable ’soft
wrapping’. <b>nano</b> will attempt to display the
entire contents of a line, even if it is longer than the
screen width. Since ’$’ normally refers to a
variable in the Unix shell, you should specify this option
last when using other options (e.g. ’nano
−wS$’) or pass it separately (e.g. ’nano
−wS −$’).</p>
<p style="margin-left:11%;"><b>−a, −b,
−e, −f, −g, −j</b></p>
<p style="margin-left:22%;">Ignored, for compatibility with
Pico.</p>
<h2>INITIALIZATION FILE
<a name="INITIALIZATION FILE"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>nano</b>
will read initialization files in the following order:
<i>SYSCONFDIR/nanorc</i>, then <i>~/.nanorc</i>. Please see
<b>nanorc(5)</b> and the example file <b>nanorc.sample</b>,
both of which should be provided with <b>nano</b>.</p>
<h2>NOTES
<a name="NOTES"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">If no
alternative spell checker command is specified on the
command line or 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">Please send any
comments or bug reports to <b>nano@nano-editor.org</b>.</p>
<p style="margin-left:11%; margin-top: 1em">The <b>nano</b>
mailing list is available from
<b>nano-devel@gnu.org</b>.</p>
<p style="margin-left:11%; margin-top: 1em">To subscribe,
email to <b>nano-devel-request@gnu.org</b> with a subject of
"subscribe".</p>
<h2>HOMEPAGE
<a name="HOMEPAGE"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">http://www.nano-editor.org/</p>
<h2>SEE ALSO
<a name="SEE ALSO"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>nanorc</b>(5)
<i><br>
/usr/share/doc/nano/</i> (or equivalent on your system)</p>
<h2>AUTHOR
<a name="AUTHOR"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Chris
Allegretta <chrisa@asty.org>, et al (see
<i>AUTHORS</i> and <i>THANKS</i> for details). This manual
page was originally written by Jordi Mallach
<jordi@gnu.org>, for the Debian system (but may be
used by others).</p>
<hr>
</body>
</html>