-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathvirtual-auto-fill.el
326 lines (295 loc) · 14.4 KB
/
virtual-auto-fill.el
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
;;; virtual-auto-fill.el --- Readably display text without adding line breaks -*- lexical-binding: t; -*-
;; Copyright (C) 2020 Free Software Foundation, Inc.
;; Author: Luis Gerhorst <[email protected]>
;; Maintainer: Luis Gerhorst <[email protected]>
;; URL: https://github.com/luisgerhorst/virtual-auto-fill
;; Keywords: convenience, mail, outlines, files, wp
;; Created: Sun 26. Jan 2020
;; Version: 0.1
;; Package-Requires: ((emacs "25.2") (adaptive-wrap "0.7") (visual-fill-column "1.9"))
;; This file is NOT part of GNU Emacs.
;; This program is free software; you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation, either version 3 of the License, or
;; (at your option) any later version.
;;
;; This program is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
;; GNU General Public License for more details.
;;
;; You should have received a copy of the GNU General Public License
;; along with this program. If not, see <https://www.gnu.org/licenses/>.
;;; Commentary:
;;
;; Virtual Auto Fill mode displays unfilled text in a readable way. It wraps
;; the text as if you had inserted line breaks (e.g. using `fill-paragraph' or
;; `auto-fill-mode') without actually modifying the underlying buffer. It also
;; indents paragraphs in bullet lists properly.
;;
;; Specifically, `adaptive-wrap-prefix-mode', Visual Fill Column mode and
;; `visual-line-mode' are used to wrap paragraphs and bullet lists between the
;; wrap prefix and the fill column.
;;; Code:
(require 'adaptive-wrap)
(require 'visual-fill-column)
;; To support Emacs versions < 26.1, which added `read-multiple-choice', we
;; include a copy of the function from rmc.el here.
(defun virtual-auto-fill--read-multiple-choice (prompt choices)
"Ask user a multiple choice question.
PROMPT should be a string that will be displayed as the prompt.
CHOICES is an alist where the first element in each entry is a
character to be entered, the second element is a short name for
the entry to be displayed while prompting (if there's room, it
might be shortened), and the third, optional entry is a longer
explanation that will be displayed in a help buffer if the user
requests more help.
This function translates user input into responses by consulting
the bindings in `query-replace-map'; see the documentation of
that variable for more information. In this case, the useful
bindings are `recenter', `scroll-up', and `scroll-down'. If the
user enters `recenter', `scroll-up', or `scroll-down' responses,
perform the requested window recentering or scrolling and ask
again.
When `use-dialog-box' is t (the default), this function can pop
up a dialog window to collect the user input. That functionality
requires `display-popup-menus-p' to return t. Otherwise, a text
dialog will be used.
The return value is the matching entry from the CHOICES list.
Usage example:
\(virtual-auto-fill--read-multiple-choice \"Continue connecting?\"
\\='((?a \"always\")
(?s \"session only\")
(?n \"no\")))"
(let* ((altered-names nil)
(full-prompt
(format
"%s (%s): "
prompt
(mapconcat
(lambda (elem)
(let* ((name (cadr elem))
(pos (seq-position name (car elem)))
(altered-name
(cond
;; Not in the name string.
((not pos)
(format "[%c] %s" (car elem) name))
;; The prompt character is in the name, so highlight
;; it on graphical terminals...
((display-supports-face-attributes-p
'(:underline t) (window-frame))
(setq name (copy-sequence name))
(put-text-property pos (1+ pos)
'face 'read-multiple-choice-face
name)
name)
;; And put it in [bracket] on non-graphical terminals.
(t
(concat
(substring name 0 pos)
"["
(upcase (substring name pos (1+ pos)))
"]"
(substring name (1+ pos)))))))
(push (cons (car elem) altered-name)
altered-names)
altered-name))
(append choices '((?? "?")))
", ")))
tchar buf wrong-char answer)
(save-window-excursion
(save-excursion
(while (not tchar)
(message "%s%s"
(if wrong-char
"Invalid choice. "
"")
full-prompt)
(setq tchar
(if (and (display-popup-menus-p)
last-input-event ; not during startup
(listp last-nonmenu-event)
use-dialog-box)
(x-popup-dialog
t
(cons prompt
(mapcar
(lambda (elem)
(cons (capitalize (cadr elem))
(car elem)))
choices)))
(condition-case nil
(let ((cursor-in-echo-area t))
(read-char))
(error nil))))
(setq answer (lookup-key query-replace-map (vector tchar) t))
(setq tchar
(cond
((eq answer 'recenter)
(recenter) t)
((eq answer 'scroll-up)
(ignore-errors (scroll-up-command)) t)
((eq answer 'scroll-down)
(ignore-errors (scroll-down-command)) t)
((eq answer 'scroll-other-window)
(ignore-errors (scroll-other-window)) t)
((eq answer 'scroll-other-window-down)
(ignore-errors (scroll-other-window-down)) t)
(t tchar)))
(when (eq tchar t)
(setq wrong-char nil
tchar nil))
;; The user has entered an invalid choice, so display the
;; help messages.
(when (and (not (eq tchar nil))
(not (assq tchar choices)))
(setq wrong-char (not (memq tchar '(?? ?\C-h)))
tchar nil)
(when wrong-char
(ding))
(with-help-window (setq buf (get-buffer-create
"*Multiple Choice Help*"))
(with-current-buffer buf
(erase-buffer)
(pop-to-buffer buf)
(insert prompt "\n\n")
(let* ((columns (/ (window-width) 25))
(fill-column 21)
(times 0)
(start (point)))
(dolist (elem choices)
(goto-char start)
(unless (zerop times)
(if (zerop (mod times columns))
;; Go to the next "line".
(goto-char (setq start (point-max)))
;; Add padding.
(while (not (eobp))
(end-of-line)
(insert (make-string (max (- (* (mod times columns)
(+ fill-column 4))
(current-column))
0)
?\s))
(forward-line 1))))
(setq times (1+ times))
(let ((text
(with-temp-buffer
(insert (format
"%c: %s\n"
(car elem)
(cdr (assq (car elem) altered-names))))
(fill-region (point-min) (point-max))
(when (nth 2 elem)
(let ((start (point)))
(insert (nth 2 elem))
(unless (bolp)
(insert "\n"))
(fill-region start (point-max))))
(buffer-string))))
(goto-char start)
(dolist (line (split-string text "\n"))
(end-of-line)
(if (bolp)
(insert line "\n")
(insert line))
(forward-line 1)))))))))))
(when (buffer-live-p buf)
(kill-buffer buf))
(assq tchar choices)))
;; When available however, use the default `read-multiple-choice'.
(require 'rmc nil t)
(when (fboundp 'read-multiple-choice)
(defalias 'virtual-auto-fill--read-multiple-choice #'read-multiple-choice))
(defvar virtual-auto-fill--saved-mode-enabled-states nil
"Saves enabled states of local minor modes.
The mode function and variable must behave according to
define-minor-mode's default.")
(defun virtual-auto-fill--save-state ()
"Save enabled modes."
(set (make-local-variable 'virtual-auto-fill--saved-mode-enabled-states) nil)
(dolist (var '(visual-line-mode
adaptive-wrap-prefix-mode
visual-fill-column-mode))
(push (cons var (symbol-value var))
virtual-auto-fill--saved-mode-enabled-states)))
(defun virtual-auto-fill--restore-state ()
"Restore enabled modes."
(dolist (saved virtual-auto-fill--saved-mode-enabled-states)
(if (cdr saved)
(funcall (car saved) 1)
(funcall (car saved) -1)))
;; Clean up.
(kill-local-variable 'virtual-auto-fill--saved-mode-enabled-states))
(defvar virtual-auto-fill-fill-paragraph-require-confirmation t
"Ask for confirmation before `fill-paragraph'.")
(defun virtual-auto-fill-fill-paragraph-after-confirmation ()
"Ask the first time a paragraph is filled in a buffer.
Confirmation is always skipped if
`virtual-auto-fill-fill-paragraph-require-confirmation' is nil."
(interactive)
(unless (when virtual-auto-fill-fill-paragraph-require-confirmation
(pcase (car (virtual-auto-fill--read-multiple-choice
"Really fill paragraphs in visually wrapped buffer?"
'((?y "yes" "Fill the paragraph, do not ask again")
(?n "no" "Don't fill the paragraph and ask again next time")
(?d "disable visual wrapping" "Disable virtual-auto-fill-mode"))))
(?y (progn (setq-local virtual-auto-fill-fill-paragraph-require-confirmation nil)
nil))
(?n t)
(?d (progn (virtual-auto-fill-mode -1) nil))))
;; Either no confirmation was required or the user decided to fill the
;; paragraph.
(call-interactively #'fill-paragraph)))
(defvar virtual-auto-fill-visual-fill-column-in-emacs-pre-26-1 nil
"Enable Visual Fill Column mode even if Emacs is too old.
Emacs versions before 26.1 have a bug that can crash Emacs when
Visual Fill Column mode is enabled (a mode employed by
Virtual Auto Fill mode). For further information, see:
https://github.com/joostkremers/visual-fill-column/issues/1
By setting this to non-nil, you risk a crash when your Emacs
version is too old. To only disable the warning about the bug,
unset
`virtual-auto-fill-visual-fill-column-warning-in-emacs-pre-26-1'.")
(put 'virtual-auto-fill-visual-fill-column-in-emacs-pre-26-1
'risky-local-variable t)
(defvar virtual-auto-fill-visual-fill-column-warning-in-emacs-pre-26-1 nil
"Don't warn about the Emacs bug triggered by Visual Fill Column mode.
Emacs versions before 26.1 have a bug that can crash Emacs when
Visual Fill Column mode is enabled (a mode employed by Virtual
Auto Fill mode). For further information and workarounds, see:
https://github.com/joostkremers/visual-fill-column/issues/1
Setting this to non-nil silences the warning issued when you are
running an Emacs version smaller than 26.1, but still leaves
Visual Fill Column mode disabled. To enable Visual Fill Column
mode even when your Emacs is deemed buggy, set
`virtual-auto-fill-visual-fill-column-in-emacs-pre-26-1'.")
(put 'virtual-auto-fill-visual-fill-column-warning-in-emacs-pre-26-1
'risky-local-variable t)
;;;###autoload
(define-minor-mode virtual-auto-fill-mode
"Visually wrap lines between wrap prefix and `fill-column'."
:lighter " VirtualFill"
(if virtual-auto-fill-mode
(progn
(virtual-auto-fill--save-state)
(visual-line-mode 1)
(adaptive-wrap-prefix-mode 1)
(if (and (version< emacs-version "26.1")
(not virtual-auto-fill-visual-fill-column-in-emacs-pre-26-1))
(when virtual-auto-fill-visual-fill-column-warning-in-emacs-pre-26-1
(message "You are running an Emacs version < 26.1 which has a bug that can crash Emacs when Visual Fill Column mode is enabled (that's a mode employed by Virtual Auto Fill mode). This bug has been fixed starting with Emacs version 26.1. Visual Fill Column mode is left disabled for now. To enable it anyway, set `virtual-auto-fill-visual-fill-column-in-emacs-pre-26-1' to non-nil and retry. To disable this warning (but leave Virtual Auto Fill mode disabled), unset `virtual-auto-fill-visual-fill-column-warning-in-emacs-pre-26-1'. For further information, see https://github.com/joostkremers/visual-fill-column/issues/1"))
(visual-fill-column-mode 1))
(local-set-key [remap fill-paragraph]
#'virtual-auto-fill-fill-paragraph-after-confirmation)
(local-set-key [remap mu4e-fill-paragraph]
#'virtual-auto-fill-fill-paragraph-after-confirmation))
(virtual-auto-fill--restore-state)
;; TODO: Not sure whether we ideally would also have to save/restore these
;; keybindings.
(local-set-key [remap fill-paragraph] nil)
(local-set-key [remap mu4e-fill-paragraph] nil)
(kill-local-variable 'virtual-auto-fill-fill-paragraph-require-confirmation)))
(provide 'virtual-auto-fill)
;;; virtual-auto-fill.el ends here