diff options
| author | zeertzjq <zeertzjq@outlook.com> | 2026-01-19 06:58:01 +0800 |
|---|---|---|
| committer | zeertzjq <zeertzjq@outlook.com> | 2026-01-19 07:01:58 +0800 |
| commit | a71ea81b865b87f7c83bc324f769f73b772bcadd (patch) | |
| tree | 278bd70314ce9e53710f636f1b691982ff2a69fc /runtime/syntax/python.vim | |
| parent | 3bbd646f59c8c894d5a32d54beed94f2391fb857 (diff) | |
| download | rneovim-a71ea81b865b87f7c83bc324f769f73b772bcadd.tar.gz rneovim-a71ea81b865b87f7c83bc324f769f73b772bcadd.tar.bz2 rneovim-a71ea81b865b87f7c83bc324f769f73b772bcadd.zip | |
vim-patch:638bbc5: runtime(doc): Update advice for [gnt]roff users
Content:
* Offer more specific guidance regarding input line breaks and sentence
endings.
* Advise what to do when a line ends with sentence-ending punctuation
but doesn't end a sentence.
* Advise against use of blanks lines and leading spaces for formatting
when a macro package is in use.
* Advise how to achieve visual separation in the document without
affecting formatting.
* Point out how the newline/end-of-sentence rules aid diffing.
* Distinguish the separate processes of inter-sentence space
supplementation and filling.
* Use conventional (but accessible) terms from typography instead of
more casual, approximate ones.
* Clarify what sort of extension the ms package's `XP` macro is.
Style:
* Fix comma splice with a semicolon.
* Use slightly more standard/idiomatic English.
Sources:
* https://rhodesmill.org/brandon/2012/one-sentence-per-line/
* https://www.ualberta.ca/en/computing-science/media-library/docs/unix-beginners.pdf
(p. 20)
* https://www.gnu.org/software/groff/manual/groff.html.node/Input-Conventions.html
* https://cgit.git.savannah.gnu.org/cgit/groff.git/tree/doc/ms.ms?h=1.23.0#n1131
* https://docs-archive.freebsd.org/44doc/usd/18.msdiffs/paper.pdf
closes: vim/vim#19193
https://github.com/vim/vim/commit/638bbc57c151b0360d953e1e4ad372e3c9f0d3ce
Co-authored-by: G. Branden Robinson <g.branden.robinson@gmail.com>
Diffstat (limited to 'runtime/syntax/python.vim')
0 files changed, 0 insertions, 0 deletions