per Benno Schulenberg's patch with some additions of mine, explain the

mouse support in more detail, and sync the text of its description across
all documentation

git-svn-id: svn://svn.savannah.gnu.org/nano/trunk/nano@3561 35c25a1d-7b9e-4130-9fde-d3aeb78583b8

diff --git a/ChangeLog b/ChangeLog
index 641f04b360497d55809b0208f3cca42b0e79c1d1..78ed58d4d626a2219e39ea746ad80bdf79af3190 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -105,6 +105,10 @@ CVS code -
          do_input(), do_statusbar_input(), get_prompt_string(), and
          parse_kbinput(). (DLR, suggested by Nick Warne and Benno
          Schulenberg)
+       - Explain the mouse support in more detail, and sync the text of
+         its description across all documentation.  Changes to nano.1,
+         nanorc.5, nanorc.sample, and nano.texi. (Benno Schulenberg and
+         DLR)
 - browser.c:
   do_browser()
        - Reference NANO_GOTODIR_(ALT|F)?KEY instead of

diff --git a/doc/man/nano.1 b/doc/man/nano.1
index 4d327fbdc8d516453bfa3905bb3b0fa8030176cd..bfe2756b418ecba03c8f6726ebe20c9129a2e678 100644 (file)
--- a/doc/man/nano.1
+++ b/doc/man/nano.1
@@ -7,7 +7,7 @@
 .\" warranty.
 .\"
 .\" $Id$
-.TH NANO 1 "version 1.3.12" "May 14, 2006"
+.TH NANO 1 "version 1.3.12" "May 24, 2006"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 
@@ -146,7 +146,10 @@ a new file instead of following it.  Good for editing files in
 \fI/tmp\fP, perhaps?
 .TP
 .B \-m (\-\-mouse)
-Enable mouse support (if available for your system).
+Enable mouse support, if available for your system.  When enabled, mouse
+clicks can be used to place the cursor, set the mark (with a double
+click), and execute shortcuts.  The mouse will work in the X Window
+System, and on the console when gpm is running.
 .TP
 .B \-o \fIdir\fP (\-\-operatingdir=\fIdir\fP)
 Set operating directory.  Makes \fBnano\fP set up something similar to a

diff --git a/doc/man/nanorc.5 b/doc/man/nanorc.5
index 9f5d5e888df8c4f11f4f2efd83ec91834fe641ef..b4c478d6392d397632ee5a8c8a07a800e0cc4ad7 100644 (file)
--- a/doc/man/nanorc.5
+++ b/doc/man/nanorc.5
@@ -7,7 +7,7 @@
 .\" warranty.
 .\"
 .\" $Id$
-.TH NANORC 5 "version 1.3.12" "May 23, 2006"
+.TH NANORC 5 "version 1.3.12" "May 24, 2006"
 .\" Please adjust this date whenever revising the manpage.
 .\"
 .SH NAME
@@ -95,8 +95,10 @@ default value is "\fI(<[{)>]}\fP".
 Allow use of the blank line below the titlebar as extra editing space.
 .TP
 .B set/unset mouse
-Enable mouse support, so that mouse clicks can be used to set the mark
-and run shortcuts.
+Enable mouse support, if available for your system.  When enabled, mouse
+clicks can be used to place the cursor, set the mark (with a double
+click), and execute shortcuts.  The mouse will work in the X Window
+System, and on the console when gpm is running.
 .TP
 .B set/unset multibuffer
 Allow inserting files into their own buffers.

diff --git a/doc/nanorc.sample b/doc/nanorc.sample
index 30e6b8adf6a2e32c32abb6dcb6e9263ab4bf47ee..f4d1d448a4cc11aba6ab3c3e916d245c9f8724c7 100644 (file)
--- a/doc/nanorc.sample
+++ b/doc/nanorc.sample
@@ -65,8 +65,11 @@
 ## Use the blank line below the titlebar as extra editing space.
 # set morespace
 
-## Enable mouse support, so that mouse clicks can be used to set the
-## mark and run shortcuts.
+## Enable mouse support, if available for your system.  When enabled,
+## mouse clicks can be used to place the cursor, set the mark (with a
+## double click), and execute shortcuts.  The mouse will work in the X
+## Window System, and on the console when gpm is running.
+##
 # set mouse
 
 ## Allow multiple file buffers (inserting a file will put it into a

diff --git a/doc/texinfo/nano.texi b/doc/texinfo/nano.texi
index cbe8c4df15fab09dc10a720b74110ee22d30802d..2bd43731fc62c44845cb105fb83e23f1d1f7e84d 100644 (file)
--- a/doc/texinfo/nano.texi
+++ b/doc/texinfo/nano.texi
@@ -9,7 +9,7 @@
 @smallbook
 @set EDITION 0.1
 @set VERSION 1.3.12
-@set UPDATED 23 May 2006
+@set UPDATED 24 May 2006
 
 @dircategory Editors
 @direntry
@@ -219,8 +219,10 @@ When writing files, if the given file is a symbolic link, it is removed
 and a new file is created.
 
 @item -m, --mouse
-Enables the use of the mouse to select text (currently only useful for
-running under the X Window System).
+Enable mouse support, if available for your system.  When enabled, mouse
+clicks can be used to place the cursor, set the mark (with a double
+click), and execute shortcuts.  The mouse will work in the X Window
+System, and on the console when gpm is running.
 
 @item -o <dir>, --operatingdir=<dir>
 Set operating directory.  Makes @code{nano} set up something similar to
@@ -273,6 +275,7 @@ keystroke (usually ^Z).
 Ignored, for compatibility with Pico.
 @end table
 
+
 @node Editor Basics, Online Help, Introduction, Top
 @chapter Editor Basics
 @menu
@@ -281,6 +284,7 @@ Ignored, for compatibility with Pico.
 * The Titlebar::
 * The Statusbar::
 * Shortcut Lists::
+* Using the Mouse::
 @end menu
 
 @node Entering Text, Special Functions, Editor Basics, Editor Basics
@@ -339,12 +343,24 @@ occur from using the editor will appear on the statusbar.  Any questions
 that are asked of the user will be asked on the statusbar, and any user
 input (search strings, filenames, etc.) will be input on the statusbar.
 
-@node Shortcut Lists, , The Statusbar, Editor Basics
+@node Shortcut Lists, Using the Mouse, The Statusbar, Editor Basics
 @section Shortcut Lists
 
 The Shortcut Lists are the two lines at the bottom of the screen which
 show some of the more commonly used functions in the editor.
 
+@node Using the Mouse, , Shortcut Lists, Editor Basics
+@section Using the Mouse
+
+When mouse support has been configured and enabled, a single mouse click
+places the cursor at the indicated position.  Clicking a second time in
+the same position toggles the mark.  Clicking in the shortcut list
+executes the selected shortcut.
+
+The mouse will work in the X Window System, and on the console when gpm
+is running.
+
+
 @node Online Help, Feature Toggles, Editor Basics, Top
 @chapter Online Help