nano.1.html 5.44 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.
65
66
67
68
69
<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
70
<DT><B>-S (--smooth)</B>
Chris Allegretta's avatar
Chris Allegretta committed
71
72

<DD>
Chris Allegretta's avatar
Chris Allegretta committed
73
74
75
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
76
77

<DD>
Chris Allegretta's avatar
Chris Allegretta committed
78
79
80
81
82
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
83
84
85
86
<DT><B>-c (--const)</B>

<DD>
Constantly show the cursor position.
Chris Allegretta's avatar
Chris Allegretta committed
87
88
89
90
<DT><B>-h (--help)</B>

<DD>
Display a summary of command line options.
Chris Allegretta's avatar
Chris Allegretta committed
91
92
93
94
95
<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
96
97
98
99
<DT><B>-k (--cut)</B>

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

<DD>
If the file being edited is a symbolic link, replace the link with a 
104
a new file, do not follow it.  Good for editing files in /tmp, perhaps?
Chris Allegretta's avatar
Chris Allegretta committed
105
106
107
108
<DT><B>-m (--mouse)</B>

<DD>
Enable mouse support (if available for your system).
Chris Allegretta's avatar
Chris Allegretta committed
109
110
111
112
<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
113
114
115
<DT><B>-p (--pico)</B>

<DD>
116
117
118
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
119
<DT><B>-r [#cols] (--fill=[#cols])</B>
Chris Allegretta's avatar
Chris Allegretta committed
120
121

<DD>
122
Wrap lines at column #cols.  By default, this is the width of the screen,
123
124
125
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
126
<DT><B>-s [prog] (--speller=[prog])</B>
Chris Allegretta's avatar
Chris Allegretta committed
127
128
129
130
131
132

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

<DD>
133
Always save changed buffer without prompting.  Same as Pico -t option.
Chris Allegretta's avatar
Chris Allegretta committed
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
<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
150
<DT><B>-a, -b, -e, -f, -g, -j</B>
151
152
153

<DD>
Ignored, for compatibility with Pico.
Chris Allegretta's avatar
Chris Allegretta committed
154
155
156
157
158
159
<DT><B>+LINE</B>

<DD>
Places cursor at LINE on startup.
</DL>
<A NAME="lbAF">&nbsp;</A>
160
161
162
<H2>NOTES</H2>

Nano will try to dump the buffer into an emergency file in some cases.
163
Mainly, this will happen if Nano receives a SIGHUP or runs out of
164
165
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
166
167
168
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.
169
<A NAME="lbAG">&nbsp;</A>
Chris Allegretta's avatar
Chris Allegretta committed
170
171
172
<H2>BUGS</H2>

Please send any comments or bug reports to
173
174
<BR>

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

177
178
<BR>

Chris Allegretta's avatar
Chris Allegretta committed
179
The nano mailing list is available from
180
181
<BR>

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

184
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
185
subject of &quot;subscribe&quot;.
186
<A NAME="lbAH">&nbsp;</A>
Chris Allegretta's avatar
Chris Allegretta committed
187
188
<H2>HOMEPAGE</H2>

Chris Allegretta's avatar
Chris Allegretta committed
189
<A HREF="http://www.nano-editor.org">http://www.nano-editor.org</A>
190
<A NAME="lbAI">&nbsp;</A>
Chris Allegretta's avatar
Chris Allegretta committed
191
192
<H2>AUTHOR</H2>

Chris Allegretta's avatar
Chris Allegretta committed
193
194
Chris Allegretta &lt;<A HREF="mailto:chrisa@asty.org">chrisa@asty.org</A>&gt;, et al (see AUTHORS and THANKS for
details).
195
196
197
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
198
199
200
201
202
203
204
205
206
<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>
207
208
209
210
<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
211
212
213
214
215
</DL>
<HR>
This document was created by
<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
216
Time: 13:37:58 GMT, February 01, 2002
Chris Allegretta's avatar
Chris Allegretta committed
217
218
</BODY>
</HTML>