nano.1.html 5.98 KB
Newer Older
Chris Allegretta's avatar
Chris Allegretta committed
1
2
3
4
5
Content-type: text/html

<HTML><HEAD><TITLE>Manpage of NANO</TITLE>
</HEAD><BODY>
<H1>NANO</H1>
6
Section: User Commands  (1)<BR>Updated: June 27, 2002<BR><A HREF="#index">Index</A>
Chris Allegretta's avatar
Chris Allegretta committed
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR>



<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>

nano - Nano's ANOther editor, an enhanced free Pico Clone
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>

<B>nano</B>

[options]&nbsp;[+LINE]<I> file</I>

<BR>

<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>

This manual page documents briefly the
<B>nano</B>

command.
<P>




36
37
38
<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,
Chris Allegretta's avatar
Chris Allegretta committed
39
40
<B>nano</B>

41
42
also implements some missing (or disabled by default) features in Pico,
such as &quot;search and replace&quot; and &quot;goto line number&quot;.
Chris Allegretta's avatar
Chris Allegretta committed
43
44
45
46
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>

<DL COMPACT>
47
48
49
50
51
<DT><B>-B (--backup)</B>

<DD>
When saving a file, back up the previous version of it to the current
filename suffixed with a ~.
Chris Allegretta's avatar
Chris Allegretta committed
52
53
54
55
<DT><B>-D (--dos)</B>

<DD>
Write file in DOS format.
Chris Allegretta's avatar
Chris Allegretta committed
56
57
58
<DT><B>-F (--multibuffer)</B>

<DD>
59
Enable multiple file buffers, if available.
60
61
62
63
64
65
<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.
Chris Allegretta's avatar
Chris Allegretta committed
66
<DT><B>-M (--mac)</B>
Chris Allegretta's avatar
Chris Allegretta committed
67
68

<DD>
Chris Allegretta's avatar
Chris Allegretta committed
69
Write file in Mac format.
Chris Allegretta's avatar
Chris Allegretta committed
70
71
72
73
74
75
76
77
<DT><B>-N (--noconvert)</B>

<DD>
Disable automatic conversion of files from DOS/Mac format.
<DT><B>-Q [str] (--quotestr=[str])</B>

<DD>
Set the quoting string for justifying.  The default is &quot;&gt; &quot;.
78
79
80
81
82
<DT><B>-R (--regexp)</B>

<DD>
Enable regular expression matching for search strings, as well as
\n subexpression replacement for replace strings, if available.
Chris Allegretta's avatar
Chris Allegretta committed
83
<DT><B>-S (--smooth)</B>
Chris Allegretta's avatar
Chris Allegretta committed
84
85

<DD>
Chris Allegretta's avatar
Chris Allegretta committed
86
87
88
Enable smooth scrolling. Text will scroll line-by-line, instead of the
usual chunk-by-chunk behaviour.
<DT><B>-T [num] (--tabsize=[num])</B>
Chris Allegretta's avatar
Chris Allegretta committed
89
90

<DD>
Chris Allegretta's avatar
Chris Allegretta committed
91
92
93
94
95
Set the size (width) of a tab.
<DT><B>-V (--version)</B>

<DD>
Show the current version number and author.
Chris Allegretta's avatar
Chris Allegretta committed
96
97
98
<DT><B>-Y (--syntax=[str])</B>

<DD>
99
100
Specify a specific syntax highlighting from the .nanorc to use, if
available.
Chris Allegretta's avatar
Chris Allegretta committed
101
102
103
104
<DT><B>-c (--const)</B>

<DD>
Constantly show the cursor position.
Chris Allegretta's avatar
Chris Allegretta committed
105
106
107
108
<DT><B>-h (--help)</B>

<DD>
Display a summary of command line options.
Chris Allegretta's avatar
Chris Allegretta committed
109
110
111
112
113
<DT><B>-i (--autoindent)</B>

<DD>
Indent new lines to the previous line's indentation. Useful when editing
source code.
Chris Allegretta's avatar
Chris Allegretta committed
114
115
116
117
<DT><B>-k (--cut)</B>

<DD>
Enable cut from cursor to end of line with ^K.
Chris Allegretta's avatar
Chris Allegretta committed
118
119
120
<DT><B>-l (--nofollow)</B>

<DD>
Chris Allegretta's avatar
Chris Allegretta committed
121
If the file being edited is a symbolic link, replace the link with
122
a new file, do not follow it.  Good for editing files in /tmp, perhaps?
Chris Allegretta's avatar
Chris Allegretta committed
123
124
125
126
<DT><B>-m (--mouse)</B>

<DD>
Enable mouse support (if available for your system).
Chris Allegretta's avatar
Chris Allegretta committed
127
128
129
<DT><B>-o [dir] (--operatingdir=[dir])</B>

<DD>
130
131
Set operating directory. Makes nano set up something similar to a
chroot.
Chris Allegretta's avatar
Chris Allegretta committed
132
133
134
<DT><B>-p (--pico)</B>

