From: David Lawrence Ramsey Date: Sat, 25 Nov 2006 18:26:07 +0000 (+0000) Subject: more miscellaneous documentation updates X-Git-Tag: v2.0.2~40 X-Git-Url: https://git.wh0rd.org/?a=commitdiff_plain;h=d21eea02ac2d43b38f3c9cf3d2709d255b6e18d0;p=nano.git more miscellaneous documentation updates git-svn-id: svn://svn.savannah.gnu.org/nano/trunk/nano@3965 35c25a1d-7b9e-4130-9fde-d3aeb78583b8 --- diff --git a/ChangeLog b/ChangeLog index 2f6c6094..9559b6e1 100644 --- a/ChangeLog +++ b/ChangeLog @@ -8,6 +8,10 @@ CVS code - edit_draw() - Fix potential warnings when assigning -1 to paintlen by using if/else clauses instead of "?" operators. (DLR) +- configure.ac: + - Reword several option descriptions, for clarity. (DLR) +- doc/faq.html: + - Add miscellaneous wording and capitalization fixes. (DLR) - BUGS: - Miscellaneous cosmetic fixes. (DLR) diff --git a/configure.ac b/configure.ac index f7ad12f0..690e8e6d 100644 --- a/configure.ac +++ b/configure.ac @@ -56,17 +56,17 @@ dnl Checks for options. AC_ARG_ENABLE(debug, [ --enable-debug Enable debugging (disabled by default)], [if test x$enableval = xyes; then - AC_DEFINE(DEBUG, 1, [Define this to enable nano debug messages and assert warnings.]) debug_support=yes + AC_DEFINE(DEBUG, 1, [Define this to enable debug messages and assert warnings.]) debug_support=yes fi]) if test x$debug_support != xyes; then - AC_DEFINE(NDEBUG, 1, [Shut up the assert warnings :-)]) + AC_DEFINE(NDEBUG, 1, [Shut up assert warnings :-)]) fi AC_ARG_ENABLE(extra, [ --enable-extra Enable extra features, currently only easter eggs], [if test x$enableval = xyes; then - AC_DEFINE(NANO_EXTRA, 1, [Define this to enable the extra stuff.]) extra_support=yes + AC_DEFINE(NANO_EXTRA, 1, [Define this to enable extra stuff.]) extra_support=yes fi]) AC_ARG_ENABLE(tiny, @@ -75,42 +75,42 @@ AC_ARG_ENABLE(tiny, AC_DEFINE(NANO_TINY, 1, [Define this to make the nano executable as small as possible.]) tiny_support=yes AC_DEFINE(DISABLE_BROWSER, 1, [Define this to disable the built-in file browser.]) AC_DEFINE(DISABLE_HELP, 1, [Define this to disable the help text display.]) - AC_DEFINE(DISABLE_JUSTIFY, 1, [Define this to disable the justify routine.]) + AC_DEFINE(DISABLE_JUSTIFY, 1, [Define this to disable the justify routines.]) AC_DEFINE(DISABLE_MOUSE, 1, [Define this to disable the mouse functions.]) - AC_DEFINE(DISABLE_OPERATINGDIR, 1, [Define this to disable setting of the operating directory (chroot of sorts).]) + AC_DEFINE(DISABLE_OPERATINGDIR, 1, [Define this to disable the setting of the operating directory (chroot of sorts).]) AC_DEFINE(DISABLE_SPELLER, 1, [Define this to disable the spell checker functions.]) - AC_DEFINE(DISABLE_TABCOMP, 1, [Define to disable the tab completion code Chris worked so hard on!]) - AC_DEFINE(DISABLE_WRAPPING, 1, [Define this to disable any and all text wrapping.]) + AC_DEFINE(DISABLE_TABCOMP, 1, [Define to disable the tab completion functions for files and search strings.]) + AC_DEFINE(DISABLE_WRAPPING, 1, [Define this to disable all text wrapping.]) fi]) AC_ARG_ENABLE(browser, -[ --disable-browser Disable mini file browser], +[ --disable-browser Disable built-in file browser], [if test x$enableval != xyes; then AC_DEFINE(DISABLE_BROWSER, 1, [Define this to disable the built-in file browser.]) fi]) AC_ARG_ENABLE(help, -[ --disable-help Disable help function], +[ --disable-help Disable help functions], [if test x$enableval != xyes; then AC_DEFINE(DISABLE_HELP, 1, [Define this to disable the help text display.]) fi]) AC_ARG_ENABLE(justify, -[ --disable-justify Disable justify/unjustify function], +[ --disable-justify Disable justify/unjustify functions], [if test x$enableval != xyes; then - AC_DEFINE(DISABLE_JUSTIFY, 1, [Define this to disable the justify routine.]) + AC_DEFINE(DISABLE_JUSTIFY, 1, [Define this to disable the justify routines.]) fi]) AC_ARG_ENABLE(mouse, [ --disable-mouse Disable mouse support (and -m flag)], [if test x$enableval != xyes; then - AC_DEFINE(DISABLE_MOUSE, 1, [Define this to disable the mouse functions.]) + AC_DEFINE(DISABLE_MOUSE, 1, [Define this to disable the mouse support.]) fi]) AC_ARG_ENABLE(operatingdir, [ --disable-operatingdir Disable setting of operating directory (chroot of sorts)], [if test x$enableval != xyes; then - AC_DEFINE(DISABLE_OPERATINGDIR, 1, [Define this to disable setting of the operating directory (chroot of sorts).]) + AC_DEFINE(DISABLE_OPERATINGDIR, 1, [Define this to disable the setting of the operating directory (chroot of sorts).]) fi]) AC_ARG_ENABLE(speller, @@ -120,28 +120,28 @@ AC_ARG_ENABLE(speller, fi]) AC_ARG_ENABLE(tabcomp, -[ --disable-tabcomp Disable tab completion code for a smaller binary], +[ --disable-tabcomp Disable tab completion functions], [if test x$enableval != xyes; then - AC_DEFINE(DISABLE_TABCOMP, 1, [Define to disable the tab completion code Chris worked so hard on!]) + AC_DEFINE(DISABLE_TABCOMP, 1, [Define to disable the tab completion functions for files and search strings.]) fi]) AC_ARG_ENABLE(wrapping, [ --disable-wrapping Disable all wrapping of text (and -w flag)], [if test x$enableval != xyes; then - AC_DEFINE(DISABLE_WRAPPING, 1, [Define this to disable any and all text wrapping.]) + AC_DEFINE(DISABLE_WRAPPING, 1, [Define this to disable all text wrapping.]) fi]) AC_ARG_ENABLE(wrapping-as-root, [ --disable-wrapping-as-root Disable wrapping of text as root by default], [if test x$enableval != xyes; then - AC_DEFINE(DISABLE_ROOTWRAPPING, 1, [Define this to disable wrapping as root by default.]) + AC_DEFINE(DISABLE_ROOTWRAPPING, 1, [Define this to disable text wrapping as root by default.]) fi]) AC_ARG_ENABLE(color, [ --enable-color Enable color and syntax highlighting], [if test x$enableval = xyes; then if test x$ac_cv_header_regex_h = xyes; then - AC_DEFINE(ENABLE_NANORC, 1, [Define this to use the .nanorc file.]) nanorc_support=yes + AC_DEFINE(ENABLE_NANORC, 1, [Define this to use .nanorc files.]) nanorc_support=yes AC_DEFINE(ENABLE_COLOR, 1, [Define this to have syntax highlighting, requires regex.h and ENABLE_NANORC too!]) color_support=yes else AC_MSG_ERROR([ @@ -159,18 +159,18 @@ AC_ARG_ENABLE(multibuffer, fi]) AC_ARG_ENABLE(nanorc, -[ --enable-nanorc Enable use of .nanorc file], +[ --enable-nanorc Enable use of .nanorc files], [if test x$enableval = xyes; then - AC_DEFINE(ENABLE_NANORC, 1, [Define this to use the .nanorc file.]) nanorc_support=yes + AC_DEFINE(ENABLE_NANORC, 1, [Define this to use .nanorc files.]) nanorc_support=yes fi]) AC_ARG_ENABLE(all, [ --enable-all Enable ALL extra nano functionality (kitchen sink option)], [if test x$enableval = xyes; then - AC_DEFINE(ENABLE_NANORC, 1, [Define this to use the .nanorc file.]) nanorc_support=yes + AC_DEFINE(ENABLE_NANORC, 1, [Define this to use .nanorc files.]) nanorc_support=yes AC_DEFINE(ENABLE_COLOR, 1, [Define this to have syntax highlighting, requires regex.h and ENABLE_NANORC too!]) color_support=yes AC_DEFINE(ENABLE_MULTIBUFFER, 1, [Define this to enable multiple file buffers.]) multibuffer_support=yes - AC_DEFINE(NANO_EXTRA, 1, [Define this to enable the extra stuff.]) extra_support=yes + AC_DEFINE(NANO_EXTRA, 1, [Define this to enable extra stuff.]) extra_support=yes fi]) AC_MSG_CHECKING([whether to enable UTF-8 support]) diff --git a/doc/faq.html b/doc/faq.html index b35d2baf..e12f63a9 100644 --- a/doc/faq.html +++ b/doc/faq.html @@ -25,7 +25,7 @@ 3.2. Compiling from source: WHAT THE HECK DO I DO NOW?
3.3. Why does everything go into /usr/local?
3.4. I get errors about 'bindtextdomain','gettext', and/or 'gettextdomain'. What can I do about it?
- 3.5. Nano should automatically run strip on the binary when installing it!
+ 3.5. nano should automatically run strip on the binary when installing it!
3.6. How can I make the executable smaller? This is too bloated!
3.7. Tell me more about this multibuffer stuff!
3.8. Tell me more about this verbatim input stuff!
@@ -36,8 +36,8 @@ 4.3. Ack! My numeric keypad's keys don't work properly when NumLock is off! What can I do?
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?
4.5. How do I type the F13-F16 keys shown in the help browser? My keyboard only has F1-F12!
- 4.6. Nano crashes when I type <insert keystroke here>!
- 4.7. Nano crashes when I resize my window. How can I fix that?
+ 4.6. nano crashes when I type <insert keystroke here>!
+ 4.7. nano crashes when I resize my window. How can I fix that?
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?
4.9. [version 1.1.12 and earlier] Why does nano show ^\ in the shortcut list instead of ^J?
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?!
@@ -57,7 +57,7 @@ 6.5. Why doesn't UW simply change their license?
6.6. What if tomorrow UW changes the license to be truly Free Software?

