300 lines
8.5 KiB
HTML
300 lines
8.5 KiB
HTML
Content-type: text/html
|
|
|
|
<HTML><HEAD><TITLE>Manpage of NANO</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>NANO</H1>
|
|
Section: User Commands (1)<BR>Updated: November 1, 2002<BR><A HREF="#index">Index</A>
|
|
<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
nano - Nano's ANOther editor, an enhanced free Pico clone
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>nano</B>
|
|
|
|
<I>[+LINE] [options] [file]</I>
|
|
|
|
<BR>
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
This manual page documents briefly the <B>nano</B> command.
|
|
<P>
|
|
|
|
|
|
|
|
|
|
<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 number".
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT><B>+</B><I>LINE</I>
|
|
|
|
<DD>
|
|
Places cursor at <I>LINE</I> on startup.
|
|
<DT><B>-B (--backup)</B>
|
|
|
|
<DD>
|
|
When saving a file, back up the previous version of it to the current
|
|
filename suffixed with a ~.
|
|
<DT><B>-D (--dos)</B>
|
|
|
|
<DD>
|
|
Write file in DOS format.
|
|
<DT><B>-F (--multibuffer)</B>
|
|
|
|
<DD>
|
|
Enable multiple file buffers, if available.
|
|
<DT><B>-H (--historylog)</B>
|
|
|
|
<DD>
|
|
Log search and replace strings to ~/.nano_history so they may be
|
|
stored for later editing, if nanorc support is configured.
|
|
<DT><B>-I (--ignorercfiles)</B>
|
|
|
|
<DD>
|
|
Don't look at $SYSCONFDIR/nanorc or ~/.nanorc, if nanorc support is
|
|
available.
|
|
<DT><B>-K (--keypad)</B>
|
|
|
|
<DD>
|
|
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
|
|
under nano.
|
|
<DT><B>-M (--mac)</B>
|
|
|
|
<DD>
|
|
Write file in Mac format.
|
|
<DT><B>-N (--noconvert)</B>
|
|
|
|
<DD>
|
|
Disable automatic conversion of files from DOS/Mac format.
|
|
<DT><B>-Q </B><I>str</I> (--quotestr=<I>str</I>)
|
|
|
|
<DD>
|
|
Set the quoting string for justifying. The default is
|
|
"^([ \t]*[|>:}#])+" if regular expression support is available, or
|
|
"> " otherwise.
|
|
<DT><B>-R (--regexp)</B>
|
|
|
|
<DD>
|
|
Enable regular expression matching for search strings, as well as
|
|
\n subexpression replacement for replace strings, if available.
|
|
<DT><B>-S (--smooth)</B>
|
|
|
|
<DD>
|
|
Enable smooth scrolling. Text will scroll line-by-line, instead of the
|
|
usual chunk-by-chunk behavior.
|
|
<DT><B>-T </B><I>num</I> (--tabsize=<I>num</I>)
|
|
|
|
<DD>
|
|
Set the size (width) of a tab.
|
|
<DT><B>-V (--version)</B>
|
|
|
|
<DD>
|
|
Show the current version number and author.
|
|
<DT><B>-Y </B><I>str</I> (--syntax=<I>str</I>)
|
|
|
|
<DD>
|
|
Specify a specific syntax highlighting from the .nanorc to use, if
|
|
available.
|
|
<DT><B>-c (--const)</B>
|
|
|
|
<DD>
|
|
Constantly show the cursor position.
|
|
<DT><B>-h (--help)</B>
|
|
|
|
<DD>
|
|
Display a summary of command line options.
|
|
<DT><B>-i (--autoindent)</B>
|
|
|
|
<DD>
|
|
Indent new lines to the previous line's indentation. Useful when editing
|
|
source code.
|
|
<DT><B>-k (--cut)</B>
|
|
|
|
<DD>
|
|
Enable cut from cursor to end of line with ^K.
|
|
<DT><B>-l (--nofollow)</B>
|
|
|
|
<DD>
|
|
If the file being edited is a symbolic link, replace the link with
|
|
a new file, do not follow it. Good for editing files in /tmp, perhaps?
|
|
<DT><B>-m (--mouse)</B>
|
|
|
|
<DD>
|
|
Enable mouse support (if available for your system).
|
|
<DT><B>-o </B><I>dir</I> (--operatingdir=<I>dir</I>)
|
|
|
|
<DD>
|
|
Set operating directory. Makes nano set up something similar to a
|
|
chroot.
|
|
<DT><B>-p (--preserve)</B>
|
|
|
|
<DD>
|
|
Preserve the XON and XOFF sequences (^Q and ^S) so they will be
|
|
caught by the terminal.
|
|
<DT><B>-r </B><I>cols</I> (--fill=<I>cols</I>)
|
|
|
|
<DD>
|
|
Wrap lines at column <I>cols</I>. By default, this is the width of the
|
|
screen, less eight. If this value is negative, wrapping will occur at
|
|
<I>cols</I> columns from the right of the screen, allowing the wrap point
|
|
to vary along with the screen width if resized.
|
|
<DT><B>-s </B><I>prog</I> (--speller=<I>prog</I>)
|
|
|
|
<DD>
|
|
Enable alternative spell checker command.
|
|
<DT><B>-t (--tempfile)</B>
|
|
|
|
<DD>
|
|
Always save changed buffer without prompting. Same as Pico -t option.
|
|
<DT><B>-v (--view)</B>
|
|
|
|
<DD>
|
|
View file (read only) mode.
|
|
<DT><B>-w (--nowrap)</B>
|
|
|
|
<DD>
|
|
Disable wrapping of long lines.
|
|
<DT><B>-x (--nohelp)</B>
|
|
|
|
<DD>
|
|
Disable help screen at bottom of editor.
|
|
<DT><B>-z (--suspend)</B>
|
|
|
|
<DD>
|
|
Enable suspend ability.
|
|
<DT><B>-a, -b, -e, -f, -g, -j</B>
|
|
|
|
<DD>
|
|
Ignored, for compatibility with Pico.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>INITIALIZATION FILE</H2>
|
|
|
|
<B>nano</B> will read initialization files in the following
|
|
order: $SYSCONFDIR/nanorc, then ~/.nanorc. Please see the example
|
|
file <B>nanorc.sample</B> which should be provided with <B>nano</B>.
|
|
All lines beginning with a hash symbol (
|
|
#
|
|
) are considered comments
|
|
and will be ignored. The following commands are understood in the
|
|
initialization file:
|
|
<DL COMPACT>
|
|
<DT><B>[un]set </B><I>option</I> [<I>value</I>]
|
|
|
|
<DD>
|
|
Set (or unset) the flag <I>option</I>. Any long option listed above can
|
|
be set or unset by removing the leading dashes (e.g. "set nowrap"). If
|
|
the option takes an argument it will be set to <I>value</I>.
|
|
</DL>
|
|
<P>
|
|
|
|
<B>COLOR SYNTAX HIGHLIGHTING</B> (if supported by your curses library)
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT><B>syntax </B><I>str</I> [<I>fileregex</I> ... ]
|
|
|
|
<DD>
|
|
Defines a syntax named <I>str</I> which can be activated via the
|
|
<B>-Y</B> flag, or will be automatically activated if the current
|
|
filename matches <I>fileregex</I>. All following <B>color</B> statements
|
|
will apply to <I>syntax</I> until a new syntax is defined.
|
|
<DT><B>color </B><I>fgcolor</I>[,<I>bgcolor</I>] <I>regex</I> ...
|
|
|
|
<DD>
|
|
For the currently defined syntax, display all expressions matching
|
|
<I>regex</I> with foreground color <I>fgcolor</I> and optional background
|
|
color <I>bgcolor</I>. Legal colors for foreground and background color are:
|
|
white, black, red, blue, green, yellow, magenta, and cyan. You may use
|
|
the prefix "bright" to force a stronger color highlight. If your
|
|
terminal supports transparency, not specifying a <I>bgcolor</I> tells
|
|
<B>nano</B> to attempt to use a transparent background.
|
|
<DT><B>color </B><I>fgcolor</I>[,<I>bgcolor</I>] start=<I>sr</I> end=<I>er</I>
|
|
|
|
<DD>
|
|
Display expressions which start with <I>sr</I> and end with <I>er</I>
|
|
with foreground color <I>fgcolor</I> and optional
|
|
background color <I>bgcolor</I>. This allows syntax highlighting to span
|
|
multiple lines. Note that all subsequent instances of <I>sr</I> after
|
|
an initial <I>sr</I> is found will be highlighted until the first
|
|
instance of <I>er</I>.
|
|
<I>
|
|
</DL>
|
|
</I><A NAME="lbAG"> </A>
|
|
<H2>NOTES</H2>
|
|
|
|
<B>nano</B> will try to dump the buffer into an emergency file in some
|
|
cases. Mainly, this will happen if <B>nano</B> receives a SIGHUP or
|
|
SIGTERM or runs out of memory, when it will write the buffer into a file
|
|
named "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, <B>nano</B> will write all the open buffers
|
|
to the respective emergency files.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
Please send any comments or bug reports to
|
|
<BR>
|
|
|
|
<B><A HREF="mailto:nano@nano-editor.org">nano@nano-editor.org</A>.</B>
|
|
|
|
<BR>
|
|
|
|
The <B>nano</B> mailing list is available from
|
|
<BR>
|
|
|
|
<B><A HREF="mailto:nano-devel@gnu.org">nano-devel@gnu.org</A>.</B>
|
|
|
|
To subscribe, email to <A HREF="mailto:nano-devel-request@gnu.org">nano-devel-request@gnu.org</A> with a
|
|
subject of "subscribe".
|
|
<A NAME="lbAI"> </A>
|
|
<H2>HOMEPAGE</H2>
|
|
|
|
<A HREF="http://www.nano-editor.org">http://www.nano-editor.org</A>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Chris Allegretta <<A HREF="mailto:chrisa@asty.org">chrisa@asty.org</A>>, et al (see AUTHORS and THANKS for
|
|
details).
|
|
This manual page was originally written by Jordi Mallach
|
|
<<A HREF="mailto:jordi@sindominio.net">jordi@sindominio.net</A>>, for the Debian GNU system (but may be
|
|
used by others).
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT><A HREF="#lbAB">NAME</A><DD>
|
|
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT><A HREF="#lbAF">INITIALIZATION FILE</A><DD>
|
|
<DT><A HREF="#lbAG">NOTES</A><DD>
|
|
<DT><A HREF="#lbAH">BUGS</A><DD>
|
|
<DT><A HREF="#lbAI">HOMEPAGE</A><DD>
|
|
<DT><A HREF="#lbAJ">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 14:15:34 GMT, February 04, 2003
|
|
</BODY>
|
|
</HTML>
|