Skip to content

GitLab

Switch branch/tag
Find file Normal viewHistoryPermalink
faq.html 39.3 KB
Newer Older
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
1 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
Chris Allegretta's avatar
Added FAQ    
Chris Allegretta committed
2
3 
<html>
<head>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
4 
  <title>The GNU nano editor FAQ</title>
David Lawrence Ramsey's avatar
in faq.html, change the character set to UTF-8, and remove broken links    
David Lawrence Ramsey committed
5 
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
Chris Allegretta's avatar
Added FAQ    
Chris Allegretta committed
6 
</head>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
7 
<body text="#330000" bgcolor="#ffffff" link="#0000ef" vlink="#51188e" alink="#ff0000">
David Lawrence Ramsey's avatar
add faq entry about how to open files with names starting with '+'s    
David Lawrence Ramsey committed
8 
<h1>The GNU nano editor FAQ</h1>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
9
10
11
12
13
14
15
16
17
18
19
20
21 
<h2>Table of Contents</h2>
<h2><a href="#1">1. General</a></h2>
<blockquote><p><a href="#1.1">1.1 About this FAQ</a><br>
  <a href="#1.2">1.2. How do I contribute to it?</a><br>
  <a href="#1.3">1.3. What is GNU nano?</a><br>
  <a href="#1.4">1.4. What is the history behind nano?</a><br>
  <a href="#1.5">1.5. Why the name change from TIP?</a><br>
  <a href="#1.6">1.6. What is the current version of nano?</a><br>
  <a href="#1.7">1.7. I want to read the manpage without having to download the program!</a></p></blockquote>
<h2><a href="#2">2. Where to get GNU nano.</a></h2>
<blockquote><p><a href="#2.1">2.1. FTP and WWW sites that carry nano.</a><br>
  <a href="#2.2">2.2. RedHat and derivatives (.rpm) packages.</a><br>
  <a href="#2.3">2.3. Debian (.deb) packages.</a><br>
Chris Allegretta's avatar
faq.html: Updates for Alpine, subversion access and Savannah.    
Chris Allegretta committed
22 
  <a href="#2.4">2.4. By subversion (for the brave).</a></p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
23
24
25
26 
<h2><a href="#3">3. Installation and Configuration</a></h2>
<blockquote><p><a href="#3.1">3.1. How do I install the RPM or DEB package?</a><br>
  <a href="#3.2">3.2. Compiling from source: WHAT THE HECK DO I DO NOW?</a><br>
  <a href="#3.3">3.3. Why does everything go into /usr/local?</a><br>
David Lawrence Ramsey's avatar
add faq entry about how to open files with names starting with '+'s    
David Lawrence Ramsey committed
27 
  <a href="#3.4">3.4. I get errors about 'bindtextdomain','gettext', and/or 'gettextdomain'. What can I do about it?</a><br>
David Lawrence Ramsey's avatar
more miscellaneous documentation updates    
David Lawrence Ramsey committed
28 
  <a href="#3.5">3.5. nano should automatically run strip on the binary when installing it!</a><br>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
29
30 
  <a href="#3.6">3.6. How can I make the executable smaller? This is too bloated!</a><br>
  <a href="#3.7">3.7. Tell me more about this multibuffer stuff!</a><br>
David Lawrence Ramsey's avatar
add verbatim input question and a few minor fixes to the faq    
David Lawrence Ramsey committed
31
32 
  <a href="#3.8">3.8. Tell me more about this verbatim input stuff!</a><br>
  <a href="#3.9">3.9. How do I make a .nanorc file that nano will read when I start it?</a></p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
33 
<h2><a href="#4">4. Running</a></h2>
David Lawrence Ramsey's avatar
add faq entry about how to open files with names starting with '+'s    
David Lawrence Ramsey committed
34 
<blockquote><p><a href="#4.1">4.1. How do I open a file with a name beginning with '+' from the command line?</a><br>
David Lawrence Ramsey's avatar
per Benno Schulenberg's patch (with a few tweaks by me), add a new    
David Lawrence Ramsey committed
35 
  <a href="#4.2">4.2. Ack! My Backspace/Delete/Enter/Meta/double bucky key doesn't seem to work! What can I do?</a><br>
David Lawrence Ramsey's avatar
readd the option to turn the keypad off by default from nano 1.2.x, with    
David Lawrence Ramsey committed
36 
  <a href="#4.3">4.3. Ack! My numeric keypad's keys don't work properly when NumLock is off! What can I do?</a><br>
David Lawrence Ramsey's avatar
drop the Meta-] and Meta-[ aliases for Meta-} and Meta-}, and change the    
David Lawrence Ramsey committed
37
38 
  <a href="#4.4">4.4. Ack! When I hold down a Meta key combination for a while, the character of the held key gets inserted now and then. What gives?</a><br>
  <a href="#4.5">4.5. How do I type the F13-F16 keys shown in the help browser? My keyboard only has F1-F12!</a><br>
David Lawrence Ramsey's avatar
more miscellaneous documentation updates    
David Lawrence Ramsey committed
39
40 
  <a href="#4.6">4.6. nano crashes when I type &lt;insert keystroke here&gt;!</a><br>
  <a href="#4.7">4.7. nano crashes when I resize my window. How can I fix that?</a><br>
David Lawrence Ramsey's avatar
remove the workaround for glibc 2.2.3's broken regexec(), and replace it    
David Lawrence Ramsey committed
41
42
43
44
45
46 
  <a href="#4.8">4.8. [version 1.3.12 and later] I'm using glibc 2.2.3, and nano crashes when I use color support or do regular expression searches. How can I fix that?</a><br>
  <a href="#4.9">4.9. [version 1.1.12 and earlier] Why does nano show ^\ in the shortcut list instead of ^J?</a><br>
  <a href="#4.10a">4.10a. [version 1.1.12 and earlier] When I type in a search string, the string I last searched for is already in front of my cursor! What happened?!</a><br>
  <a href="#4.10b">4.10b. [version 1.1.99pre1 and later] Hey, the search string behavior has reverted, it's now like Pico, what happened to the consistency?</a><br>
  <a href="#4.11">4.11. How do I make nano my default editor (in Pine, mutt, etc.)?</a><br>
  <a href="#4.12">4.12. I've compiled nano with color support, but I don't see any color when I run it!</a><br>
David Lawrence Ramsey's avatar
in doc/faq.html, add a new section 4.14 by John M. Gabriele, with a few    
David Lawrence Ramsey committed
47
48 
  <a href="#4.13">4.13. How do I select text for or paste text from the clipboard in an X terminal when I'm running nano in one and nano's mouse support is turned on?</a><br>
  <a href="#4.14">4.14. When I paste text into a document, each line gets indented further than the last. Why does nano do this, and how can I avoid it?</a></p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
49
50 
<h2><a href="#5">5. Internationalization</a></h2>
<blockquote><p><a href="#5.1">5.1. There's no translation for my language!</a><br>
David Lawrence Ramsey's avatar
in faq.html, clarify section 5.3 to better explain how to enable Unicode    
David Lawrence Ramsey committed
51 
  <a href="#5.2">5.2. I don't like the translation for &lt;x&gt; in my language. How can I fix it?</a><br>
David Lawrence Ramsey's avatar
in faq.html, add a new section 5.3 to explain the status of nano's    
David Lawrence Ramsey committed
52 
  <a href="#5.3">5.3. What is the status of Unicode support?</a></p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