7. Miscellaneous

-

7.1. Nano-related mailing lists.
+

7.1. nano-related mailing lists.
7.2. I want to send the development team a big load of cash (or just a thank you).
7.3. How do I submit a patch?
7.4. How do I join the development team?
@@ -80,7 +80,7 @@

The event...

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.

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.

-

In February 2001, nano was declared an official GNU program by Richard Stallman. Nano also reached its first production release on March 22, 2001.

+

In February 2001, nano was declared an official GNU program by Richard Stallman. nano also reached its first production release on March 22, 2001.

1.5. Why the name change from TIP?

On January 10, 2000, TIP was officially renamed to nano because of a namespace conflict with another program called 'tip'. The original 'tip' program "establishes a full duplex terminal connection to a remote host", 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).

1.6. What is the current version of nano?

@@ -136,17 +136,16 @@

to put nano into /usr/bin when you run make install.

3.4. I get errors about 'bindtextdomain', 'gettext', and/or 'gettextdomain'. What can I do about it?

Try doing a ./configure --with-included-gettext and see if that solves your problem. You may need to do a make clean; make to get it to work fully.

-

3.5. Nano should automatically run strip on the binary when installing it!

+

3.5. nano should automatically run strip on the binary when installing it!

Actually, it does, but you have to use make install-strip. The default make install does not, and will not, run strip automatically.

