[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] master bd962f7: Improve documentation of So Long mode
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] master bd962f7: Improve documentation of So Long mode |
Date: |
Sat, 13 Jul 2019 04:07:30 -0400 (EDT) |
branch: master
commit bd962f7fd471a07bae1950976e066ad0c3009532
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>
Improve documentation of So Long mode
* doc/emacs/trouble.texi (Long Lines): Improve wording, add
indexing, mention the mode name and its main customization
options.
---
doc/emacs/trouble.texi | 31 +++++++++++++++++++++----------
1 file changed, 21 insertions(+), 10 deletions(-)
diff --git a/doc/emacs/trouble.texi b/doc/emacs/trouble.texi
index aa94020..13d3e84 100644
--- a/doc/emacs/trouble.texi
+++ b/doc/emacs/trouble.texi
@@ -469,19 +469,30 @@ in unusual circumstances), Emacs can perform poorly when
extremely
long lines are present (where ``extremely long'' usually means at
least many thousands of characters).
+@cindex @code{so-long} mode
+@findex global-so-long-mode
+@vindex so-long-action
A particular problem is that Emacs may ``hang'' for a long time at
-the point of visiting a file with extremely long lines, and this case
-can be mitigated by enabling the @file{so-long} library, which detects
-when a visited file contains abnormally long lines, and takes steps to
+the point of visiting a file with extremely long lines. This can be
+mitigated by enabling the @file{so-long} library, which detects when a
+visited file contains abnormally long lines, and takes steps to
disable features which are liable to cause slowness in that situation.
-
- This library can also significantly improve performance when moving
-and editing in such a buffer -- performance is still likely to degrade
-as you get deeper into the long lines, but the improvements can
-nevertheless be substantial.
-
+To enable this library, type @kbd{M-x global-so-long-mode @key{RET}},
+or turn on the @code{global-so-long-mode} in your init file
+(@pxref{Init File}), or customize the @code{global-so-long-mode}
+option. You can tailor this mode's operation by customizing the
+variable @code{so-long-action}.
+
+ The @file{so-long} library can also significantly improve
+performance when moving and editing in a buffer with long lines.
+Performance is still likely to degrade as you get deeper into the long
+lines, but the improvements from using this library can nevertheless
+be substantial.
+
+@findex so-long-commentary
Use @kbd{M-x so-long-commentary} to view the documentation for this
-library and learn how to enable and configure it.
+library and learn more about how to enable and configure it.
+
@node Bugs
@section Reporting Bugs
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] master bd962f7: Improve documentation of So Long mode,
Eli Zaretskii <=