aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorChong Yidong2011-07-09 22:38:26 -0400
committerChong Yidong2011-07-09 22:38:26 -0400
commit7847b2a1dddfec08e68cf23890da38e2b1ea3045 (patch)
tree55795c8f022221b9ebf4483e660815f11813b714
parent91064207ee3ebb3a97a742c34cd97ea1f6b2ee19 (diff)
downloademacs-7847b2a1dddfec08e68cf23890da38e2b1ea3045.tar.gz
emacs-7847b2a1dddfec08e68cf23890da38e2b1ea3045.zip
Remove documentation for Refill and Longlines modes.
These will be obsoleted in a future version of Emacs. * text.texi (Refill, Longlines): Delete nodes. * ack.texi (Acknowledgments): Longlines removed from manual. * emacs.texi (Top): Update node listing.
-rw-r--r--doc/emacs/ChangeLog8
-rw-r--r--doc/emacs/ack.texi18
-rw-r--r--doc/emacs/emacs.texi2
-rw-r--r--doc/emacs/text.texi88
4 files changed, 15 insertions, 101 deletions
diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index 87d1211587f..8b373b3967c 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,11 @@
12011-07-10 Chong Yidong <cyd@stupidchicken.com>
2
3 * text.texi (Refill, Longlines): Delete nodes.
4
5 * ack.texi (Acknowledgments): Longlines removed from manual.
6
7 * emacs.texi (Top): Update node listing.
8
12011-07-09 Glenn Morris <rgm@gnu.org> 92011-07-09 Glenn Morris <rgm@gnu.org>
2 10
3 * fortran-xtra.texi (Fortran): Update handled extensions. 11 * fortran-xtra.texi (Fortran): Update handled extensions.
diff --git a/doc/emacs/ack.texi b/doc/emacs/ack.texi
index e554c71703f..1cfb3d9ffe9 100644
--- a/doc/emacs/ack.texi
+++ b/doc/emacs/ack.texi
@@ -190,9 +190,7 @@ prior to Emacs 23 for Mac OS.
190 190
191@item 191@item
192Chong Yidong was the Emacs co-maintainer for Emacs 23. He made many 192Chong Yidong was the Emacs co-maintainer for Emacs 23. He made many
193improvements to the Emacs display engine; and, together with Kai 193improvements to the Emacs display engine.
194Großjohann and Alex Schroeder, wrote @file{longlines.el}, a minor
195mode for wrapping long lines.
196 194
197@item 195@item
198James Clark wrote SGML mode, a mode for editing SGML documents; and 196James Clark wrote SGML mode, a mode for editing SGML documents; and
@@ -689,14 +687,12 @@ the current window on which point is; @file{cap-words.el}, a minor mode
689for motion in ``CapitalizedWordIdentifiers''; @file{latin1-disp.el}, a 687for motion in ``CapitalizedWordIdentifiers''; @file{latin1-disp.el}, a
690package that lets you display ISO 8859 characters on Latin-1 terminals 688package that lets you display ISO 8859 characters on Latin-1 terminals
691by setting up appropriate display tables; @file{python.el}, a major mode 689by setting up appropriate display tables; @file{python.el}, a major mode
692for the Python programming language; @file{refill.el}, a mode for 690for the Python programming language; @file{smiley.el}, a facility for
693automatic paragraph refilling, akin to typical word processors; 691displaying smiley faces; @file{sym-comp.el}, a library for performing
694@file{smiley.el}, a facility for displaying smiley faces; 692mode-dependent symbol completion; @file{benchmark.el} for timing code
695@file{sym-comp.el}, a library for performing mode-dependent symbol 693execution; and @file{tool-bar.el}, a mode to control the display of
696completion; @file{benchmark.el} for timing code execution; and 694the Emacs tool bar. With Riccardo Murri he wrote @file{vc-bzr.el},
697@file{tool-bar.el}, a mode to control the display of the Emacs tool bar. 695support for the Bazaar version control system.
698With Riccardo Murri he wrote @file{vc-bzr.el}, support for the Bazaar
699version control system.
700 696
701@item 697@item
702Eric Ludlam wrote the Speedbar package; @file{checkdoc.el}, for checking 698Eric Ludlam wrote the Speedbar package; @file{checkdoc.el}, for checking
diff --git a/doc/emacs/emacs.texi b/doc/emacs/emacs.texi
index ed7d48877e5..6758b82abb3 100644
--- a/doc/emacs/emacs.texi
+++ b/doc/emacs/emacs.texi
@@ -585,8 +585,6 @@ Filling Text
585* Fill Prefix:: Filling paragraphs that are indented 585* Fill Prefix:: Filling paragraphs that are indented
586 or in a comment, etc. 586 or in a comment, etc.
587* Adaptive Fill:: How Emacs can determine the fill prefix automatically. 587* Adaptive Fill:: How Emacs can determine the fill prefix automatically.
588* Refill:: Keeping paragraphs filled.
589* Longlines:: Editing text with very long lines.
590 588
591Outline Mode 589Outline Mode
592 590
diff --git a/doc/emacs/text.texi b/doc/emacs/text.texi
index c0139c60557..77e3035915e 100644
--- a/doc/emacs/text.texi
+++ b/doc/emacs/text.texi
@@ -406,8 +406,6 @@ Text}).
406* Fill Commands:: Commands to refill paragraphs and center lines. 406* Fill Commands:: Commands to refill paragraphs and center lines.
407* Fill Prefix:: Filling paragraphs that are indented or in a comment, etc. 407* Fill Prefix:: Filling paragraphs that are indented or in a comment, etc.
408* Adaptive Fill:: How Emacs can determine the fill prefix automatically. 408* Adaptive Fill:: How Emacs can determine the fill prefix automatically.
409* Refill:: Keeping paragraphs filled.
410* Longlines:: Editing text with very long lines.
411@end menu 409@end menu
412 410
413@node Auto Fill 411@node Auto Fill
@@ -722,92 +720,6 @@ line, and it should return the appropriate fill prefix based on that
722line. If it returns @code{nil}, @code{adaptive-fill-regexp} gets 720line. If it returns @code{nil}, @code{adaptive-fill-regexp} gets
723a chance to find a prefix. 721a chance to find a prefix.
724 722
725@node Refill
726@subsection Refill Mode
727@cindex refilling text, word processor style
728@cindex modes, Refill
729@cindex Refill minor mode
730
731 Refill minor mode provides support for keeping paragraphs filled as
732you type or modify them in other ways. It provides an effect similar
733to typical word processor behavior. This works by running a
734paragraph-filling command at suitable times.
735
736 To toggle the use of Refill mode in the current buffer, type
737@kbd{M-x refill-mode}. When you are typing text, only characters
738which normally trigger auto filling, like the space character, will
739trigger refilling. This is to avoid making it too slow. Apart from
740self-inserting characters, other commands which modify the text cause
741refilling.
742
743 The current implementation is preliminary and not robust. You can
744get better ``line wrapping'' behavior using Longlines mode.
745@xref{Longlines}. However, Longlines mode has an important
746side-effect: the newlines that it inserts for you are not saved to
747disk, so the files that you make with Longlines mode will appear to be
748completely unfilled if you edit them without Longlines mode.
749
750@node Longlines
751@subsection Long Lines Mode
752@cindex refilling text, word processor style
753@cindex modes, Long Lines
754@cindex word wrap
755@cindex Long Lines minor mode
756
757 Sometimes, you may come across ``unfilled'' text files, which Emacs
758normally displays as a bunch of extremely long lines. Comfortably
759reading and editing such files normally requires ``word wrap'', a
760feature that breaks up each long text line into multiple screen lines
761in a readable manner---by putting the breaks at word boundaries. Many
762text editors, such as those built into many web browsers, perform word
763wrapping by default.
764
765 There are two different minor modes in Emacs that perform word
766wrapping. The first is Visual Line mode, which does it by altering
767the behavior of screen line continuation. @xref{Visual Line Mode},
768for information about Visual Line mode.
769
770@findex longlines-mode
771 Instead of using Visual Line mode, you can use a minor mode called
772Long Lines mode. Long Lines mode wraps lines by inserting or deleting
773@dfn{soft newlines} as you type (@pxref{Hard and Soft Newlines}).
774These soft newlines won't show up when you save the buffer into a
775file, or when you copy the text into the kill ring, clipboard, or a
776register. Unlike Visual Line mode, Lone Lines mode breaks long lines
777at the fill column (@pxref{Fill Commands}), rather than the right
778window edge. To enable Long Lines mode, type @kbd{M-x
779longlines-mode}. If the text is full of long lines, this also
780immediately ``wraps'' them all.
781
782@findex longlines-auto-wrap
783 The word wrap performed by Long Lines mode is @emph{not} the same as
784ordinary filling (@pxref{Fill Commands}). It does not contract
785multiple spaces into a single space, recognize fill prefixes
786(@pxref{Fill Prefix}), or perform adaptive filling (@pxref{Adaptive
787Fill}). The reason for this is that a wrapped line is still,
788conceptually, a single line. Each soft newline is equivalent to
789exactly one space in that long line, and vice versa. However, you can
790still call filling functions such as @kbd{M-q}, and these will work as
791expected, inserting soft newlines that won't show up on disk or when
792the text is copied. You can even rely entirely on the normal fill
793commands by turning off automatic line wrapping, with @kbd{C-u M-x
794longlines-auto-wrap}. To turn automatic line wrapping back on, type
795@kbd{M-x longlines-auto-wrap}.
796
797@findex longlines-show-hard-newlines
798 Type @kbd{RET} to insert a hard newline, one which automatic
799refilling will not remove. If you want to see where all the hard
800newlines are, type @kbd{M-x longlines-show-hard-newlines}. This will
801mark each hard newline with a special symbol. The same command with a
802prefix argument turns this display off.
803
804 Long Lines mode does not change normal text files that are already
805filled, since the existing newlines are considered hard newlines.
806Before Long Lines can do anything, you need to transform each
807paragraph into a long line. One way is to set @code{fill-column} to a
808large number (e.g., @kbd{C-u 9999 C-x f}), re-fill all the paragraphs,
809and then set @code{fill-column} back to its original value.
810
811@node Case 723@node Case
812@section Case Conversion Commands 724@section Case Conversion Commands
813@cindex case conversion 725@cindex case conversion