Jordi Mallach | d7ad75a | 2000-12-03 02:46:02 +0000 | [diff] [blame] | 1 | .\" Hey, EMACS: -*- nroff -*- |
| 2 | .\" nano.1 is copyright 1999-2000 by |
| 3 | .\" Chris Allegretta <chrisa@asty.org> |
| 4 | .\" |
| 5 | .\" This is free documentation, see the latest version of the GNU General |
| 6 | .\" Public License for copying conditions. There is NO warranty. |
| 7 | .\" |
Chris Allegretta | a2ea193 | 2000-06-06 05:53:49 +0000 | [diff] [blame] | 8 | .\" First parameter, NAME, should be all caps |
| 9 | .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection |
| 10 | .\" other parameters are allowed: see man(7), man(1) |
Jordi Mallach | d7ad75a | 2000-12-03 02:46:02 +0000 | [diff] [blame] | 11 | .TH NANO 1 "December 2, 2000" |
Chris Allegretta | a2ea193 | 2000-06-06 05:53:49 +0000 | [diff] [blame] | 12 | .\" Please adjust this date whenever revising the manpage. |
| 13 | .\" |
Chris Allegretta | a2ea193 | 2000-06-06 05:53:49 +0000 | [diff] [blame] | 14 | .SH NAME |
| 15 | nano \- Nano's ANOther editor, an enhanced free Pico Clone |
| 16 | .SH SYNOPSIS |
| 17 | .B nano |
| 18 | .RI [options]\ [+LINE] " file" |
| 19 | .br |
| 20 | .SH DESCRIPTION |
| 21 | This manual page documents briefly the |
| 22 | .B nano |
| 23 | command. |
| 24 | .PP |
| 25 | .\" TeX users may be more comfortable with the \fB<whatever>\fP and |
| 26 | .\" \fI<whatever>\fP escape sequences to invode bold face and italics, |
| 27 | .\" respectively. |
Jordi Mallach | d7ad75a | 2000-12-03 02:46:02 +0000 | [diff] [blame] | 28 | \fBnano\fP is a small, free and friendly editor which aims to replace |
| 29 | Pico, the default editor included in the non-free Pine package. Rather |
| 30 | than just copying Pico's look and feel, |
Chris Allegretta | a2ea193 | 2000-06-06 05:53:49 +0000 | [diff] [blame] | 31 | .B nano |
Jordi Mallach | d7ad75a | 2000-12-03 02:46:02 +0000 | [diff] [blame] | 32 | also implements some missing (or disabled by default) features in Pico, |
| 33 | such as "search and replace" and "goto line number". |
Chris Allegretta | a2ea193 | 2000-06-06 05:53:49 +0000 | [diff] [blame] | 34 | .SH OPTIONS |
| 35 | .TP |
Chris Allegretta | 4da1fc6 | 2000-06-21 03:00:43 +0000 | [diff] [blame] | 36 | .B \-T (\-\-tabsize) |
Chris Allegretta | bbd96ea | 2000-08-04 02:05:44 +0000 | [diff] [blame] | 37 | Set the size (width) of a tab. |
Chris Allegretta | 4da1fc6 | 2000-06-21 03:00:43 +0000 | [diff] [blame] | 38 | .TP |
Chris Allegretta | 9fc8d43 | 2000-07-07 01:49:52 +0000 | [diff] [blame] | 39 | .B \-R (\-\-regexp) |
| 40 | Enable regular expression matching for search strings, as well as |
Chris Allegretta | a408edd | 2000-07-07 04:20:09 +0000 | [diff] [blame] | 41 | \\n subexpression replacement for replace strings, if available. |
Chris Allegretta | 9fc8d43 | 2000-07-07 01:49:52 +0000 | [diff] [blame] | 42 | .TP |
Chris Allegretta | a2ea193 | 2000-06-06 05:53:49 +0000 | [diff] [blame] | 43 | .B \-V (\-\-version) |
| 44 | Show the current version number and author. |
| 45 | .TP |
| 46 | .B \-h (\-\-help) |
| 47 | Display a summary of commandline options. |
| 48 | .TP |
| 49 | .B \-c (\-\-const) |
| 50 | Constantly show the cursor position. |
| 51 | .TP |
Jordi Mallach | 3206ab4 | 2000-07-28 16:55:47 +0000 | [diff] [blame] | 52 | .B \-k (\-\-cut) |
Chris Allegretta | 84ff479 | 2000-07-28 17:29:22 +0000 | [diff] [blame] | 53 | Enable cut from cursor to end of line with ^K. |
Jordi Mallach | 3206ab4 | 2000-07-28 16:55:47 +0000 | [diff] [blame] | 54 | .TP |
Chris Allegretta | a2ea193 | 2000-06-06 05:53:49 +0000 | [diff] [blame] | 55 | .B \-i (\-\-autoindent) |
| 56 | Indent new lines to the previous line's indentation. Useful when editing |
| 57 | source code. |
| 58 | .TP |
| 59 | .B \-l (\-\-nofollow) |
| 60 | If the file being edited is a symbolic link, replace the link with a |
| 61 | a new file, do not follow it. Good for editing files in /tmp perhaps? |
| 62 | .TP |
| 63 | .B \-m (\-\-mouse) |
| 64 | Enable mouse support (if available for your system). |
| 65 | .TP |
| 66 | .B \-p (\-\-pico) |
Chris Allegretta | 51b3eec | 2000-12-18 02:23:50 +0000 | [diff] [blame] | 67 | Emulate Pico as closely as possible. This affects both the "shortcut list" |
| 68 | at the bottom of the screen, as well as the display and entry of previous |
| 69 | search and replace strings. |
Chris Allegretta | a2ea193 | 2000-06-06 05:53:49 +0000 | [diff] [blame] | 70 | .TP |
| 71 | .B \-s (\-\-speller) |
| 72 | Enable alternative spell checker command. |
| 73 | .TP |
| 74 | .B \-t (\-\-tempfile) |
| 75 | Always save changed buffer without prompting. Same as Pico -t option. |
| 76 | .TP |
| 77 | .B \-v (\-\-view) |
| 78 | View file (read only) mode. |
| 79 | .TP |
| 80 | .B \-w (\-\-nowrap) |
| 81 | Disable wrapping of long lines. |
| 82 | .TP |
| 83 | .B \-x (\-\-nohelp) |
| 84 | Disable help screen at bottom of editor. |
| 85 | .TP |
| 86 | .B \-z (\-\-suspend) |
| 87 | Enable suspend ability. |
| 88 | .TP |
Chris Allegretta | 51b3eec | 2000-12-18 02:23:50 +0000 | [diff] [blame] | 89 | .B \-b, \-e, \-f |
| 90 | Ignored, for compatibility with Pico. |
| 91 | .TP |
Chris Allegretta | a2ea193 | 2000-06-06 05:53:49 +0000 | [diff] [blame] | 92 | .B \+LINE |
| 93 | Places cursor at LINE on startup. |
Jordi Mallach | d7ad75a | 2000-12-03 02:46:02 +0000 | [diff] [blame] | 94 | .SH NOTES |
| 95 | Nano will try to dump the buffer into an emergency file in some cases. |
| 96 | Mainly, this will happen if Nano recieves a SIGHUP or runs out of |
| 97 | memory, when it will write the buffer into a file named "nano.save" if the |
| 98 | buffer didn't have a name already, or will add a ".save" suffix to the |
Jordi Mallach | d87b341 | 2000-12-03 03:15:19 +0000 | [diff] [blame] | 99 | current finename. Nano will \fBnot\fP write this file if a previous one |
| 100 | exists in the current directory. |
Chris Allegretta | a2ea193 | 2000-06-06 05:53:49 +0000 | [diff] [blame] | 101 | .SH BUGS |
| 102 | Please send any comments or bug reports to |
Jordi Mallach | d7ad75a | 2000-12-03 02:46:02 +0000 | [diff] [blame] | 103 | .br |
Chris Allegretta | 66989d6 | 2000-09-27 03:16:11 +0000 | [diff] [blame] | 104 | .B nano@nano-editor.org. |
Jordi Mallach | d7ad75a | 2000-12-03 02:46:02 +0000 | [diff] [blame] | 105 | .br |
Chris Allegretta | a2ea193 | 2000-06-06 05:53:49 +0000 | [diff] [blame] | 106 | The nano mailing list is available from |
Jordi Mallach | d7ad75a | 2000-12-03 02:46:02 +0000 | [diff] [blame] | 107 | .br |
Chris Allegretta | a2ea193 | 2000-06-06 05:53:49 +0000 | [diff] [blame] | 108 | .B nano-devel@lists.sourceforge.net. |
| 109 | To subscribe, email to nano-devel-request@lists.sourceforge.net with a |
| 110 | subject of "subscribe". |
| 111 | .SH HOMEPAGE |
Chris Allegretta | 66989d6 | 2000-09-27 03:16:11 +0000 | [diff] [blame] | 112 | http://www.nano-editor.org |
Chris Allegretta | a2ea193 | 2000-06-06 05:53:49 +0000 | [diff] [blame] | 113 | .SH AUTHOR |
Jordi Mallach | d7ad75a | 2000-12-03 02:46:02 +0000 | [diff] [blame] | 114 | Chris Allegretta <chrisa@asty.org>, et al (see AUTHORS for details). |
| 115 | This manual page was originally written by Jordi Mallach |
| 116 | <jordi@sindominio.net>, for the Debian GNU/Linux system (but may be |
| 117 | used by others). |