3.6. How can I make the executable smaller? This is too bloated!

Actually, there are several parts of the editor that can be disabled. You can pass arguments to the configure script that disable certain features. Here's a brief list:

-  --disable-tabcomp       Disable tab completion code for a smaller
-                          binary
-  --disable-justify       Disable justify/unjustify function
-  --disable-speller       Disable spell checker function
-  --disable-help          Disable help function
-  --disable-browser       Disable mini file browser
+  --disable-tabcomp       Disable tab completion functions
+  --disable-justify       Disable justify/unjustify functions
+  --disable-speller       Disable spell checker functions
+  --disable-help          Disable help functions
+  --disable-browser       Disable built-in file browser
   --disable-wrapping      Disable all wrapping of text (and -w flag)
   --disable-mouse         Disable mouse support (and -m flag)
   --disable-operatingdir  Disable setting of operating directory
@@ -154,13 +153,13 @@

If, on the other hand, you can't live without bells and whistles, you could try:

   --enable-extra          Enable extra features, currently only easter eggs
-  --enable-nanorc         Enable use of .nanorc file
+  --enable-nanorc         Enable use of .nanorc files
   --enable-color          Enable color and syntax highlighting
   --enable-multibuffer    Enable having multiple file buffers open
   --enable-all            Enable all of the above features
   --disable-wrapping-as-root
