Можно ли более приятно отформатировать справку для функции?

Question

Когда я использую describe-function, я получаю текст документации, отображаемый в буфере справки.

Если документ достаточно длинный, он будет упакован в буфер, но не будет красиво.например:

Я могу заставить строку документа использовать 72-символьные строки, но это предполагает, что в окне будет 80 символов, что не всегда так.

Можно ли заставить describe-function выдавать документацию более красиво отформатированным способом?

Answer 1

Попробуйте включить global-visual-line-mode, чтобы получить хорошее обтекание текста во всех ваших буферах. Он работает в буфере кода и справки, но не портит нумерацию строк! Из всех режимов переноса строк в emacs я считаю его лучшим. Если вы не хотите использовать его глобально, просто попробуйте M-x visual-line-mode.

Answer 2

Нет, пожалуйста, сделайте не"попробуйте включить глобальный-визуальный-линейный-режим" в качестве решения для этого.

Просто попробуйте принять соглашения Emacs для строк документации. См. Руководство Elisp, узел Documentation Tips (он же «Советы по документированию строк»).

Как правило, строки документа не должны иметь строк шириной более 60 символов.

Помните, что есть несколько мест, где Emacs использует строки документов, в том числе для apropos. Emacs ожидает, что строки документа будут следовать задокументированным соглашениям для достижения наилучших результатов.