| 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> |