53
54
55 
<h2><a href="#6">6. Advocacy and Licensing</a></h2>
<blockquote><p><a href="#6.1">6.1. Why should I use nano instead of Pico?</a><br>
  <a href="#6.2">6.2. Why should I use Pico instead of nano?</a><br>
David Lawrence Ramsey's avatar
in faq.html, add minor punctuation and wording fixes, and update various    
David Lawrence Ramsey committed
56
57 
  <a href="#6.3">6.3. What is so bad about the older Pine license?</a><br>
  <a href="#6.4">6.4. Okay, well, what mail program should I use then?</a></p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
58 
<h2><a href="#7">7. Miscellaneous</a></h2>
David Lawrence Ramsey's avatar
more miscellaneous documentation updates    
David Lawrence Ramsey committed
59 
<blockquote><p><a href="#7.1">7.1. nano-related mailing lists.</a><br>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
60 
  <a href="#7.2">7.2. I want to send the development team a big load of cash (or just a thank you).</a><br>
Chris Allegretta's avatar
faq.html: Updates for Alpine, subversion access and Savannah.    
Chris Allegretta committed
61 
  <a href="#7.3">7.3. How do I submit a bug report or patch?</a><br>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
62 
  <a href="#7.4">7.4. How do I join the development team?</a><br>
Chris Allegretta's avatar
faq.html: Updates for Alpine, subversion access and Savannah.    
Chris Allegretta committed
63 
  <a href="#7.5">7.5. Can I have write access to the subversion tree?</a></p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
64
65
66
67 
<h2><a href="#8">8. ChangeLog</a></h2>
<hr width="100%">
<h1><a name="1"></a>1. General</h1>
<h2><a name="1.1"></a>1.1 About this FAQ</h2>
David Lawrence Ramsey's avatar
update maintenance information    
David Lawrence Ramsey committed
68 
<blockquote><p>This FAQ was originally written and maintained by Chris Allegretta &lt;<a href="mailto:chrisa@asty.org">chrisa@asty.org</a>&gt;, who also happens to be the creator of nano. It was then maintained by David Lawrence Ramsey &lt;<a href="mailto:pooka109@gmail.com">pooka109@gmail.com</a>&gt;. Maybe someone else will volunteer to maintain this FAQ someday, who knows...</p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
69
70
71 
<h2><a name="1.2"></a>1.2. How do I contribute to it?</h2>
<blockquote><p>Your best bet is to send it to the nano email address, <a href="mailto:nano@nano-editor.org">nano@nano-editor.org</a> and if it is useful enough it will be included in future versions.</p></blockquote>
<h2><a name="1.3"></a>1.3. What is GNU nano?</h2>
Chris Allegretta's avatar
DLR and DB's latest fixes    
Chris Allegretta committed
72 
<blockquote><p>GNU nano is designed to be a free replacement for the Pico text editor, part of the Pine email suite from <a href="http://www.washington.edu/pine/">The University of Washington</a>. It aims to &quot;emulate Pico as closely as possible and perhaps include extra functionality&quot;.</p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
73
74
75
76
77 
<h2><a name="1.4"></a>1.4. What is the history behind nano?</h2>
<blockquote><p>Funny you should ask!</p>
  <p><b>In the beginning...</b></p>
  <p>For years Pine was THE program used to read email on a Unix system. The Pico text editor is the portion of the program one would use to compose his or her mail messages. Many beginners to Unix flocked to Pico and Pine because of their well organized, easy to use interfaces. With the proliferation of GNU/Linux in the mid to late 90's, many University students became intimately familiar with the strengths (and weaknesses) of Pine and Pico.</p>
  <p><b>Then came Debian...</b></p>
David Lawrence Ramsey's avatar
in faq.html, add minor punctuation and wording fixes, and update various    
David Lawrence Ramsey committed
78 
  <p>The <a href="http://www.debian.org/">Debian GNU/Linux</a> distribution, known for its strict standards in distributing truly &quot;free&quot; software (i.e. software with no restrictions on redistribution), would not include a binary package for Pine or Pico. Many people had a serious dilemma: they loved these programs, but the versions available at the time were not truly free software in the <a href="http://www.gnu.org/philosophy/free-sw.html">GNU</a> sense of the word.</p>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
79
80 
  <p><b>The event...</b></p>
  <p>It was in late 1999 when Chris Allegretta (our hero) was yet again complaining to himself about the less-than-perfect license Pico was distributed under, the 1000 makefiles that came with it and how just a few small improvements could make it the Best Editor in the World (TM). Having been a convert from Slackware to Debian, he missed having a simple binary package that included Pine and Pico, and had grown tired of downloading them himself.</p>
