Adaptive fill mode broken in docstring
还没有人认领这个 Issue。
评估
调研方向
在 Clojure mode 中,将光标放在缩进的 docstring 部分并按下 M-q,以重现该问题。阅读涉及 adaptive-fill-function 和 fill-paragraph-function 的 docstring 相关填充逻辑,然后将其与其他 Lisp 主模式进行比较。当自适应填充能够以正确的缩进放置换行后的文本,而无需使用报告中的 workaround 时,即表示完成。
由索引模型根据 Issue 内容生成。
描述
When filling in a docstring, there is no proper adaptive filling and it always seems to fill to the beginning column of the docstring. This problem has annoyed me for more than 5 years, so I stepped a bit through the debugger, but I don't understand Emacs Lisp well enough to provide a proper fix.
An arg - asdfasdfasd sadf as dfas df asdf asdf as df as df asd
fas df asdf asdf asdf as df asd fa sd fa sdf as df asdf as dfa sdf
Put the cursor somewhere into the indented section and press M-q. In Clojure mode, it will ruin the indentation. Proper adaptive filling will cut as dfa sdf and put in on the next line at col 9.
My best solution so far is to set adaptive-fill-function to ignore and fill-paragraph-function to nil. So far, I haven't observed any adverse side effects but sure it breaks something.
In general, there seems to be a bunch of logic implemented around docstrings in Clojure mode, but it is not very well documented and probably not working properly. Probably one could draw inspiration for how docstring indentation is solved in other LISP major modes.
I noticed that in Emacs Lisp for instance, docstrings have no special indentation behavior, and in Clojure there are two spaces prepended to each line. Its a weird convention but it seems to be somehow rooted in Clojure core? Is that what all the logic is about? Maybe getting rid of that is too much to ask for, but it would be nice if you can make adaptive filling work.
;;; Workaround, use at your own risk
(add-hook 'clojure-mode-hook
(lambda ()
(interactive)
(setq-local fill-paragraph-function nil)
(setq-local adaptive-fill-function 'ignore)))
- 主要语言
- Emacs Lisp
- 星标
- 1k
- 派生
- 249
- 平均合并
- 1 天 6 小时
- 30 天内合并 PR
- 6
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
clojure-emacs/clojure-mode 的其他 Issue
-
难度 4/5 3-5 天 新手友好度 35/100
clojure-emacs/clojure-mode#699 ·
-
难度 2/5 1-3 小时 新手友好度 35/100
clojure-emacs/clojure-mode#647 · 1 条评论 ·
-
bug help wanted indentation
难度 3/5 1-2 天 新手友好度 42/100
clojure-emacs/clojure-mode#620 ·
-
难度 3/5 1-2 天 新手友好度 45/100
clojure-emacs/clojure-mode#613 · 1 个 reaction ·
-
Indent very slow未关闭help wanted indentation
难度 4/5 3-5 天 新手友好度 35/100
clojure-emacs/clojure-mode#606 · 6 条评论 ·
查看 clojure-emacs/clojure-mode 的全部 Issue
相似的 Issue
-
难度 1/5 1 小时以内 新手友好度 62/100
-
难度 2/5 1-3 小时 新手友好度 70/100
clojure-emacs/cider#4235 ·
维护者通常 1 天内回复
-
[Request]: Winc可能已有人在做 @chenyme 今天认领。 未关闭package-request
难度 2/5 1-3 小时 新手友好度 68/100
ScoopInstaller/Extras#19476 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 74/100
promplate/code-review#158 · 1 条评论 · 1 个 reaction ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 80/100
维护者通常 1 天内回复