| <HTML><HEAD><TITLE>Manpage of NANORC</TITLE> |
| </HEAD><BODY> |
| <H1>NANORC</H1> |
| Section: File Formats (5)<BR>Updated: June 19, 2003<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> |
| |
| nanorc - GNU nano's rcfile |
| <A NAME="lbAC"> </A> |
| <H2>DESCRIPTION</H2> |
| |
| This manual page documents GNU <B>nano</B>'s rcfile. |
| <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". |
| <P> |
| |
| The <I>nanorc</I> file contains the default settings for <B>nano</B>. |
| During startup, <B>nano</B> will first read its system-wide settings from |
| <I>$SYSCONFDIR/nanorc</I>, |
| |
| and then user-specific settings from |
| <I>~/.nanorc</I>. |
| |
| <P> |
| <A NAME="lbAD"> </A> |
| <H2>OPTIONS</H2> |
| |
| The configuration file accepts a series of "set" and "unset" commands, |
| which can be used to configure nano on startup without using the |
| command-line options. Additionally, the "syntax" and "color" keywords |
| are used to define syntax highlighting rules for different text patterns. |
| GNU nano will read one command per line. |
| <P> |
| Options in rcfiles take precedence over nano's defaults, and command line |
| options override rcfile settings. |
| <P> |
| Options are unset by default, except for options that take an argument. |
| <P> |
| The supported commands and arguments are: |
| <P> |
| <DL COMPACT> |
| <DT><B>set/unset autoindent</B><DD> |
| Use auto-indentation. |
| <DT><B>set/unset backup</B><DD> |
| Create backup files in |
| <I>filename~</I>. |
| |
| <DT><B>set/unset const</B><DD> |
| Constantly display the cursor position in the status bar. |
| <DT><B>set/unset cut</B><DD> |
| Use cut to end of line with ^K by default. |
| <DT><B>set fill </B><I>n</I><DD> |
| Wrap lines at column number <I>n</I>. If <I>n</I> is 0 or less, the line |
| length will be the screen width less <I>n</I>. The default value is -8. |
| <DT><B>set/unset historylog</B><DD> |
| Enable |
| <I>~/.nano_history</I> |
| |
| for saving and reading search/replace strings. |
| <DT><B>set/unset keypad</B><DD> |
| Use alternate keypad routines. |
| <DT><B>set/unset multibuffer</B><DD> |
| Allow inserting files into their own buffers. |
| <DT><B>set/unset noconvert</B><DD> |
| Don't convert files from DOS/Mac format. |
| <DT><B>set/unset nofollow</B><DD> |
| Don't follow symlinks when writing files. |
| <DT><B>set/unset nohelp</B><DD> |
| Don't display the help lists at the bottom of the screen. |
| <DT><B>set/unset nowrap</B><DD> |
| Don't wrap text at all. |
| <DT><B>set operatingdir "</B><I>directory</I>"<DD> |
| <B>nano</B> will only read and write files inside <I>directory</I> and its |
| subdirectories. Also, the current directory is changed to here, so files |
| are inserted from this dir. By default the operating directory feature is |
| turned off. |
| <DT><B>set/unset preserve</B><DD> |
| Preserve the XON and XOFF keys (^Q and ^S). |
| <DT><B>set quotestr "</B><I>string</I>"<DD> |
| The email-quote string, used to justify email-quoted paragraphs. This is |
| an "extended regular expression" if your system supports them, otherwise a |
| literal string. The default value is |
| <P> |
| <TT> </TT>set quotestr "^([ \t]*[|>:}#])+"<BR> |
| <P> |
| if you have regexps, otherwise set quotestr "> ". Note that '\t' |
| above stands for a literal Tab character. |
| <DT><B>set/unset regexp</B><DD> |
| Do regular expression searches by default. |
| <DT><B>set/unset smooth</B><DD> |
| Use smooth scrolling by default. |
| <DT><B>set speller </B><I>spellprog</I><DD> |
| Use spelling checker <I>spellprog</I> instead of the built-in one, which |
| calls <I>spell</I>. |
| <DT><B>set/unset suspend</B><DD> |
| Allow nano to be suspended with ^Z. |
| <DT><B>set tabsize </B><I>n</I><DD> |
| Use a tab size of <I>n</I> instead of the default (8); must be greater |
| than 0. |
| <DT><B>set/unset tempfile</B><DD> |
| Save automatically on exit, don't prompt. |
| <DT><B>set/unset view</B><DD> |
| Disallow file modification. |
| <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> |
| <P> |
| </DL> |
| </I><A NAME="lbAE"> </A> |
| <H2>FILES</H2> |
| |
| <DL COMPACT> |
| <DT><I>$SYSCONFDIR/nanorc</I> |
| |
| <DD> |
| System-wide configuration file |
| <DT><I>~/.nanorc</I> |
| |
| <DD> |
| Per-user configuration file |
| </DL> |
| <A NAME="lbAF"> </A> |
| <H2>SEE ALSO</H2> |
| |
| |
| <DL COMPACT> |
| <DT><B><A HREF="http://localhost/cgi-bin/man/man2html?1+nano">nano</A></B>(1)<DD> |
| </DL> |
| <P> |
| |
| <I>/usr/share/doc/nano/examples/nanorc.sample</I> (or equivalent on your |
| system) |
| <A NAME="lbAG"> </A> |
| <H2>AUTHOR</H2> |
| |
| Chris Allegretta <<A HREF="mailto:chrisa@asty.org">chrisa@asty.org</A>>, et al (see |
| <I>AUTHORS</I> |
| |
| and |
| <I>THANKS</I> |
| |
| for details). |
| This manual page was written by Jordi Mallach <<A HREF="mailto:jordi@gnu.org">jordi@gnu.org</A>>. |
| <P> |
| |
| <HR> |
| <A NAME="index"> </A><H2>Index</H2> |
| <DL> |
| <DT><A HREF="#lbAB">NAME</A><DD> |
| <DT><A HREF="#lbAC">DESCRIPTION</A><DD> |
| <DT><A HREF="#lbAD">OPTIONS</A><DD> |
| <DT><A HREF="#lbAE">FILES</A><DD> |
| <DT><A HREF="#lbAF">SEE ALSO</A><DD> |
| <DT><A HREF="#lbAG">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: 22:28:00 GMT, June 19, 2003 |
| </BODY> |
| </HTML> |