-                          Turn off wrapping of text by default when the
-                          user is root
+ Disable text wrapping by default when the user is + root

3.7. Tell me more about this multibuffer stuff!

To use multiple file buffers, you must be using nano 1.1.0 or newer, and you must have configured nano with --enable-multibuffer (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 Meta-F, then insert the file as normal with ^R. If you always want files to be loaded into their own buffers, use the --multibuffer or -F flag when you invoke nano.

You can move between the buffers you have open with the Meta-< and Meta-> keys, or more easily with Meta-, and Meta-. (clear as mud, right? =-). When you have more than one file buffer open, the ^X shortcut will say "Close", instead of the normal "Exit" when only one buffer is open.

@@ -177,7 +176,7 @@ To open '+filename.txt' starting on line 10: nano +10 +filename.txt
To open '+filename.txt' starting on line 1 and 'filename.txt' starting on line 10 (if nano has been compiled with multibuffer support): nano +1 +filename.txt +20 filename.txt

4.2. Ack! My Backspace/Delete/Enter/Meta/double bucky key doesn't seem to work! What can I do?

-

Try setting your $TERM variable to 'vt100'. Nano doesn't yet support every term entry under the sun.

+

Try setting your $TERM variable to 'vt100'. nano doesn't yet support every term entry under the sun.

Bourne shell users (bash and sh): export TERM=vt100
C Shell users (tcsh and csh): setenv TERM vt100

4.3. Ack! My numeric keypad's keys don't work properly when NumLock is off! What can I do?

@@ -186,9 +185,9 @@

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.

4.5. How do I type the F13-F16 keys shown in the help browser? My keyboard only has F1-F12!

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.

-

4.6. Nano crashes when I type <insert keystroke here>!

+

4.6. nano crashes when I type <insert keystroke here>!

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 nano-devel list or to nano@nano-editor.org.

-

4.7. Nano crashes when I resize my window. How can I fix that?

+

4.7. nano crashes when I resize my window. How can I fix that?

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).

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?

It's a bug in glibc 2.2.3. You should upgrade to at least glibc 2.2.4.

@@ -238,11 +237,11 @@

6.5. Why doesn't UW simply change their license?

You're really not asking the right person here. I (Chris) waited a long time to see if UW would change their license because of the amount of high quality software being released and developed under the GPL without being taken advantage of by malicious corporate entities or other baddies, but no such luck so far.

6.6. What if tomorrow UW changes the license to be truly Free Software?

-

Honestly nothing would make me happier than to see that happen. Nano would continue to be developed independently until such time as Pico had all the features nano did or the projects merged. That just does not seem very likely given that there has been no sign of any changes in the past few years in a positive direction.

+

Honestly nothing would make me happier than to see that happen. nano would continue to be developed independently until such time as Pico had all the features nano did or the projects merged. That just does not seem very likely given that there has been no sign of any changes in the past few years in a positive direction.

7. Miscellaneous

-

7.1. Nano-related mailing lists.

-

There are three mailing lists for nano hosted at Savannah, 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:

+

7.1. nano-related mailing lists.

+

There are three mailing lists for nano hosted at Savannah, 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:

info-nano - http://mail.gnu.org/mailman/listinfo/info-nano/
help-nano - http://mail.gnu.org/mailman/listinfo/help-nano/
nano-devel - http://mail.gnu.org/mailman/listinfo/nano-devel/

@@ -255,7 +254,8 @@

7.5. Can I have CVS write access?

Re-read Section 7.4 and you should know the answer.

8. ChangeLog

-

2006/10/28 - Update various links for the 2.0 branch of nano. (DLR)
+

2006/11/25 - Add miscellaneous wording and capitalization fixes. (DLR)
+2006/10/28 - Update various links for the 2.0 branch of nano. (DLR)
2006/10/06 - Update the question in section 4.13 to match the version of it in the answer section. (DLR)
2006/07/25 - Update section 5.3 again to not state "the latest development version" before 1.3.12, as it's no longer accurate. Also add some minor spacing fixes. (DLR)
2006/06/12 - Update section 5.3, due to the display fix for two-column Unicode characters. (DLR)