mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2025-01-11 16:08:13 +00:00
Code Issues Releases Activity

* doc/emacs/text.texi (Outline Minor Mode): Add a note about value 'insert'.

Browse Source 
* lisp/outline.el (outline-minor-mode-use-buttons): Add a note and
a comment about the value 'insert' (bug#65874).
This commit is contained in:
Juri Linkov 2023-09-13 19:49:29 +03:00
parent a65d1a5a16
commit 9396d73942
2 changed files with 8 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
doc/emacs/text.texi
View File

@ -1020,10 +1020,11 @@ addition to ellipsis, to show that a section is hidden. Clicking the
mouse on the button toggles display of the section. If the value of mouse on the button toggles display of the section. If the value of
this variable is @code{insert}, the buttons are inserted directly into this variable is @code{insert}, the buttons are inserted directly into
the buffer text, so @key{RET} on the button will also toggle display the buffer text, so @key{RET} on the button will also toggle display
of the section, like a mouse click does. If the value is of the section, like a mouse click does. Using the value @code{insert}
@code{in-margins}, Outline minor mode will use the window margins to is not recommended in editable buffers because it modifies them.
indicate that a section is hidden. The buttons are customizable as icons If the value is @code{in-margins}, Outline minor mode will use the
(@pxref{Icons}). window margins to indicate that a section is hidden. The buttons are
customizable as icons (@pxref{Icons}).
@vindex outline-minor-mode-cycle @vindex outline-minor-mode-cycle
If the @code{outline-minor-mode-cycle} user option is If the @code{outline-minor-mode-cycle} user option is

3
lisp/outline.el
View File

@ -314,12 +314,15 @@ These buttons can be used to hide and show the body under the heading.
When the value is `insert', additional placeholders for buttons are When the value is `insert', additional placeholders for buttons are
inserted to the buffer, so buttons are not only clickable, inserted to the buffer, so buttons are not only clickable,
but also typing `RET' on them can hide and show the body. but also typing `RET' on them can hide and show the body.
Using the value `insert' is not recommended in editable
buffers because it modifies them.
When the value is `in-margins', then clickable buttons are When the value is `in-margins', then clickable buttons are
displayed in the margins before the headings. displayed in the margins before the headings.
When the value is `t', clickable buttons are displayed When the value is `t', clickable buttons are displayed
in the buffer before the headings. The values `t' and in the buffer before the headings. The values `t' and
`in-margins' can be used in editing buffers because they `in-margins' can be used in editing buffers because they
don't modify the buffer." don't modify the buffer."
;; The value `insert' is not intended to be customizable.
:type '(choice (const :tag "Do not use outline buttons" nil) :type '(choice (const :tag "Do not use outline buttons" nil)
(const :tag "Show outline buttons in margins" in-margins) (const :tag "Show outline buttons in margins" in-margins)
(const :tag "Show outline buttons in buffer" t)) (const :tag "Show outline buttons in buffer" t))