blob: fc0ea4bfd77fc5498e7a76de16da8c6c621c2a6a [file] [log] [blame]
Chris Allegrettaa2ea1932000-06-06 05:53:49 +00001
Benno Schulenberge332d2d2016-11-13 20:35:19 +01002 GNU nano -- an enhanced clone of the Pico text editor
Chris Allegretta6e285372001-04-07 17:50:03 +00003
Chris Allegretta1e6fb082000-12-27 15:46:22 +00004Overview
Chris Allegrettaa2ea1932000-06-06 05:53:49 +00005
Benno Schulenberge332d2d2016-11-13 20:35:19 +01006 The nano project was started because of a few "problems" with the
7 wonderfully easy-to-use and friendly Pico text editor.
Chris Allegretta1e6fb082000-12-27 15:46:22 +00008
Benno Schulenberge332d2d2016-11-13 20:35:19 +01009 First and foremost was its license: the Pine suite does not use
10 the GPL or a GPL-friendly license, and has unclear restrictions on
11 redistribution. Because of this, Pine and Pico are not included
12 with many GNU/Linux distributions. Also, other features (like
13 go-to-line-number or search-and-replace) were unavailable until
14 recently or require a command-line flag. Yuck.
Chris Allegretta1e6fb082000-12-27 15:46:22 +000015
Benno Schulenberge332d2d2016-11-13 20:35:19 +010016 nano aims to solve these problems by emulating the functionality of
17 Pico as closely as possible while addressing the problems above and
18 providing other extra functionality.
Chris Allegrettac46dd812001-02-14 14:28:27 +000019
Benno Schulenberge332d2d2016-11-13 20:35:19 +010020 The nano editor is an official GNU package. For more information on
21 GNU and the Free Software Foundation, please see http://www.gnu.org/.
David Lawrence Ramseyd5be9472004-01-10 06:12:04 +000022
Chris Allegrettaa2ea1932000-06-06 05:53:49 +000023How to compile and install nano
24
Benno Schulenberge332d2d2016-11-13 20:35:19 +010025 Download the nano source code, then:
Benno Schulenbergd4e1d312015-02-21 09:45:53 +000026
Benno Schulenberge332d2d2016-11-13 20:35:19 +010027 tar xvzf nano-x.y.z.tar.gz
28 cd nano-x.y.z
29 ./configure
30 make
31 make install
David Lawrence Ramseyd5be9472004-01-10 06:12:04 +000032
Benno Schulenberge332d2d2016-11-13 20:35:19 +010033 It's that simple. Use --prefix with configure to override the
34 default installation directory of /usr/local.
Benno Schulenbergd4e1d312015-02-21 09:45:53 +000035
Benno Schulenberge332d2d2016-11-13 20:35:19 +010036 If you haven't configured with the --disable-nanorc option, after
Benno Schulenbergf1b87f92016-12-24 17:49:14 +010037 installation you may want to copy the doc/sample.nanorc file to
Benno Schulenberge332d2d2016-11-13 20:35:19 +010038 your home directory, rename it to ".nanorc", and then edit it
39 according to your taste.
David Lawrence Ramseyd5be9472004-01-10 06:12:04 +000040
Chris Allegrettaa2ea1932000-06-06 05:53:49 +000041Web Page
42
Jordi Mallachc2b199e2016-06-20 19:44:56 +020043 https://nano-editor.org/
David Lawrence Ramseyd5be9472004-01-10 06:12:04 +000044
Benno Schulenberge332d2d2016-11-13 20:35:19 +010045Mailing Lists
Chris Allegrettaa2ea1932000-06-06 05:53:49 +000046
Benno Schulenberge332d2d2016-11-13 20:35:19 +010047 There are three nano-related mailing-lists.
David Lawrence Ramseyf0b30092004-01-10 06:02:05 +000048
Benno Schulenbergd4e1d312015-02-21 09:45:53 +000049 + info-nano@gnu.org is a very low traffic list used to announce
Benno Schulenberge332d2d2016-11-13 20:35:19 +010050 new nano versions or other important info about the project.
Chris Allegrettadb3dc572002-02-01 13:40:34 +000051 + help-nano@gnu.org is for those seeking to get help without
Benno Schulenbergd4e1d312015-02-21 09:45:53 +000052 wanting to hear about the technical details of its development.
Benno Schulenberge332d2d2016-11-13 20:35:19 +010053 + nano-devel@gnu.org is the list used by the people that make nano
54 and a general development discussion list, with moderate traffic.
David Lawrence Ramseyf0b30092004-01-10 06:02:05 +000055
Benno Schulenberge332d2d2016-11-13 20:35:19 +010056 To subscribe, send email to <name>-request@gnu.org with a subject
57 of "subscribe", where <name> is the list you want to subscribe to.
David Lawrence Ramseyf0b30092004-01-10 06:02:05 +000058
Benno Schulenberge332d2d2016-11-13 20:35:19 +010059Bug Reports
60
61 To report a bug, please file a description of the problem on nano's
62 bug tracker (https://savannah.gnu.org/bugs/?group=nano -- hover on
63 "Bugs", then click "Submit new"). The issue may have already been
64 reported, so please look first.
Chris Allegrettaa2ea1932000-06-06 05:53:49 +000065
66Current Status
67
Benno Schulenberg49fc5282016-08-14 21:18:00 +020068 GNU nano has reached its seventh milestone, 2.6.x. Since 2.5.0, it
69 is a "rolling" release: bug fixing and development go hand in hand.