INSTRUCTIONS FOR COMPILING AND INSTALLING NANO FROM GIT ======================================================= The latest changes and fixes for GNU nano are available via git, but building this needs a bit more care than the official tarballs. Prerequisites ------------- To successfully compile GNU nano from git, you'll need the following packages: - autoconf (version >= 2.69) - automake (version >= 1.14) - autopoint (version >= 0.18.3) - gettext (version >= 0.18.3) - git (version >= 2.7.4) - groff (version >= 1.12) - pkg-config (version >= 0.22) - texinfo (version >= 4.0) - gcc (any version) - make (any version) If you want UTF-8 support, you will also need libncursesw5-dev installed (version >= 5.7), or libslang2-dev (version >= 2.0) if you use --with-slang. These should all be available in your distro's package manager or software center, or otherwise on any GNU mirror. Download the source ------------------- To obtain the current nano development branch (called 'master'), use the following command. It will create in your current working directory a subdirectory called 'nano' containing a copy of all of the files: $ git clone git://git.savannah.gnu.org/nano.git nano Generate the configure script ----------------------------- Once you have the sources in the "nano" directory, $ cd nano $ ./autogen.sh This will set up a configure script and a Makefile.in file. Configure your build -------------------- To configure your build, run the configure script from the nano source directory: $ ./configure [--add-options-here] Build and install ----------------- From the nano source directory, build the code with: $ make Then, once it's done compiling, run: $ make install which should copy various files (i.e. the nano executable, the info and man pages, and syntax highlighting pattern files) to their appropriate directories. If you're installing into the default install directory (/usr/local), you'll need to run that "make install" command with root privileges. Problems? --------- Please submit any bugs you find in the code in git via the bug tracker on Savannah (https://savannah.gnu.org/bugs/?group=nano). Contributing something ---------------------- If you have a fix for a bug, or the code for a new or improved feature, first create a branch off of master: $ git checkout -b somename Then change the code so it does what you want, and commit it together with your Sign-off: $ git commit -as In the commit message (after the one-line summary) give a rationale for the change. With your Signed-off-by you declare that the code is yours, or that you are free to reuse it, and that you submit it under the license that covers nano. Then create a patch (or patches): $ git format-patch master Send that patch (or patches) to <nano-devel@gnu.org>, as an attachment or with git send-email. To keep most lines of nano's source code within a width of 80 characters, a tab size of four should be used. So in your nanorc file you may want to include 'set tabsize 4', or you could use -T4 on the command line. To make git display things as intended, you can do: $ git config --local core.pager "less -x1,5"