nano.1.html 5.64 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: January 3, 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>
Chris Allegretta's avatar
Chris Allegretta committed
47
48
49
50
<DT><B>-D (--dos)</B>

<DD>
Write file in DOS format.
Chris Allegretta's avatar
Chris Allegretta committed
51
52
53
54
<DT><B>-F (--multibuffer)</B>

<DD>
Enable multiple file buffers (if available).
55
56
57
58
59
60
<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
61
<DT><B>-M (--mac)</B>
Chris Allegretta's avatar
Chris Allegretta committed
62
63

<DD>
Chris Allegretta's avatar
Chris Allegretta committed
64
Write file in Mac format.
Chris Allegretta's avatar
Chris Allegretta committed
65
66
67
68
69
70
71
72
<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;.
73
74
75
76
77
<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
78
<DT><B>-S (--smooth)</B>
Chris Allegretta's avatar
Chris Allegretta committed
79
80

<DD>
Chris Allegretta's avatar
Chris Allegretta committed
81
82
83
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
84
85

<DD>
Chris Allegretta's avatar
Chris Allegretta committed
86
87
88
89
90
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
91
92
93
94
<DT><B>-c (--const)</B>

<DD>
Constantly show the cursor position.
Chris Allegretta's avatar
Chris Allegretta committed
95
96
97
98
<DT><B>-h (--help)</B>

<DD>
Display a summary of command line options.
Chris Allegretta's avatar
Chris Allegretta committed
99
100
101
102
103
<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
104
105
106
107
<DT><B>-k (--cut)</B>

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

<DD>
Chris Allegretta's avatar
Chris Allegretta committed
111
If the file being edited is a symbolic link, replace the link with
112
a new file, do not follow it.  Good for editing files in /tmp, perhaps?
Chris Allegretta's avatar
Chris Allegretta committed
113
114
115
116
<DT><B>-m (--mouse)</B>

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

<DD>
Set operating directory. Makes nano set up something similar to a chroot.
Chris Allegretta's avatar
Chris Allegretta committed
121
122
123
<DT><B>-p (--pico)</B>

<DD>
124
125
126
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
127
<DT><B>-r [#cols] (--fill=[#cols])</B>
Chris Allegretta's avatar
Chris Allegretta committed
128
129

<DD>
130
Wrap lines at column #cols.  By default, this is the width of the screen,
131
132
133
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
134
<DT><B>-s [prog] (--speller=[prog])</B>
Chris Allegretta's avatar
Chris Allegretta committed
135
136
137
138
139
140

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

<DD>
141
Always save changed buffer without prompting.  Same as Pico -t option.
Chris Allegretta's avatar
Chris Allegretta committed
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
<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
158
<DT><B>-a, -b, -e, -f, -g, -j</B>
159
160
161

<DD>
Ignored, for compatibility with Pico.
Chris Allegretta's avatar
Chris Allegretta committed
162
163
164
165
166
167
<DT><B>+LINE</B>

<DD>
Places cursor at LINE on startup.
</DL>
<A NAME="lbAF">&nbsp;</A>
168
169
170
<H2>NOTES</H2>

Nano will try to dump the buffer into an emergency file in some cases.
171
Mainly, this will happen if Nano receives a SIGHUP or runs out of
172
173
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
Chris Allegretta's avatar
Chris Allegretta committed
174
175
176
current filename. In multibuffer mode, nano will write all the open buffers to
the respective emergency files. Nano will <B>not</B> write this file if a
previous one exists in the current directory.
177
<A NAME="lbAG">&nbsp;</A>
Chris Allegretta's avatar
Chris Allegretta committed
178
179
180
<H2>BUGS</H2>

Please send any comments or bug reports to
181
182
<BR>

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

185
186
<BR>

Chris Allegretta's avatar
Chris Allegretta committed
187
The nano mailing list is available from
188
189
<BR>

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

192
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
193
subject of &quot;subscribe&quot;.
194
<A NAME="lbAH">&nbsp;</A>
Chris Allegretta's avatar
Chris Allegretta committed
195
196
<H2>HOMEPAGE</H2>

Chris Allegretta's avatar
Chris Allegretta committed
197
<A HREF="http://www.nano-editor.org">http://www.nano-editor.org</A>
198
<A NAME="lbAI">&nbsp;</A>
Chris Allegretta's avatar
Chris Allegretta committed
199
200
<H2>AUTHOR</H2>

Chris Allegretta's avatar
Chris Allegretta committed
201
202
Chris Allegretta &lt;<A HREF="mailto:chrisa@asty.org">chrisa@asty.org</A>&gt;, et al (see AUTHORS and THANKS for
details).
203
204
205
This manual page was originally written by Jordi Mallach
&lt;<A HREF="mailto:jordi@sindominio.net">jordi@sindominio.net</A>&gt;, for the Debian GNU/Linux system (but may be
used by others).
Chris Allegretta's avatar
Chris Allegretta committed
206
207
208
209
210
211
212
213
214
<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>
215
216
217
218
<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
219
220
221
222
223
</DL>
<HR>
This document was created by
<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Chris Allegretta's avatar
Chris Allegretta committed
224
Time: 12:14:20 GMT, March 04, 2002
Chris Allegretta's avatar
Chris Allegretta committed
225
226
</BODY>
</HTML>