2000-12-03 02:46:02 +00:00
|
|
|
.\" Hey, EMACS: -*- nroff -*-
|
2003-02-09 01:28:40 +00:00
|
|
|
.\" nano.1 is copyright (C) 1999, 2000, 2001, 2002, 2003 by
|
2000-12-03 02:46:02 +00:00
|
|
|
.\" Chris Allegretta <chrisa@asty.org>
|
|
|
|
.\"
|
|
|
|
.\" This is free documentation, see the latest version of the GNU General
|
|
|
|
.\" Public License for copying conditions. There is NO warranty.
|
|
|
|
.\"
|
2001-10-03 12:45:22 +00:00
|
|
|
.\" $Id$
|
2003-02-09 01:28:40 +00:00
|
|
|
.TH NANO 1 "February 9, 2003"
|
2000-06-06 05:53:49 +00:00
|
|
|
.\" Please adjust this date whenever revising the manpage.
|
|
|
|
.\"
|
2003-02-09 01:28:40 +00:00
|
|
|
|
2000-06-06 05:53:49 +00:00
|
|
|
.SH NAME
|
2003-01-17 03:06:28 +00:00
|
|
|
nano \- Nano's ANOther editor, an enhanced free Pico clone
|
2003-02-09 01:28:40 +00:00
|
|
|
|
2000-06-06 05:53:49 +00:00
|
|
|
.SH SYNOPSIS
|
|
|
|
.B nano
|
2002-07-19 01:08:59 +00:00
|
|
|
.I [\+LINE]\ [options]\ [file]
|
2000-06-06 05:53:49 +00:00
|
|
|
.br
|
2003-02-09 01:28:40 +00:00
|
|
|
|
2000-06-06 05:53:49 +00:00
|
|
|
.SH DESCRIPTION
|
2002-07-19 01:08:59 +00:00
|
|
|
This manual page documents briefly the \fBnano\fP command.
|
2000-06-06 05:53:49 +00:00
|
|
|
.PP
|
|
|
|
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
|
2001-05-05 17:45:54 +00:00
|
|
|
.\" \fI<whatever>\fP escape sequences to invoke bold face and italics,
|
2000-06-06 05:53:49 +00:00
|
|
|
.\" respectively.
|
2000-12-03 02:46:02 +00:00
|
|
|
\fBnano\fP is a small, free and friendly editor which aims to replace
|
|
|
|
Pico, the default editor included in the non-free Pine package. Rather
|
2002-07-19 01:08:59 +00:00
|
|
|
than just copying Pico's look and feel, \fBnano\fP also implements some
|
|
|
|
missing (or disabled by default) features in Pico, such as "search and
|
|
|
|
replace" and "go to line number".
|
2003-02-09 01:28:40 +00:00
|
|
|
|
2000-06-06 05:53:49 +00:00
|
|
|
.SH OPTIONS
|
|
|
|
.TP
|
2002-07-19 01:08:59 +00:00
|
|
|
.B \+\fILINE\fP
|
|
|
|
Places cursor at \fILINE\fP on startup.
|
|
|
|
.TP
|
2002-06-28 22:45:14 +00:00
|
|
|
.B \-B (\-\-backup)
|
|
|
|
When saving a file, back up the previous version of it to the current
|
|
|
|
filename suffixed with a ~.
|
|
|
|
.TP
|
2001-10-03 12:45:22 +00:00
|
|
|
.B \-D (\-\-dos)
|
|
|
|
Write file in DOS format.
|
|
|
|
.TP
|
2001-07-15 16:07:23 +00:00
|
|
|
.B \-F (\-\-multibuffer)
|
2002-06-28 22:45:14 +00:00
|
|
|
Enable multiple file buffers, if available.
|
2001-07-15 16:07:23 +00:00
|
|
|
.TP
|
2003-01-17 03:06:28 +00:00
|
|
|
.B \-H (\-\-historylog)
|
2003-06-11 10:17:20 +00:00
|
|
|
Log search and replace strings to
|
|
|
|
.I~/.nano_history
|
|
|
|
so they may be stored for later editing, if nanorc support is
|
|
|
|
configured.
|
2003-01-17 03:06:28 +00:00
|
|
|
.TP
|
2002-07-20 13:57:41 +00:00
|
|
|
.B \-I (\-\-ignorercfiles)
|
2003-06-11 10:17:20 +00:00
|
|
|
Don't look at
|
|
|
|
.I $SYSCONFDIR/nanorc
|
|
|
|
or
|
|
|
|
.IR ~/.nanorc ,
|
|
|
|
if nanorc support is available.
|
2002-07-20 13:57:41 +00:00
|
|
|
.TP
|
2002-01-03 21:26:34 +00:00
|
|
|
.B \-K (\-\-keypad)
|
2002-11-04 16:05:42 +00:00
|
|
|
Do not use the ncurses keypad() call unless necessary. Try this flag if
|
|
|
|
you find that the arrow keys on the numeric keypad do not work for you
|
2002-01-03 21:26:34 +00:00
|
|
|
under nano.
|
|
|
|
.TP
|
2001-10-03 12:45:22 +00:00
|
|
|
.B \-M (\-\-mac)
|
|
|
|
Write file in Mac format.
|
2000-06-21 03:00:43 +00:00
|
|
|
.TP
|
2002-02-22 04:30:50 +00:00
|
|
|
.B \-N (\-\-noconvert)
|
|
|
|
Disable automatic conversion of files from DOS/Mac format.
|
|
|
|
.TP
|
2003-02-04 14:24:54 +00:00
|
|
|
.B \-Q \fIstr\fP (\-\-quotestr=\fIstr\fP)
|
2002-08-21 16:10:37 +00:00
|
|
|
Set the quoting string for justifying. The default is
|
2003-06-11 10:17:20 +00:00
|
|
|
"^([\ \\t]*[|>:}#])+" if regular expression support is available, or
|
|
|
|
">\ " otherwise.
|
2002-03-04 12:15:44 +00:00
|
|
|
.TP
|
2000-07-07 01:49:52 +00:00
|
|
|
.B \-R (\-\-regexp)
|
|
|
|
Enable regular expression matching for search strings, as well as
|
2000-07-07 04:20:09 +00:00
|
|
|
\\n subexpression replacement for replace strings, if available.
|
2000-07-07 01:49:52 +00:00
|
|
|
.TP
|
2001-10-03 12:45:22 +00:00
|
|
|
.B \-S (\-\-smooth)
|
|
|
|
Enable smooth scrolling. Text will scroll line-by-line, instead of the
|
2002-07-19 01:08:59 +00:00
|
|
|
usual chunk-by-chunk behavior.
|
2001-10-03 12:45:22 +00:00
|
|
|
.TP
|
2003-02-04 14:24:54 +00:00
|
|
|
.B \-T \fInum\fP (\-\-tabsize=\fInum\fP)
|
2001-10-03 12:45:22 +00:00
|
|
|
Set the size (width) of a tab.
|
|
|
|
.TP
|
2000-06-06 05:53:49 +00:00
|
|
|
.B \-V (\-\-version)
|
|
|
|
Show the current version number and author.
|
|
|
|
.TP
|
2003-02-04 14:24:54 +00:00
|
|
|
.B \-Y \fIstr\fP (\-\-syntax=\fIstr\fP)
|
2003-06-11 10:17:20 +00:00
|
|
|
Specify a specific syntax highlighting from the
|
|
|
|
.I .nanorc
|
|
|
|
to use, if available.
|
2002-05-04 04:23:30 +00:00
|
|
|
.TP
|
2000-06-06 05:53:49 +00:00
|
|
|
.B \-c (\-\-const)
|
|
|
|
Constantly show the cursor position.
|
|
|
|
.TP
|
2001-10-03 12:45:22 +00:00
|
|
|
.B \-h (\-\-help)
|
|
|
|
Display a summary of command line options.
|
|
|
|
.TP
|
2000-06-06 05:53:49 +00:00
|
|
|
.B \-i (\-\-autoindent)
|
|
|
|
Indent new lines to the previous line's indentation. Useful when editing
|
|
|
|
source code.
|
|
|
|
.TP
|
2001-04-30 10:30:43 +00:00
|
|
|
.B \-k (\-\-cut)
|
|
|
|
Enable cut from cursor to end of line with ^K.
|
|
|
|
.TP
|
2000-06-06 05:53:49 +00:00
|
|
|
.B \-l (\-\-nofollow)
|
2002-04-06 05:02:14 +00:00
|
|
|
If the file being edited is a symbolic link, replace the link with
|
2003-06-11 10:17:20 +00:00
|
|
|
a new file, do not follow it. Good for editing files in
|
|
|
|
.IR /tmp ,
|
|
|
|
perhaps?
|
2000-06-06 05:53:49 +00:00
|
|
|
.TP
|
|
|
|
.B \-m (\-\-mouse)
|
|
|
|
Enable mouse support (if available for your system).
|
|
|
|
.TP
|
2003-02-04 14:24:54 +00:00
|
|
|
.B \-o \fIdir\fP (\-\-operatingdir=\fIdir\fP)
|
2002-06-28 22:45:14 +00:00
|
|
|
Set operating directory. Makes nano set up something similar to a
|
|
|
|
chroot.
|
2001-10-03 12:45:22 +00:00
|
|
|
.TP
|
2003-01-17 03:06:28 +00:00
|
|
|
.B \-p (\-\-preserve)
|
|
|
|
Preserve the XON and XOFF sequences (^Q and ^S) so they will be
|
|
|
|
caught by the terminal.
|
2000-06-06 05:53:49 +00:00
|
|
|
.TP
|
2003-02-04 14:24:54 +00:00
|
|
|
.B \-r \fIcols\fP (\-\-fill=\fIcols\fP)
|
|
|
|
Wrap lines at column \fIcols\fP. By default, this is the width of the
|
2002-06-28 22:45:14 +00:00
|
|
|
screen, less eight. If this value is negative, wrapping will occur at
|
2003-02-04 14:24:54 +00:00
|
|
|
\fIcols\fP columns from the right of the screen, allowing the wrap point
|
|
|
|
to vary along with the screen width if resized.
|
2001-04-30 10:30:43 +00:00
|
|
|
.TP
|
2003-02-04 14:24:54 +00:00
|
|
|
.B \-s \fIprog\fP (\-\-speller=\fIprog\fP)
|
2000-06-06 05:53:49 +00:00
|
|
|
Enable alternative spell checker command.
|
|
|
|
.TP
|
|
|
|
.B \-t (\-\-tempfile)
|
2001-05-05 17:45:54 +00:00
|
|
|
Always save changed buffer without prompting. Same as Pico -t option.
|
2000-06-06 05:53:49 +00:00
|
|
|
.TP
|
|
|
|
.B \-v (\-\-view)
|
|
|
|
View file (read only) mode.
|
|
|
|
.TP
|
|
|
|
.B \-w (\-\-nowrap)
|
|
|
|
Disable wrapping of long lines.
|
|
|
|
.TP
|
|
|
|
.B \-x (\-\-nohelp)
|
|
|
|
Disable help screen at bottom of editor.
|
|
|
|
.TP
|
|
|
|
.B \-z (\-\-suspend)
|
|
|
|
Enable suspend ability.
|
|
|
|
.TP
|
2001-10-03 15:53:25 +00:00
|
|
|
.B \-a, \-b, \-e, \-f, \-g, \-j
|
2000-12-18 02:23:50 +00:00
|
|
|
Ignored, for compatibility with Pico.
|
2003-02-09 01:28:40 +00:00
|
|
|
|
2003-02-04 14:24:54 +00:00
|
|
|
.SH INITIALIZATION FILE
|
|
|
|
\fBnano\fP will read initialization files in the following
|
2003-06-11 10:17:20 +00:00
|
|
|
order:
|
|
|
|
.IR $SYSCONFDIR/nanorc ,
|
|
|
|
then
|
|
|
|
.IR ~/.nanorc .
|
|
|
|
Please see
|
|
|
|
.BR nanorc (5)
|
|
|
|
and the example file \fBnanorc.sample\fP which should be provided with
|
2003-02-13 04:01:49 +00:00
|
|
|
\fBnano\fP.
|
2003-02-09 01:28:40 +00:00
|
|
|
|
2000-12-03 02:46:02 +00:00
|
|
|
.SH NOTES
|
2002-07-19 01:08:59 +00:00
|
|
|
\fBnano\fP will try to dump the buffer into an emergency file in some
|
2002-10-17 02:19:31 +00:00
|
|
|
cases. Mainly, this will happen if \fBnano\fP receives a SIGHUP or
|
|
|
|
SIGTERM or runs out of memory, when it will write the buffer into a file
|
2003-06-11 10:17:20 +00:00
|
|
|
named
|
|
|
|
.I nano.save
|
|
|
|
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, ".save" and a number (e.g. ".save.1")
|
|
|
|
will be suffixed to the current filename in order to make it unique. In
|
|
|
|
multibuffer mode, \fBnano\fP will write all the open buffers to the
|
|
|
|
respective emergency files.
|
2003-02-09 01:28:40 +00:00
|
|
|
|
2000-06-06 05:53:49 +00:00
|
|
|
.SH BUGS
|
|
|
|
Please send any comments or bug reports to
|
2003-06-11 10:17:20 +00:00
|
|
|
.BR nano@nano-editor.org .
|
|
|
|
|
2002-07-19 01:08:59 +00:00
|
|
|
The \fBnano\fP mailing list is available from
|
2003-06-11 10:17:20 +00:00
|
|
|
.BR nano-devel@gnu.org .
|
|
|
|
|
|
|
|
To subscribe, email to
|
|
|
|
.B nano-devel-request@gnu.org
|
|
|
|
with a subject of "subscribe".
|
2003-02-09 01:28:40 +00:00
|
|
|
|
2000-06-06 05:53:49 +00:00
|
|
|
.SH HOMEPAGE
|
2003-02-09 01:28:40 +00:00
|
|
|
http://www.nano-editor.org/
|
|
|
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
.PD 0
|
|
|
|
.TP
|
|
|
|
\fBnanorc\fP(5)
|
|
|
|
.PP
|
|
|
|
\fI/usr/share/doc/nano/\fP (or equivalent on your system)
|
|
|
|
|
2000-06-06 05:53:49 +00:00
|
|
|
.SH AUTHOR
|
2003-06-11 10:17:20 +00:00
|
|
|
Chris Allegretta <chrisa@asty.org>, et al (see
|
|
|
|
.I AUTHORS
|
|
|
|
and
|
|
|
|
.I THANKS
|
|
|
|
for details). This manual page was originally written by Jordi Mallach
|
2002-04-30 02:33:14 +00:00
|
|
|
<jordi@sindominio.net>, for the Debian GNU system (but may be
|
2000-12-03 02:46:02 +00:00
|
|
|
used by others).
|