neovim/runtime/autoload
Christian Clason 2f2f434613 vim-patch:85f054a: runtime(java): Recognise the CommonMark form (///) of Javadoc comments
Complement "g:java_ignore_javadoc" with "g:java_ignore_html"
and "g:java_ignore_markdown" to allow selectively disabling
the recognition of HTML and CommonMark respectively.

(Note that this is not a preview feature.)

======================== LIMITATION ========================

According to the syntactical details of JEP 467:

> Any leading whitespace and the three initial / characters
> are removed from each line.
>
> The lines are shifted left, by removing leading whitespace
> characters, until the non-blank line with the least
> leading whitespace has no remaining leading whitespace.
>
> Additional leading whitespace and any trailing whitespace
> in each line is preserved, because it may be significant.

the following example:
------------------------------------------------------------
///    A summary sentence.
///     A list:
///      - Item A.
///     - Item B.
///
///     Some code span, starting here `
///      1 + 2 ` and ending at the previous \`.
------------------------------------------------------------

should be interpreted as if it were written thus:
------------------------------------------------------------
///A summary sentence.
/// A list:
///  - Item A.
/// - Item B.
///
/// Some code span, starting here `
///  1 + 2 ` and ending at the previous \`.
------------------------------------------------------------

Since automatic line rewriting will not be pursued, parts of
such comments having significant whitespace may be ‘wrongly’
highlighted.  For convenience, a &fex function is defined to
‘correct’ it: g:javaformat#RemoveCommonMarkdownWhitespace()
(:help ft-java-plugin).

References:
https://openjdk.org/jeps/467
https://spec.commonmark.org/0.31.2

closes: vim/vim#15740

85f054aa3f

Co-authored-by: Aliaksei Budavei <0x000c70@gmail.com>
Co-authored-by: Tim Pope <code@tpope.net>
2024-10-01 07:33:24 +02:00
..
cargo
dist vim-patch:e6b01cf: runtime(dist): do not output a message if executable is not found (#30451) 2024-09-21 12:16:28 +00:00
provider feat(clipboard): try cygutils, clip on Windows #30215 2024-09-02 05:43:23 -07:00
remote refactor: rewrite python provider in lua 2024-01-22 22:36:40 +01:00
rust
xml
ada.vim
adacomplete.vim
bitbake.vim
cargo.vim
ccomplete.lua
ccomplete.vim
clojurecomplete.vim
context.vim
contextcomplete.vim
csscomplete.vim
decada.vim
freebasic.vim
gnat.vim
gzip.vim vim-patch:cd8a3eaf5348 2023-11-05 21:52:02 +01:00
hare.vim vim-patch:9.1.0442: hare runtime files outdated (#29011) 2024-05-26 07:11:50 +08:00
haskellcomplete.vim
hcl.vim vim-patch:150b507: runtime(hcl,terraform): Add runtime files for HCL and Terraform (#30266) 2024-09-04 19:32:52 -05:00
htmlcomplete.vim
javaformat.vim vim-patch:85f054a: runtime(java): Recognise the CommonMark form (///) of Javadoc comments 2024-10-01 07:33:24 +02:00
javascriptcomplete.vim
modula2.vim vim-patch:9.1.0013: Modula2 filetype support lacking (#27020) 2024-01-16 17:45:57 +00:00
msgpack.vim refactor(typval)!: remove distinction of binary and nonbinary strings 2024-06-27 11:04:04 +02:00
netrw_gitignore.vim
netrw.vim vim-patch:be551da: runtime(netrw): remove extraneous closing bracket 2024-09-23 09:30:49 +02:00
netrwFileHandlers.vim vim-patch:f9ca139e3aa1 (#27554) 2024-02-21 06:30:18 +08:00
netrwSettings.vim vim-patch:1e34b95e4402 2024-05-09 00:15:08 +02:00
paste.vim
phpcomplete.vim vim-patch:dbf749bd5aae (#25665) 2023-10-16 16:36:25 +08:00
provider.vim
python3complete.vim
python.vim
pythoncomplete.vim
README.txt
RstFold.vim
rubycomplete.vim vim-patch:d08059ab48b8 2024-01-02 11:43:18 +01:00
rust.vim
rustfmt.vim vim-patch:dbf749bd5aae (#25665) 2023-10-16 16:36:25 +08:00
shada.vim refactor(typval)!: remove distinction of binary and nonbinary strings 2024-06-27 11:04:04 +02:00
spellfile.vim
sqlcomplete.vim
syntaxcomplete.vim
tar.vim vim-patch:f9ca139e3aa1 (#27554) 2024-02-21 06:30:18 +08:00
tutor.vim
typst.vim vim-patch:1cc4cae: runtime(typst): Add typst runtime files 2024-07-16 09:43:57 +02:00
vimexpect.vim
xmlcomplete.vim
xmlformat.vim
zip.vim vim-patch:bc29ea6: runtime(zip): simplify condition to detect MS-Windows (#30115) 2024-08-22 05:58:22 +08:00

The autoload directory is for standard Vim autoload scripts.

These are functions used by plugins and for general use.  They will be loaded
automatically when the function is invoked.  See ":help autoload".

gzip.vim	for editing compressed files
netrw*.vim	browsing (remote) directories and editing remote files
tar.vim		browsing tar files
zip.vim		browsing zip files
paste.vim	common code for mswin.vim, menu.vim and macmap.vim
spellfile.vim	downloading of a missing spell file

Omni completion files:
ccomplete.vim		C
csscomplete.vim		HTML / CSS
htmlcomplete.vim	HTML
javascriptcomplete.vim  Javascript
phpcomplete.vim		PHP
pythoncomplete.vim	Python
rubycomplete.vim	Ruby
syntaxcomplete.vim	from syntax highlighting
xmlcomplete.vim		XML (uses files in the xml directory)