David Lawrence Ramsey's avatar
clarify some help text and documentation    
David Lawrence Ramsey committed
81 
  <p>Finally something snapped inside and Chris coded and hacked like a madman for many hours straight one weekend to make a (barely usable) Pico clone, at the time called TIP (Tip Isn't Pico). The program could not be invoked without a filename, could not save files, had no help text display, spell checker, and so forth. But over time it improved, and with the help of a few great coders it matured to the (hopefully) stable state it is today.</p>
David Lawrence Ramsey's avatar
more miscellaneous documentation updates    
David Lawrence Ramsey committed
82 
  <p>In February 2001, nano was declared an official GNU program by Richard Stallman. nano also reached its first production release on March 22, 2001.</p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
83
84
85 
<h2><a name="1.5"></a>1.5. Why the name change from TIP?</h2>
<blockquote><p>On January 10, 2000, TIP was officially renamed to nano because of a namespace conflict with another program called 'tip'. The original 'tip' program &quot;establishes a full duplex terminal connection to a remote host&quot;, and was included with many older Unix systems (and newer ones like Solaris). The conflict was not noticed at first because there is no 'tip' utility included with most GNU/Linux distributions (where nano was developed).</p></blockquote>
<h2><a name="1.6"></a>1.6. What is the current version of nano?</h2>
David Lawrence Ramsey's avatar
preemptively update the version number    
David Lawrence Ramsey committed
86 
<blockquote><p>The current version of nano *should* be 2.0.7. Of course, you should always check the nano homepage to see what the latest and greatest version is.</p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
87 
<h2><a name="1.7"></a>1.7. I want to read the man page without having to download the program!</h2>
David Lawrence Ramsey's avatar
update faq.html for the 2.0 branch of nano    
David Lawrence Ramsey committed
88 
<blockquote><p>Jeez, demanding, aren't we? Okay, look <a href="http://www.nano-editor.org/dist/v2.0/nano.1.html">here</a>.</p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
89
90
91
92
93 
<hr width="100%">
<h1><a name="2"></a>2. Where to get GNU nano.</h1>
<h2><a name="2.1"></a>2.1. FTP and WWW sites that carry nano.</h2>
<blockquote><p>The nano distribution can be downloaded at the following fine web and ftp sites:</p>
  <ul>
Chris Allegretta's avatar
DLR and DB's latest fixes    
Chris Allegretta committed
94
95
96 
    <li><a href="http://www.nano-editor.org/dist/">http://www.nano-editor.org/dist/</a></li>
    <li><a href="http://www.ewtoo.org/~astyanax/nano/dist/">http://www.ewtoo.org/~astyanax/nano/dist/</a></li>
    <li><a href="ftp://ftp.gnu.org/pub/gnu/nano/">ftp://ftp.gnu.org/pub/gnu/nano/</a></li>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
97 
  </ul>
Chris Allegretta's avatar
Added FAQ    
Chris Allegretta committed
98 
</blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
99 
<h2><a name="2.2"></a>2.2. RedHat and derivatives (.rpm) packages.</h2>
Chris Allegretta's avatar
Added FAQ    
Chris Allegretta committed
100 
<blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
101 
  <ul>
David Lawrence Ramsey's avatar
in faq.html, update RPM links for nano 2.0.x    
David Lawrence Ramsey committed
102
103 
    <li><a href="http://www.nano-editor.org/dist/v2.0/RPMS/">http://www.nano-editor.org/dist/v2.0/RPMS/</a></li>
    <li><a href="http://www.ewtoo.org/~astyanax/nano/dist/v2.0/RPMS/">http://www.ewtoo.org/~astyanax/nano/dist/v2.0/RPMS/</a></li>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
104 
  </ul>
Chris Allegretta's avatar
Added FAQ    
Chris Allegretta committed
105 
</blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
106
107
108 
<h2><a name="2.3"></a>2.3. Debian (.deb) packages.</h2>
<blockquote><p>Debian users can check out the current nano packages for:</p>
  <ul>
Chris Allegretta's avatar
DLR and DB's latest fixes    
Chris Allegretta committed
109
110
111 
    <li><a href="http://packages.debian.org/stable/editors/nano.html">stable</a></li>
    <li><a href="http://packages.debian.org/testing/editors/nano.html">testing</a></li>
    <li><a href="http://packages.debian.org/unstable/editors/nano.html">unstable</a></li>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
112 
  </ul>
Chris Allegretta's avatar
DLR and DB's latest fixes    
Chris Allegretta committed
113 
  <p>You can also have a look at the <a href="ftp://ftp.debian.org/debian/pool/main/n/nano/">Package Pool</a> to see all the available binary and source packages.</p>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
114 
  <p>Note that versions &lt; 0.9.10 are probably not for those wanting to get serious work done, so if you are using Debian 2.2, check that you have updated to 2.2r3, which comes with nano 0.9.23. If you're tracking unstable, you probably have the newest version already.</p></blockquote>
Chris Allegretta's avatar
faq.html: Updates for Alpine, subversion access and Savannah.    
Chris Allegretta committed
115
116 
<h2><a name="2.4"></a>2.4. By subversion (for the brave).</h2>
<blockquote><p>For the 'bleeding edge' current version of nano, you can use subversion to download the current source code. <b>Note:</b> believe it or not, by downloading code that has not yet stabilized into an official release, there could quite possibly be bugs, in fact the code may not even compile! Anyway, see <a href="http://svn.savannah.gnu.org/viewvc/trunk/nano/README.SVN?root=nano&view=markup">the nano SVN document</a> for info on anonymous SVN access to the nano source.</p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
117
118 
<hr width="100%">
<h1><a name="3"></a>3. Installation and Configuration</h1>
Chris Allegretta's avatar
Typo fix part 2, noticed by j.mader@gmail.com.    
Chris Allegretta committed
119 
<h2><a name="3.1"></a>3.1. How do I install the RPM or DEB package?</h2>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135 
<blockquote><p>It's simple really! As root, type <b>rpm -Uvh nano-x.y.z-1.i386.rpm</b> if you have a RedHat-ish system or <b>dpkg -i nano_x.y.z-1.deb</b> if you have a Debian-ish system, where <b>x.y.z</b> is the release of nano. There are other programs to install packages, and if you wish to use those, knock yourself out.</p></blockquote>
<h2><a name="3.2"></a>3.2. Compiling from source: WHAT THE HECK DO I DO NOW?</h2>
<blockquote><p>Okay, take a deep breath, this really isn't hard. Unpack the nano source with a command like:</p>
  <p><b>tar -zxvf nano-x.y.z.tar.gz</b></p>
  <p>If you get error messages about the -z option, try this:</p>
  <p><b>gzip -dc nano-x.y.z.tar.gz | tar xvf -</b></p>
  <p>(again, where x.y.z is the version number in question). Then you need to run configure with any options you might want (if any).</p>
  <p>The average case is this:</p>
  <p><b>cd nano-x.y.z/</b><br>
  <b>./configure</b><br>
  <b>make</b><br>
  <b>make install</b> (as root, of course)</p></blockquote>
<h2><a name="3.3"></a>3.3. Why does everything go into /usr/local?</h2>
<blockquote><p>Well, that's what the <b>configure</b> script defaults to. If you wish to change this, simply do this:</p>
  <p><b>./configure --prefix=/usr</b></p>
  <p>to put nano into /usr/bin when you run <b>make install</b>.</p></blockquote>
David Lawrence Ramsey's avatar
add faq entry about how to open files with names starting with '+'s    
David Lawrence Ramsey committed
136 
<h2><a name="3.4"></a>3.4. I get errors about 'bindtextdomain', 'gettext', and/or 'gettextdomain'. What can I do about it?</h2>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
137 
<blockquote><p>Try doing a <b>./configure --with-included-gettext</b> and see if that solves your problem. You may need to do a <b>make clean; make</b> to get it to work fully.</p></blockquote>
David Lawrence Ramsey's avatar
more miscellaneous documentation updates    
David Lawrence Ramsey committed
138 
<h2><a name="3.5"></a>3.5. nano should automatically run strip on the binary when installing it!</h2>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
139
140
141
142 
<blockquote><p>Actually, it does, but you have to use <b>make install-strip</b>. The default make install does not, and will not, run strip automatically.</p></blockquote>
<h2><a name="3.6"></a>3.6. How can I make the executable smaller? This is too bloated!</h2>
<blockquote><p>Actually, there are several parts of the editor that can be disabled. You can pass arguments to the <b>configure</b> script that disable certain features. Here's a brief list:</p>
  <pre>
David Lawrence Ramsey's avatar
more miscellaneous documentation updates    
David Lawrence Ramsey committed
143
144
145
146
147 
  <b>--disable-tabcomp</b>       Disable tab completion functions
  <b>--disable-justify</b>       Disable justify/unjustify functions
  <b>--disable-speller</b>       Disable spell checker functions
  <b>--disable-help</b>          Disable help functions
  <b>--disable-browser</b>       Disable built-in file browser
David Lawrence Ramsey's avatar
more faq updates: add questions about selecting text in an X terminal    
David Lawrence Ramsey committed
148
149 
  <b>--disable-wrapping</b>      Disable all wrapping of text (and -w flag)
  <b>--disable-mouse</b>         Disable mouse support (and -m flag)
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
150
151
152
153 
  <b>--disable-operatingdir</b>  Disable setting of operating directory</pre>
  <p>There's also the <b>--enable-tiny</b> option which disables everything above, as well as some larger chunks of the program (like the marker code that you use Control-^ to select with). Also, if you know you aren't going to be using other languages you can use <b>--disable-nls</b> to disable internationalization and save a few K to a few dozen K depending on if you have locale support on your system. And finally there's always good old <b>strip</b> to strip all debugging code and code that exists in libraries on your system.</p>
  <p>If, on the other hand, you can't live without bells and whistles, you could try:</p>
  <pre>
David Lawrence Ramsey's avatar
make --enable-extra only define NANO_EXTRA, and update associated    
David Lawrence Ramsey committed
154 
  <b>--enable-extra</b>          Enable extra features, currently only easter eggs
David Lawrence Ramsey's avatar
more miscellaneous documentation updates    
David Lawrence Ramsey committed
155 
  <b>--enable-nanorc</b>         Enable use of .nanorc files
David Lawrence Ramsey's avatar
more faq updates: add questions about selecting text in an X terminal    
David Lawrence Ramsey committed
156
157
158
159 
  <b>--enable-color</b>          Enable color and syntax highlighting
  <b>--enable-multibuffer</b>    Enable having multiple file buffers open
  <b>--enable-all</b>            Enable all of the above features
  <b>--disable-wrapping-as-root</b>
David Lawrence Ramsey's avatar
more miscellaneous documentation updates    
David Lawrence Ramsey committed
160
161 
                          Disable text wrapping by default when the user is
                          root</pre></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
162 
<h2><a name="3.7"></a>3.7. Tell me more about this multibuffer stuff!</h2>
David Lawrence Ramsey's avatar
add miscellaneous minor fixes to the faq, and preemptively update its    
David Lawrence Ramsey committed
163 
<blockquote><p>To use multiple file buffers, you must be using nano 1.1.0 or newer, and you must have configured nano with <b>--enable-multibuffer</b> (use nano -V to check). Then when you want to enable inserting a file into its own buffer instead of into the current file, just hit <b>Meta-F</b>, then insert the file as normal with <b>^R</b>. If you always want files to be loaded into their own buffers, use the <b>--multibuffer</b> or <b>-F</b> flag when you invoke nano.</p>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
164 
  <p>You can move between the buffers you have open with the <b>Meta-&lt;</b> and <b>Meta-&gt;</b> keys, or more easily with <b>Meta-,</b> and <b>Meta-.</b> (clear as mud, right? =-). When you have more than one file buffer open, the ^X shortcut will say &quot;Close&quot;, instead of the normal &quot;Exit&quot; when only one buffer is open.</p></blockquote>
David Lawrence Ramsey's avatar
add verbatim input question and a few minor fixes to the faq    
David Lawrence Ramsey committed
165 
<h2><a name="3.8"></a>3.8. Tell me more about this verbatim input stuff!</h2>
David Lawrence Ramsey's avatar
minor faq updates    
David Lawrence Ramsey committed
166 
<blockquote><p>To use verbatim input, you must be using nano 1.3.1 or newer. When you want to insert a literal character into the file you're editing, such as a control character that nano usually treats as a command, first press <b>Meta-V</b>. (If you're not at a prompt, you'll get the message &quot;Verbatim Input&quot;.) Then press the key(s) that generate the character you want.</p>
David Lawrence Ramsey's avatar
in faq.html, update section 3.8 to mention the new "Unicode Input"    
David Lawrence Ramsey committed
167 
  <p>Alternatively, if you've enabled Unicode support (see section <a href="#5.3">5.3</a>), you can press <b>Meta-V</b> and then type a six-digit hexadecimal code from 000000 to 10FFFF (case-insensitive), and the character with the corresponding value will be inserted instead. The prompt will change to &quot;Unicode Input&quot; when you do this.</p></blockquote>
David Lawrence Ramsey's avatar
add verbatim input question and a few minor fixes to the faq    
David Lawrence Ramsey committed
168
169 
<h2><a name="3.9"></a>3.9. How do I make a .nanorc file that nano will read when I start it?</h2>
<blockquote><p>It's not hard at all! But, your version of nano must have been compiled with <b>--enable-nanorc</b>, and again must be version 1.1.12 or newer (use nano -V to check your version and compiled features). Then simply copy the <b>nanorc.sample</b> that came with the nano source or your nano package (most likely in /usr/doc/nano) to .nanorc in your home directory. If you didn't get one, the syntax is simple. Flags are turned on and off by using the word <b>set</b> and the getopt_long flag for the feature, for example &quot;set nowrap&quot; or &quot;set suspend&quot;.</p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
170
171 
<hr width="100%">
<h1><a name="4"></a>4. Running</h1>
David Lawrence Ramsey's avatar
add faq entry about how to open files with names starting with '+'s    
David Lawrence Ramsey committed
172 
<h2><a name="4.1"></a>4.1. How do I open a file with a name beginning with '+' from the command line?</h2>
David Lawrence Ramsey's avatar
in doc/faq.html, update section 4.1 to describe how to open files with    
David Lawrence Ramsey committed
173 
<blockquote><p>If a command line option that begins with '+' is followed by another option, the former is always treated as a starting line and column number and the latter is always treated as a filename. If a command line option that begins with '+' isn't followed by another option, it's always treated as a filename. Examples:</p>
David Lawrence Ramsey's avatar
make the latest faq entry more accurate    
David Lawrence Ramsey committed
174
175 
  <p>To open '+filename.txt' starting on line 1: <b>nano +filename.txt</b><br>
  To open '+filename.txt' starting on line 10: <b>nano +10 +filename.txt</b><br>
David Lawrence Ramsey's avatar
in doc/faq.html, update section 4.1 to describe how to open files with    
David Lawrence Ramsey committed
176
177 
  To open '+filename.txt' starting on line 1, column 20: <b>nano +,20 +filename.txt</b><br>
  To open '+filename.txt' starting on line 10, column 20: <b>nano +10,20 +filename.txt</b><br>
David Lawrence Ramsey's avatar
make the latest faq entry more accurate    
David Lawrence Ramsey committed
178 
  To open '+filename.txt' starting on line 1 and 'filename.txt' starting on line 10 (if nano has been compiled with multibuffer support): <b>nano +1 +filename.txt +20 filename.txt</b></p></blockquote>
David Lawrence Ramsey's avatar
per Benno Schulenberg's patch (with a few tweaks by me), add a new    
David Lawrence Ramsey committed
179 
<h2><a name="4.2"></a>4.2. Ack! My Backspace/Delete/Enter/Meta/double bucky key doesn't seem to work! What can I do?</h2>
David Lawrence Ramsey's avatar
more miscellaneous documentation updates    
David Lawrence Ramsey committed
180 
<blockquote><p>Try setting your $TERM variable to 'vt100'. nano doesn't yet support every term entry under the sun.</p>
David Lawrence Ramsey's avatar
documentation fix: list sh as an example of a Bourne shell    
David Lawrence Ramsey committed
181 
  <p>Bourne shell users (bash and sh): <b>export TERM=vt100</b><br>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
182 
  C Shell users (tcsh and csh): <b>setenv TERM vt100</b></p></blockquote>
David Lawrence Ramsey's avatar
readd the option to turn the keypad off by default from nano 1.2.x, with    
David Lawrence Ramsey committed
183 
<h2><a name="4.3"></a>4.3. Ack! My numeric keypad's keys don't work properly when NumLock is off! What can I do?</h2>
David Lawrence Ramsey's avatar
add miscellaneous minor fixes to the faq, and preemptively update its    
David Lawrence Ramsey committed
184 
<blockquote><p>You can use the <b>-K</b> or <b>--rebindkeypad</b> options on the command line, or add the line <b>set rebindkeypad</b> to your .nanorc. However, nano's mouse support won't work properly if you do any of these things.</p></blockquote>
David Lawrence Ramsey's avatar
drop the Meta-] and Meta-[ aliases for Meta-} and Meta-}, and change the    
David Lawrence Ramsey committed
185 
<h2><a name="4.4"></a>4.4. Ack! When I hold down a Meta key combination for a while, the character of the held key gets inserted now and then. What gives?</h2>
David Lawrence Ramsey's avatar
per Benno Schulenberg's patch (with a few tweaks by me), add a new    
David Lawrence Ramsey committed
186 
<blockquote><p>This is a bug in the terminal, not in nano. When a key is repeating faster than nano can process it, the keyboard buffer becomes full and starts dropping incoming keystrokes. Unfortunately, it doesn't just drop whole keystrokes; it can also drop parts of multibyte key combinations, resulting in nano's receiving a wrong key.</p></blockquote>
David Lawrence Ramsey's avatar
drop the Meta-] and Meta-[ aliases for Meta-} and Meta-}, and change the    
David Lawrence Ramsey committed
187 
<h2><a name="4.5"></a>4.5. How do I type the F13-F16 keys shown in the help browser? My keyboard only has F1-F12!</h2>
David Lawrence Ramsey's avatar
in faq.html, add a new section 4.4, and move all section 4 entries after    
David Lawrence Ramsey committed
188 
<blockquote><p>It depends on the terminal type you're using. On some terminals, such as the FreeBSD console, xterm, konsole, and gnome-terminal, Shift-F1 to Shift-F4 will generate F13 to F16. On other terminals, such as the Linux console, rxvt, and Eterm, Shift-F3 to Shift-F6 will generate F13 to F16.</p></blockquote>
David Lawrence Ramsey's avatar
more miscellaneous documentation updates    
David Lawrence Ramsey committed
189 
<h2><a name="4.6"></a>4.6. nano crashes when I type &lt;insert keystroke here&gt;!</h2>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
190 
<blockquote><p>If you aren't trying some bizarre keystroke combination with some bizarre $TERM entry, chances are you have found a bug. You are welcome to submit it to the <a href="mailto:nano-devel@gnu.org">nano-devel</a> list or to <a href="mailto:nano@nano-editor.org">nano@nano-editor.org</a>.</p></blockquote>
David Lawrence Ramsey's avatar
more miscellaneous documentation updates    
David Lawrence Ramsey committed
191 
<h2><a name="4.7"></a>4.7. nano crashes when I resize my window. How can I fix that?</h2>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
192 
<blockquote><p>Older versions of nano had this problem, please upgrade to a newer version (at least 0.9.9 would be great, 0.9.12 is recommended).</p></blockquote>
David Lawrence Ramsey's avatar
remove the workaround for glibc 2.2.3's broken regexec(), and replace it    
David Lawrence Ramsey committed
193
194
195 
<h2><a name="4.8"></a>4.8. [version 1.3.12 and later] I'm using glibc 2.2.3, and nano crashes when I use color support or do regular expression searches. How can I fix that?</h2>
<blockquote><p>It's a bug in glibc 2.2.3. You should upgrade to at least glibc 2.2.4.</p></blockquote>
<h2><a name="4.9"></a>4.9. [version 1.1.12 and earlier] Why does nano show ^\ in the shortcut list instead of ^J?</h2>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
196 
<blockquote><p>The help (^G) and justify (^J) function were among the last to be written. To show the improvements that nano had over Pico (go to line # and replace), ^_ and ^\ were put on the shortcut list. Later, ^G came back in place of ^_ as it proved to be very valuable for new Unix users. If you use the <b>-p</b> option to nano (or hit Meta-P) you will get the same shortcuts at the bottom as Pico.</p></blockquote>
David Lawrence Ramsey's avatar
remove the workaround for glibc 2.2.3's broken regexec(), and replace it    
David Lawrence Ramsey committed
197 
<h2><a name="4.10a"></a>4.10a. [version 1.1.12 and earlier] When I type in a search string, the string I last searched for is already in front of my cursor! What happened?!</h2>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
198 
<blockquote><p>In nano version 0.9.20, the default is to have a completely consistent user interface across all user input functions. This means that regardless of whether you're being asked for a filename to insert or write, or a string to search for, the previous value is already inserted before the cursor. If you prefer the old behavior, use the Pico emulation mode (-p or --pico) or just hit Meta-P while in nano (see the ^G help text for more details).</p></blockquote>
David Lawrence Ramsey's avatar
remove the workaround for glibc 2.2.3's broken regexec(), and replace it    
David Lawrence Ramsey committed
199 
<h2><a name="4.10b"></a>4.10b. [version 1.1.99pre1 and later] Hey, the search string behavior has reverted, it's now like Pico, what happened to the consistency?</h2>
David Lawrence Ramsey's avatar
add miscellaneous minor fixes to the faq, and preemptively update its    
David Lawrence Ramsey committed
200 
<blockquote><p>It was decided that consistency was nice, but people are used to Pico's inconsistent behavior. Also, in version 1.1.99pre1, search and replace history was introduced. If you wish to edit your previous search/replace entry (or any previous entry), you can do so by hitting the up arrow to cycle through your history. This method allows the best of both worlds: You don't need to erase the previous string if you want to enter a new one, but you can with one keystroke recall previous entries for editing. Therefore there is now no "Pico mode", nano is and has always been a Pico <b>clone</b>, and clones by default should be compatible.</p></blockquote>
David Lawrence Ramsey's avatar
remove the workaround for glibc 2.2.3's broken regexec(), and replace it    
David Lawrence Ramsey committed
201 
<h2><a name="4.11"></a>4.11. How do I make nano my default editor (in Pine, mutt, etc.)?</h2>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
202
203 
<blockquote><p>You need to make nano your $EDITOR. If you want this to be saved, you should put a line like this in your <b>.bashrc</b> if you use bash (or <b>.zshrc</b> if you believe in zsh):</p>
  <p><b>export EDITOR=/usr/local/bin/nano</b></p>
David Lawrence Ramsey's avatar
in faq.html, add minor punctuation and wording fixes    
David Lawrence Ramsey committed
204 
  <p>or, if you use tcsh, put this in your <b>.cshrc</b> file:</p>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
205
206 
  <p><b>setenv EDITOR /usr/local/bin/nano</b></p>
  <p>Change /usr/local/bin/nano to wherever nano is installed on your system. Type &quot;which nano&quot; to find out. This will not take effect until the next time you login. So log out and back in again.</p>
David Lawrence Ramsey's avatar
in faq.html, add minor punctuation and wording fixes    
David Lawrence Ramsey committed
207 
  <p>Then, on top of that, if you use Pine, you must go into setup (type <b>S</b> at the main menu), and then configure (type <b>C</b>). Hit Enter on the lines that say:</p>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
208
209
210 
  <p><b>[ ] enable-alternate-editor-cmd</b><br>
  <b>[ ] enable-alternate-editor-implicitly</b></p>
  <p>Then exit (<b>E</b>) and select Yes (<b>Y</b>).</p>
David Lawrence Ramsey's avatar
in faq.html, add minor punctuation and wording fixes    
David Lawrence Ramsey committed
211 
  <p>If you're a mutt user, you should see an effect immediately the next time you log in. No further configuration is needed. However, if you want to let people know you use nano to compose your email messages, you can put a line like this in your <b>.muttrc</b>:</p>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
212
213 
  <p><b>my_hdr X-Composer: nano x.y.z</b></p>
  <p>Again, replace x.y.z with the version of nano you use.</p></blockquote>
David Lawrence Ramsey's avatar
remove the workaround for glibc 2.2.3's broken regexec(), and replace it    
David Lawrence Ramsey committed
214 
<h2><a name="4.12"></a>4.12. I've compiled nano with color support, but I don't see any color when I run it!</h2>
David Lawrence Ramsey's avatar
add verbatim input question and a few minor fixes to the faq    
David Lawrence Ramsey committed
215 
<blockquote><p>If you want nano to actually use color, you have to specify the color configurations you want it to use in your .nanorc. Some example configurations are in the <b>nanorc.sample</b> that comes with the nano source or your nano package. See Section <a href="#3.9">3.9</a>.</p></blockquote>
David Lawrence Ramsey's avatar
remove the workaround for glibc 2.2.3's broken regexec(), and replace it    
David Lawrence Ramsey committed
216 
<h2><a name="4.13"></a>4.13. How do I select text for or paste text from the clipboard in an X terminal when I'm running nano in one and nano's mouse support is turned on?</h2>
David Lawrence Ramsey's avatar
in faq.html, update section 4.10 to mention that pasting from the X    
David Lawrence Ramsey committed
217 
<blockquote><p>Try holding down the Shift key and selecting or pasting the text as you normally would.</p></blockquote>
David Lawrence Ramsey's avatar
in doc/faq.html, add a new section 4.14 by John M. Gabriele, with a few    
David Lawrence Ramsey committed
218
219 
<h2><a name="4.14"></a>4.14. When I paste text into a document, each line gets indented further than the last. Why does nano do this, and how can I avoid it?</h2>
<blockquote><p>You have the autoindent feature turned on. Hit Meta-I to turn it off, paste your text, and then hit Meta-I again to turn it back on.</p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
220
221
222 
<hr width="100%">
<h1><a name="5"></a>5. Internationalization</h1>
<h2><a name="5.1"></a>5.1. There's no translation for my language!</h2>
David Lawrence Ramsey's avatar
in doc/faq.html, update links to the Free Translation Project    
David Lawrence Ramsey committed
223
224 
<blockquote><p>On June of 2001, GNU nano entered the <a href="http://translationproject.org/html/welcome.html">Free Translation Project</a> and since then, translations should be managed from there.</p>
  <p>If there isn't a translation for your language, you could ask <a href="http://translationproject.org/team/">your language team</a> to translate nano, or better still, join your team and do it yourself. Joining a team is easy. You just need to ask the <a href="mailto:coordinator@translationproject.org">TP coordinator</a> to add you to your team, and send a <a href="http://translationproject.org/disclaim.txt">translation disclaimer to the FSF</a> (this is necessary as nano is an official GNU package, but it does <b>not</b> mean that you transfer the rights of your work to the FSF, it's just so the FSF can legally manage them).</p>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