<DD>
135
136
137
Emulate Pico as closely as possible.  This affects both the &quot;shortcut
list&quot; at the bottom of the screen, as well as the display and entry of
previous search and replace strings.
Chris Allegretta's avatar
Chris Allegretta committed
138
<DT><B>-r [#cols] (--fill=[#cols])</B>
Chris Allegretta's avatar
Chris Allegretta committed
139
140

<DD>
141
142
143
144
Wrap lines at column #cols.  By default, this is the width of the
screen, less eight.  If this value is negative, wrapping will occur at
#cols from the right of the screen, allowing it to vary along with the
screen width if the screen is resized.
Chris Allegretta's avatar
Chris Allegretta committed
145
<DT><B>-s [prog] (--speller=[prog])</B>
Chris Allegretta's avatar
Chris Allegretta committed
146
147
148
149
150
151

<DD>
Enable alternative spell checker command.
<DT><B>-t (--tempfile)</B>

<DD>
152
Always save changed buffer without prompting.  Same as Pico -t option.
Chris Allegretta's avatar
Chris Allegretta committed
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
<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.
Chris Allegretta's avatar
Chris Allegretta committed
169
<DT><B>-a, -b, -e, -f, -g, -j</B>
170
171
172

<DD>
Ignored, for compatibility with Pico.
Chris Allegretta's avatar
Chris Allegretta committed
173
174
175
176
177
178
<DT><B>+LINE</B>

<DD>
Places cursor at LINE on startup.
</DL>
<A NAME="lbAF">&nbsp;</A>
179
180
181
<H2>NOTES</H2>

Nano will try to dump the buffer into an emergency file in some cases.
182
Mainly, this will happen if Nano receives a SIGHUP or runs out of
183
184
185
186
memory, when it will write the buffer into a file named &quot;nano.save&quot; if
the buffer didn't have a name already, or will add a &quot;.save&quot; suffix to
the current filename. If an emergency file with that name already exists
in the current directory, &quot;.save&quot; and a number (e.g. &quot;.save.1&quot;) will be
Chris Allegretta's avatar
Chris Allegretta committed
187
188
189
suffixed to the current filename in order to make it unique. In
multibuffer mode, nano will write all the open buffers to the respective
emergency files.
190
<A NAME="lbAG">&nbsp;</A>
Chris Allegretta's avatar
Chris Allegretta committed
191
192
193
<H2>BUGS</H2>

Please send any comments or bug reports to
194
195
<BR>

Chris Allegretta's avatar
Chris Allegretta committed
196
<B><A HREF="mailto:nano@nano-editor.org">nano@nano-editor.org</A>.</B>
Chris Allegretta's avatar
Chris Allegretta committed
197

198
199
<BR>

Chris Allegretta's avatar
Chris Allegretta committed
200
The nano mailing list is available from
201
202
<BR>

203
<B><A HREF="mailto:nano-devel@gnu.org">nano-devel@gnu.org</A>.</B>
Chris Allegretta's avatar
Chris Allegretta committed
204

205
To subscribe, email to <A HREF="mailto:nano-devel-request@gnu.org">nano-devel-request@gnu.org</A> with a
Chris Allegretta's avatar
Chris Allegretta committed
206
subject of &quot;subscribe&quot;.
207
<A NAME="lbAH">&nbsp;</A>
Chris Allegretta's avatar
Chris Allegretta committed
208
209
<H2>HOMEPAGE</H2>

Chris Allegretta's avatar
Chris Allegretta committed
210
<A HREF="http://www.nano-editor.org">http://www.nano-editor.org</A>
211
<A NAME="lbAI">&nbsp;</A>
Chris Allegretta's avatar
Chris Allegretta committed
212
213
<H2>AUTHOR</H2>

Chris Allegretta's avatar
Chris Allegretta committed
214
215
Chris Allegretta &lt;<A HREF="mailto:chrisa@asty.org">chrisa@asty.org</A>&gt;, et al (see AUTHORS and THANKS for
details).
216
This manual page was originally written by Jordi Mallach
Chris Allegretta's avatar
Chris Allegretta committed
217
&lt;<A HREF="mailto:jordi@sindominio.net">jordi@sindominio.net</A>&gt;, for the Debian GNU system (but may be
218
used by others).
Chris Allegretta's avatar
Chris Allegretta committed
219
220
221
222
223
224
225
226
227
<P>

<HR>
<A NAME="index">&nbsp;</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>
228
229
230
231
<DT><A HREF="#lbAF">NOTES</A><DD>
<DT><A HREF="#lbAG">BUGS</A><DD>
<DT><A HREF="#lbAH">HOMEPAGE</A><DD>
<DT><A HREF="#lbAI">AUTHOR</A><DD>
Chris Allegretta's avatar
Chris Allegretta committed
232
233
234
235
236
</DL>
<HR>
This document was created by
<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
237
Time: 21:45:15 GMT, June 27, 2002
Chris Allegretta's avatar
Chris Allegretta committed
238
239
</BODY>
</HTML>