commit 9fa5fbd3afb664e5f1da9e9a2e18163262d2ddf6
parent 7662c86dbfb8da1962defaffbf8c2b0fa00213cd
Author: Chris Allegretta <chrisa@asty.org>
Date: Mon, 13 Jan 2003 02:56:29 +0000
nano.texi - Updates for the most recent and not so recent changes
git-svn-id: svn://svn.savannah.gnu.org/nano/trunk/nano@1346 35c25a1d-7b9e-4130-9fde-d3aeb78583b8
Diffstat:
| M | ChangeLog | | | 1 | + |
| M | nano.texi | | | 92 | ++++++++++++++++++++++++++++++++++++++----------------------------------------- |
2 files changed, 45 insertions(+), 48 deletions(-)
diff --git a/ChangeLog b/ChangeLog
@@ -210,6 +210,7 @@ Changes
with HTML 4.01 Transitional. (DLR and David Benbennick)
- nano.texi:
- Typo fixes and updates. (David Benbennick)
+ - Updates for the most recent and not so recent changes.
- TODO
- Added some wishlist stuff.
- THANKS:
diff --git a/nano.texi b/nano.texi
@@ -94,11 +94,9 @@ internationalization support, and filename tab completion.
@code{nano} +LINE [GNU long option] [option] [ @var{file ...} ]
The original goal for @code{nano} was a complete bug-for-bug compatible
-emulation of Pico, but consistency is now a slightly higher priority.
-There is a flag to implement (nearly) complete Pico emulation, (option -p
-or GNU long option @code{--pico}). This can also be toggled from within
-@code{nano} by typing Meta-P. @xref{Pico Compatibility}, for more
-info.
+emulation of Pico, but nano's main goal is to be as compatible as
+possible while offering a superset of Pico's functionality.
+Also see @xref{Pico Compatibility}, for other differences.
Email bug reports to @email{nano@@nano-editor.org}.
@@ -186,9 +184,9 @@ running under the X window system).
Set operating directory. Makes @code{nano} set up something similar to a
chroot.
-@item -p, --pico
-Emulate Pico as closely as possible, sacrificing consistency for correct
-emulation. @xref{Pico Compatibility}, for more info.
+@item -p, --preserve
+Preserve the ^Q (XON) and ^S (XOFF) sequences so data being sent to the editor
+can be can be stopped and started.
@item -r [#cols], --fill=[#cols].
Wrap lines at column #cols. By default this is the width of the screen,
@@ -304,9 +302,7 @@ the statusbar.
@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. The exact
-functions which are displayed depend on whether Pico Compatibility
-mode is enabled. @xref{Pico Compatibility}, for more info.
+show some of the more commonly used functions in the editor.
@node Online Help, Feature Toggles, Editor Basics, Top
@chapter Online Help
@@ -349,8 +345,7 @@ toggles the -m (@code{--mouse}) command line flag.
toggles the -M (@code{--mac}) command line flag.
@item Pico Mode Toggle (Meta-P)
-toggles the -p (@code{--pico}) command line flag.
-@xref{Pico Compatibility}, for more info.
+toggles the -p (@code{--preserve}) command line flag.
@item Smooth Scrolling Toggle (Meta-S)
toggles the -S (@code{--smooth}) command line flag.
@@ -390,42 +385,40 @@ statusbar and the file browser is exited.
@node Pico Compatibility, Building and Configure Options, The File Browser, Top
@chapter Pico Compatibility
-nano does not completely emulate Pico by default. The following
-differences apply to the default mode and Pico Compatibility mode:
+@code{nano} attempts to emulate Pico as closely as possible, but there
+are certain differences between the editors:
@table @code
-@item Displayed Shortcuts
-By default, the following shortcuts are displayed in the Shortcut List:
-
-@multitable @columnfractions .1 .1 .1 .1 .1 .1
-@item ^G @tab ^O @tab ^\ @tab ^Y @tab ^K @tab ^C
-@item ^X @tab ^R @tab ^W @tab ^V @tab ^U @tab ^T
-@end multitable
-
-Related functions are listed above or below each other by default. The
-Justify function is not listed, instead the ``Replace'' function is
-displayed. Also, the ``Read File'' and ``WriteOut'' functions are aligned
-for consistency.
-
-In Pico Compatibility mode, the default Pico shortcuts are displayed:
-
-@multitable @columnfractions .1 .1 .1 .1 .1 .1
-@item ^G @tab ^O @tab ^R @tab ^Y @tab ^K @tab ^C
-@item ^X @tab ^J @tab ^W @tab ^V @tab ^U @tab ^T
-@end multitable
-
-@item Previous String Text
-By default, the previously entered string for a function (search string,
-file name) will be placed on the statusbar, and is editable. This is
-done so there is consistency across all functions. For example: even if
-there is a previous replace string, it can always be deleted if one
-wishes to perform an empty string replace.
-
-In Pico Compatibility Mode, the previously entered text in a search or
-replace will appear in brackets, and is not editable. It is not a
-simple matter to do an empty string replace when a previous replace
-string exists, for example. When writing a file, the previous filename
-will be displayed in the editable text portion of the editor.
+@item Search and Replace History
+As of version 1.1.99pre1 of @code{nano}, text entered as search or replace
+strings will be stored and can be accessed with the up/down
+arrow keys. Previously, @code{nano} offered a more consistent, but incompatible
+with Pico, method for entering search and replace strings. In the old
+method, previous entries would be displayed by default as editable text
+in front of the cursor, as opposed to being bracketed and uneditable as
+it is in Pico. The old behavior could be made compatible with Pico via the
+@code{-p} flag, but recent versions of Pico use the @code{-p} flag
+to preserve the XON and XOFF sequences within the editor. Since with the new
+method search and replace strings can still be edited by simply hitting the
+up arrow key once, the old method was removed completely.
+
+
+@item Writing or Appending Selected Text to Files
+Text selected using the Control-Caret (^^) key can be written out or
+appended to a new or existing file using the Writeout key (^O).
+
+@item Toggles
+Many options which alter the functionality of the program can be
+"toggled" on or off using Meta key sequences, meaning the program does
+not have to be restarted to turn a particular feature of the editor
+on or off. Please see the internal help function (^G) for a list of
+what functions can be toggled for a particular version of
+@code{nano}.
+
+@item Cursor Position Display
+The output of the "Display Cursor Position" in @code{nano} displays
+the given column position, as well as the row and total character
+position of the cursor.
@item Interactive Replace and Spell Checker
It is worth noting that the @code{nano} replace function is interactive,
@@ -433,7 +426,10 @@ i.e. it does not stop after one search string is found and automatically
replace it. The @code{nano} implementation will stop at each search
string found and query whether to replace this instance or not. The
internal spell checker operates similarly. Note that these is no way
-to force these functions to behave in the Pico fashion.
+to force these functions to behave in the Pico fashion. As of
+version 1.1.99pre1, misspelled words are sorted and trimmed for
+uniqueness in the internal spell checker such that the words 'apple'
+and 'Apple' will be prompted for correction separately.
@end table
@node Building and Configure Options, , Pico Compatibility, Top