225
226
227 
  <p>In any case, translating nano is very easy. Just grab the <b>nano.pot</b> file from the latest and greatest nano distribution (it's in the <b>po/</b> directory) and translate each line into your native language on the <b>msgstr</b> line. When you're done, you should send it to the TP's central po repository.</p></blockquote>
<h2><a name="5.2"></a>5.2. I don't like the translation for &lt;x&gt; in my language. How can I fix it?</h2>
<blockquote><p>The best way would probably be to e-mail the person listed in the <code>Last-Translator:</code> field in the <b>&lt;your_language&gt;.po</b> file with your suggested corrections and they can make the changes reach the nano-devel list.</p></blockquote>
David Lawrence Ramsey's avatar
in faq.html, add a new section 5.3 to explain the status of nano's    
David Lawrence Ramsey committed
228 
<h2><a name="5.3"></a>5.3. What is the status of Unicode support?</h2>
David Lawrence Ramsey's avatar
add miscellaneous minor fixes to the faq, and preemptively update its    
David Lawrence Ramsey committed
229 
<blockquote><p>In version 1.3.12 or later, Unicode should be usable. With your terminal, locale (LC_ALL and similar environment variables), and encoding configured to properly support UTF-8, you should be able to enter and save Unicode text.</p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
230
231
232 
<hr width="100%">
<h1><a name="6"></a>6. Advocacy and Licensing</h1>
<h2><a name="6.1"></a>6.1. Why should I use nano instead of Pico?</h2>
David Lawrence Ramsey's avatar
in faq.html, add minor punctuation and wording fixes, and update various    
David Lawrence Ramsey committed
233 
<blockquote><p>There are many reasons to use nano instead of Pico. A more complete list can be found at the <a href="http://www.nano-editor.org/">nano homepage</a>.</p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
234 
<h2><a name="6.2"></a>6.2. Why should I use Pico instead of nano?</h2>
David Lawrence Ramsey's avatar
in faq.html, add minor punctuation and wording fixes, and update various    
David Lawrence Ramsey committed
235
236
237
238 
<blockquote><p>Again, check out the <a href="http://www.nano-editor.org/">nano homepage</a> for a good summary of reasons. It really is a matter of personal preference as to which editor you should use. If you're the type of person who likes using the original version of a program, then Pico is the editor for you. If you don't mind sacrificing mailer integration with Pine, and are looking for a few more features, as well as a 'better' license in terms of adding your own changes, nano is the way to go.</p><p>Note that the last of these no longer applies to the new version of Pine, <a href="http://www.washington.edu/alpine/">Alpine</a>, which is under the Apache License, version 2.0.</p></blockquote>
<h2><a name="6.3"></a>6.3. What is so bad about the older Pine license?</h2>
<blockquote><p>The U of W license for older versions of Pine and Pico is not considered truly Free Software according to both the Free Software Foundation and the <a href="http://www.debian.org/social_contract#guidelines">Debian Free Software Guidelines</a>. The main problem regards the limitations on distributing derived works: according to UW, you can distribute their software, and you can modify it, but you can not do both, i.e. distribute modified binaries.</p></blockquote>
<h2><a name="6.4"></a>6.4. Okay, well, what mail program should I use then?</h2>
Chris Allegretta's avatar
faq.html: Updates for Alpine, subversion access and Savannah.    
Chris Allegretta committed
239
240 
<blockquote><p>If you are looking to use a Free Software program similar to Pine, and Emacs is not your thing, you should definitely take a look at <a href="http://www.mutt.org/">mutt</a>. It is a full-screen, console based mail program that actually has a lot more flexibility than Pine, but has a keymap included in the distribution that allows you to use the same keystrokes as Pine would to send and receive mail. It's also under the GNU General Public License, version 2.0.<P>
Of course, due to the license change you can now use the <A HREF="http://www.washington.edu/alpine/">Alpine distribution</A> of PINE as it is now considered Free Software, but you would be sacrificing many of nano's features to do so.</p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
241
242 
<hr width="100%">
<h1><a name="7"></a>7. Miscellaneous</h1>
David Lawrence Ramsey's avatar
more miscellaneous documentation updates    
David Lawrence Ramsey committed
243
244 
<h2><a name="7.1"></a>7.1. nano-related mailing lists.</h2>
<blockquote><p>There are three mailing lists for nano hosted at <a href="http://savannah.gnu.org/">Savannah</a>, info-nano, help-nano and nano-devel. info-nano is a very low traffic list where new versions of nano are announced (surprise!). help-nano is for getting help with the editor without needing to hear all of the development issues surrounding it. nano-devel is a normally low, sometimes high traffic list for discussing the present and future development of nano. Here are links to where you can sign up for a given list:</p>
Chris Allegretta's avatar
DLR and DB's latest fixes    
Chris Allegretta committed
245
246
247 
  <p>info-nano - <a href="http://mail.gnu.org/mailman/listinfo/info-nano/">http://mail.gnu.org/mailman/listinfo/info-nano/</a><br>
  help-nano - <a href="http://mail.gnu.org/mailman/listinfo/help-nano/">http://mail.gnu.org/mailman/listinfo/help-nano/</a><br>
  nano-devel - <a href="http://mail.gnu.org/mailman/listinfo/nano-devel/">http://mail.gnu.org/mailman/listinfo/nano-devel/</a></p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
248 
<h2><a name="7.2"></a>7.2. I want to send the development team a big load of cash (or just a thank you).</h2>
David Lawrence Ramsey's avatar
update faq.html for the 2.0 branch of nano    
David Lawrence Ramsey committed
249 
<blockquote><p>That's fine. Send it <a href="mailto:nano-devel@gnu.org">our way</a>! Better yet, fix a <a href="http://www.nano-editor.org/dist/v2.0/BUGS">bug</a> in the program or implement a <a href="http://www.nano-editor.org/dist/v2.0/TODO">cool feature</a> and send us that instead (though cash is fine too).</p></blockquote>
Chris Allegretta's avatar
faq.html: Updates for Alpine, subversion access and Savannah.    
Chris Allegretta committed
250
251
252
253 
<h2><a name="7.3"></a>7.3. How do I submit a bug report or patch?</h2>
<blockquote>
<p>The best place to submit bugs is to the <A HREF="https://savannah.gnu.org/bugs/?group=nano">Savannah bug tracker</A> as you can check whether the bug you are submitting has already been submitted.
<p>Please submit patches for nano via the <a href="https://savannah.gnu.org/patch/?group=nano">Savannah project's patch manager</a> for the nano project.</p></blockquote>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
254 
<h2><a name="7.4"></a>7.4. How do I join the development team?</h2>
Chris Allegretta's avatar
faq.html: Updates for Alpine, subversion access and Savannah.    
Chris Allegretta committed
255
256 
<blockquote><p>The easiest way is to consistently send in good patches that add some needed functionality, fix a bug or two and/or make the program more optimized/efficient. Then ask nicely and you will probably be added to the Savannah development list and be given SVN write access after awhile. There is a lot of responsibility that goes along with being a team member, so don't think it's just something to add to your resume.</p></blockquote>
<h2><a name="7.5"></a>7.5. Can I have write access to the subversion tree?</h2>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
257
258 
<blockquote><p>Re-read Section <a href="#7.4">7.4</a> and you should know the answer.</p></blockquote>
<h2><a name="8"></a>8. ChangeLog</h2>
David Lawrence Ramsey's avatar
update maintenance information    
David Lawrence Ramsey committed
259 
<blockquote><p>2007/12/21 - Update maintainer information. (DLR)<br>
Chris Allegretta's avatar
faq.html: Updates for Alpine, subversion access and Savannah.    
Chris Allegretta committed
260 
2008/03/16 - Update docs to refer to subversion instead of CVS, add more words about Apline, and refer to Savannah for bugs and patches.  (chrisa)
David Lawrence Ramsey's avatar
update maintenance information    
David Lawrence Ramsey committed
261 
2007/12/09 - Add minor punctuation and wording fixes, and update various sections to account for Alpine. (DLR)<br>
David Lawrence Ramsey's avatar
in faq.html, add minor punctuation and wording fixes, and update various    
David Lawrence Ramsey committed
262 
2007/08/26 - Update links to the Free Translation Project. (DLR)<br>
David Lawrence Ramsey's avatar
in doc/faq.html, update links to the Free Translation Project    
David Lawrence Ramsey committed
263 
2007/07/29 - Update RPM links for nano 2.0.x. (DLR)<br>
David Lawrence Ramsey's avatar
in faq.html, update RPM links for nano 2.0.x    
David Lawrence Ramsey committed
264 
2007/04/18 - Add a new section 4.14 to explain how autoindent affects pasted text. (John M. Gabriele, minor tweaks by DLR)<br>
David Lawrence Ramsey's avatar
in doc/faq.html, add a new section 4.14 by John M. Gabriele, with a few    
David Lawrence Ramsey committed
265 
2007/04/04 - Update email address. (DLR)<br>
David Lawrence Ramsey's avatar
update email address    
David Lawrence Ramsey committed
266 
2007/01/01 - Update section 4.1 to describe how to open files with names beginning with '+' at specified columns as well as lines. (DLR)<br>
David Lawrence Ramsey's avatar
in doc/faq.html, update section 4.1 to describe how to open files with    
David Lawrence Ramsey committed
267 
2006/11/25 - Add miscellaneous wording and capitalization fixes. (DLR)<br>
David Lawrence Ramsey's avatar
more miscellaneous documentation updates    
David Lawrence Ramsey committed
268 
2006/10/28 - Update various links for the 2.0 branch of nano. (DLR)<br>
David Lawrence Ramsey's avatar
update faq.html for the 2.0 branch of nano    
David Lawrence Ramsey committed
269 
2006/10/06 - Update the question in section 4.13 to match the version of it in the answer section. (DLR)<br>
David Lawrence Ramsey's avatar
in faq.html, update the question in section 4.13 to match the version of    
David Lawrence Ramsey committed
270 
2006/07/25 - Update section 5.3 again to not state &quot;the latest development version&quot; before 1.3.12, as it's no longer accurate. Also add some minor spacing fixes. (DLR)<br>
David Lawrence Ramsey's avatar
add miscellaneous minor fixes to the faq, and preemptively update its    
David Lawrence Ramsey committed
271 
2006/06/12 - Update section 5.3, due to the display fix for two-column Unicode characters. (DLR)<br>
David Lawrence Ramsey's avatar
remove the workaround for glibc 2.2.3's broken regexec(), and replace it    
David Lawrence Ramsey committed
272
273 
2006/06/05 - Add a new section 4.8, and move all section 4 entries after it down one number, to explain how to deal with glibc 2.2.3's crashes involving extended regular expressions. (DLR)<br>
2006/06/04 - Add minor punctuation, wording, and typo fixes. (DLR)<br>
David Lawrence Ramsey's avatar
in faq.html, add minor punctuation and wording fixes    
David Lawrence Ramsey committed
274 
2006/05/27 - Update section 3.8 to mention the new "Unicode Input" prompt, and how Unicode input only works when Unicode support is enabled. (DLR)<br>
David Lawrence Ramsey's avatar
in faq.html, update section 3.8 to mention the new "Unicode Input"    
David Lawrence Ramsey committed
275 
2006/05/12 - Remove section 4.4, and move all section 4 entries after it up one number, since it no longer applies. Meta-] and Meta-[ are no longer used to indent and unindent marked text, since they require that the bracket matching key change to Ctrl-], which is used as the telnet escape key (found by Chris). Also, make the link to the nano CVS page a bit more readable. (DLR)<br>
David Lawrence Ramsey's avatar
drop the Meta-] and Meta-[ aliases for Meta-} and Meta-}, and change the    
David Lawrence Ramsey committed
276 
2006/05/08 - Add a new section 4.5, and move all section 4 entries after it down one number, to explain a problem that can occur when holding down keys to generate Meta sequences. Also add a few more capitalization and wording fixes. (Benno Schulenberg, minor tweaks by DLR)<br>
David Lawrence Ramsey's avatar
per Benno Schulenberg's patch (with a few tweaks by me), add a new    
David Lawrence Ramsey committed
277 
2006/05/01 - Add a new section 4.4, and move all section 4 entries after it down one number, to explain how to deal with problems typing Meta-[. Also add a few capitalization and wording fixes. (DLR)<br>
David Lawrence Ramsey's avatar
in faq.html, add a new section 4.4, and move all section 4 entries after    
David Lawrence Ramsey committed
278 
2006/04/14 - Clarify section 1.4: help menu -> help text display. (DLR, suggested by Benno Schulenberg)<br>
David Lawrence Ramsey's avatar
clarify some help text and documentation    
David Lawrence Ramsey committed
279 
2006/03/16 - Update the Free Translation Project's address, change the character set to UTF-8, and remove broken links to contributed RedHat nano packages. (DLR)<br>
David Lawrence Ramsey's avatar
in faq.html, update the Free Translation Project's address    
David Lawrence Ramsey committed
280 
2005/11/21 - Clarify section 5.3 to better explain how to enable Unicode support, and remove the mention of quirks, since they turned out to not be a nano problem. (Mike Frysinger and DLR)<br>
David Lawrence Ramsey's avatar
in faq.html, clarify section 5.3 to better explain how to enable Unicode    
David Lawrence Ramsey committed
281 
2005/11/19 - Add a new section 5.3 to explain the status of nano's Unicode support. (Mike Frysinger, minor tweaks by DLR)<br>
David Lawrence Ramsey's avatar
in faq.html, add a new section 5.3 to explain the status of nano's    
David Lawrence Ramsey committed
282 
2005/08/27 - Update email address. (DLR)<br>
David Lawrence Ramsey's avatar
more email address updates    
David Lawrence Ramsey committed
283 
2005/08/10 - Add a new section 4.3, and move all section 4 entries after it down one number, to explain how to deal with numeric keypad problems. (DLR)<br>
David Lawrence Ramsey's avatar
cover the full range of Unicode    
David Lawrence Ramsey committed
284 
2005/08/08 - Update section 3.8 to mention that verbatim input mode now takes a six-digit hexadecimal number. (DLR)<br>
David Lawrence Ramsey's avatar
readd the option to turn the keypad off by default from nano 1.2.x, with    
David Lawrence Ramsey committed
285 
2005/07/04 - Update section 4.10 to mention that pasting from the X clipboard via the middle mouse button also works when the Shift key is used. (DLR)<br>
David Lawrence Ramsey's avatar
make --enable-extra only define NANO_EXTRA, and update associated    
David Lawrence Ramsey committed
286
287
288 
2005/06/15 - Update description of --enable-extra, and add missing line breaks. (DLR)<br>
2005/06/13 - Minor capitalization and wording fixes. (DLR)<br>
2005/06/08 - Updated section 1.1 to mention the current maintainer. (DLR)<br>
David Lawrence Ramsey's avatar
add faq entry about how to open files with names starting with '+'s    
David Lawrence Ramsey committed
289
290
291 
2005/03/09 - Added question about opening files with names beginning with '+'s, and added a few more miscellaneous cosmetic fixes. (DLR)<br>
2005/01/03 - Removed now-inaccurate note about verbatim input's not working at prompts, and update its description to mention that it handles hexadecimal values now. (DLR)<br>
2004/11/21 - Listed sh as an example of a Bourne shell. (DLR)<br>
David Lawrence Ramsey's avatar
more faq updates: add questions about selecting text in an X terminal    
David Lawrence Ramsey committed
292 
2004/11/05 - Fixed inaccuracy: Pico compatibility mode was made the default in nano 1.1.99pre1, not 1.2.2. Also added question about how to type F13-F16 on terminals lacking keys past F12 (suggested by Chris), question about how to select text for the clipboard in X terminals with nano's mouse support turned on (answer found by Joseph Birthisel), and misc. fixes and link updates. (DLR)<br>
David Lawrence Ramsey's avatar
work around the NumLock glitch    
David Lawrence Ramsey committed
293 
2004/04/07 - Removed NumLock glitch question, as it's no longer needed. (DLR)<br>
David Lawrence Ramsey's avatar
fix minor FAQ inaccuracy    
David Lawrence Ramsey committed
294 
2004/01/30 - Fixed inaccuracy: multibuffer mode was first in nano 1.1.0, not 1.1.12. (DLR)<br>
David Lawrence Ramsey's avatar
add miscellaneous minor fixes to the faq, and preemptively update its    
David Lawrence Ramsey committed
295 
2003/12/31 - Added question about the new verbatim input function, and a few minor fixes. Removed reference to &quot;set pico&quot; (DLR).<br>
David Lawrence Ramsey's avatar
faq update for inability to see color when nano is compiled w/color support    
David Lawrence Ramsey committed
296 
2003/07/02 - Added question about nano's not showing color when it's compiled with color support (DLR; suggested by Jordi).<br>
David Lawrence Ramsey's avatar
add verbatim input question and a few minor fixes to the faq    
David Lawrence Ramsey committed
297 
2003/02/23 - Updated RPM links for nano 1.2.x (DLR).<br>
David Lawrence Ramsey's avatar
faq update for inability to see color when nano is compiled w/color support    
David Lawrence Ramsey committed
298 
2003/01/16 - Split section 4.5 into 4.5a and 4.5b for search string behavior. Added --enable-all docs.<br>
Chris Allegretta's avatar
- faq.html: Added docs about the new unified search string interface and...    
Chris Allegretta committed
299 
2002/12/28 - More misc. fixes (David Benbennick, DLR).<br>
Chris Allegretta's avatar
DLR and DB's latest fixes    
Chris Allegretta committed
300 
2002/10/25 - Misc. fixes and link updates (DLR).<br>
David Lawrence Ramsey's avatar
documentation updates    
David Lawrence Ramsey committed
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322 
2002/09/10 - Another typo fix (DLR).<br>
2002/05/15 - Typo fix (DLR).<br>
2001/12/26 - Misc. fixes (Aaron S. Hawley, DLR).<br>
2001/10/02 - Update for Free Translation Project.<br>
2001/10/02 - Assorted fixes, Debian additions.<br>
2001/06/30 - Silly typo fix.<br>
2001/05/05 - Spelling fixes by David Lawrence Ramsey.<br>
2001/05/02 - Misc fixes.<br>
2001/03/26 - Typo fix in an URL.<br>
2001/02/17 - Advocacy updates.<br>
2001/02/15 - Added GNU notes for 0.9.99pre3.<br>
2001/02/06 - Typo fixes.<br>
2001/01/14 - Added note about NumLock glitch.<br>
2001/01/10 - Linux -&gt; GNU/Linux.<br>
2001/01/09 - Added &quot;making exe smaller&quot; section.<br>
2000/12/19 - Typo and assorted error fixes.<br>
2000/11/28 - Added blurb about make install-strip.<br>
2000/11/19 - Changed Debian frozen to stable.<br>
2000/11/18 - Previous string display (4.5).<br>
2000/09/27 - Moved addresses to nano-editor.org.<br>
2000/06/31 - Initial framework.</p></blockquote>
<p>$Id$</p>
Chris Allegretta's avatar
Added FAQ    
Chris Allegretta committed
323
324 
</body>
</html>