Aliaksei Budavei
85f054aa3f
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 : #15740
Co-authored-by: Tim Pope <code@tpope.net >
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com >
Signed-off-by: Christian Brabandt <cb@256bit.org >
2024-09-30 19:40:04 +02:00
..
2021-09-21 20:09:51 +02:00
2017-03-05 17:04:09 +01:00
2024-01-14 21:02:54 +01:00
2024-01-14 21:02:54 +01:00
2024-06-03 20:40:45 +02:00
2021-01-25 21:14:57 +01:00
2017-03-05 17:04:09 +01:00
2024-01-14 21:02:54 +01:00
2024-07-09 19:11:18 +02:00
2022-10-28 20:47:54 +01:00
2017-03-05 17:04:09 +01:00
2024-06-03 20:40:45 +02:00
2023-08-28 21:32:27 +02:00
2024-02-14 22:26:43 +01:00
2024-06-03 20:40:45 +02:00
2024-01-14 21:02:54 +01:00
2024-06-03 20:40:45 +02:00
2024-07-16 21:42:17 +02:00
2024-07-26 19:24:33 +02:00
2017-03-05 17:04:09 +01:00
2024-01-14 21:02:54 +01:00
2023-08-23 21:23:07 +02:00
2024-01-14 21:02:54 +01:00
2017-03-05 17:04:09 +01:00
2024-07-06 17:39:18 +02:00
2024-06-03 20:40:45 +02:00
2024-04-19 15:19:31 +02:00
2010-01-06 20:54:52 +01:00
2023-08-13 10:33:05 +02:00
2023-08-28 21:32:27 +02:00
2024-06-03 20:40:45 +02:00
2024-07-07 20:58:10 +02:00
2024-06-03 20:40:45 +02:00
2017-03-05 17:04:09 +01:00
2024-07-05 21:14:26 +02:00
2018-12-27 23:59:26 +01:00
2024-06-03 20:40:45 +02:00
2004-06-13 20:20:40 +00:00
2023-11-04 10:11:17 +01:00
2022-09-27 17:30:34 +01:00
2024-06-21 07:49:39 +02:00
2024-01-14 21:02:54 +01:00
2024-04-20 17:55:05 +02:00
2024-07-07 21:18:31 +02:00
2024-01-14 21:02:54 +01:00
2017-03-05 17:04:09 +01:00
2024-01-14 21:02:54 +01:00
2022-06-03 21:59:47 +01:00
2023-12-27 18:49:50 +01:00
2023-06-10 21:40:39 +01:00
2024-06-06 18:44:52 +02:00
2017-03-05 17:04:09 +01:00
2022-09-18 13:04:22 +01:00
2024-01-14 21:02:54 +01:00
2022-03-08 21:35:07 +00:00
2024-06-03 20:40:45 +02:00
2024-06-03 20:40:45 +02:00
2024-06-18 19:48:15 +02:00
2016-08-30 23:26:57 +02:00
2024-07-30 18:15:30 +02:00
2017-03-05 17:04:09 +01:00
2024-05-19 09:31:46 +02:00
2024-05-25 20:56:49 +02:00
2023-10-26 23:14:30 +02:00
2024-05-25 20:56:49 +02:00
2024-05-25 20:56:49 +02:00
2017-03-05 17:04:09 +01:00
2024-06-03 20:40:45 +02:00
2017-03-05 17:04:09 +01:00
2017-03-05 17:04:09 +01:00
2024-01-14 21:02:54 +01:00
2017-03-05 17:04:09 +01:00
2012-04-25 19:07:41 +02:00
2014-08-29 15:12:19 +02:00
2024-01-14 21:02:54 +01:00
2021-09-09 21:55:11 +02:00
2024-06-03 20:40:45 +02:00
2024-06-03 20:40:45 +02:00
2024-06-03 20:40:45 +02:00
2023-08-28 21:32:27 +02:00
2024-07-07 20:54:32 +02:00
2024-01-14 21:02:54 +01:00
2017-03-05 17:04:09 +01:00
2023-12-27 19:30:41 +01:00
2022-04-27 15:25:03 +01:00
2024-06-03 20:40:45 +02:00
2024-06-03 20:40:45 +02:00
2017-03-05 17:04:09 +01:00
2024-01-14 21:02:54 +01:00
2024-01-14 21:02:54 +01:00
2024-06-03 20:40:45 +02:00
2022-07-01 18:45:04 +01:00
2024-06-03 20:40:45 +02:00
2006-04-30 18:54:39 +00:00
2024-01-14 21:02:54 +01:00
2024-06-03 20:40:45 +02:00
2024-01-14 21:02:54 +01:00
2021-01-25 21:14:57 +01:00
2024-01-14 21:02:54 +01:00
2024-06-03 20:40:45 +02:00
2007-05-05 18:24:42 +00:00
2024-06-03 20:40:45 +02:00
2024-07-16 21:18:06 +02:00
2022-09-18 13:04:22 +01:00
2023-12-28 23:17:54 +01:00
2022-09-10 13:13:14 +01:00
2023-12-28 23:17:54 +01:00
2010-01-06 20:54:52 +01:00
2022-09-10 13:13:14 +01:00
2022-01-08 21:51:59 +00:00
2010-01-06 20:54:52 +01:00
2024-07-16 21:26:47 +02:00
2024-08-02 19:58:00 +02:00
2024-07-16 21:30:32 +02:00
2024-09-19 19:37:38 +02:00
2021-09-21 20:09:51 +02:00
2024-05-19 09:30:12 +02:00
2024-06-03 20:40:45 +02:00
2017-03-05 17:04:09 +01:00
2017-03-05 17:04:09 +01:00
2022-09-27 17:30:34 +01:00
2024-01-14 21:02:54 +01:00
2024-06-03 20:40:45 +02:00
2024-05-24 08:05:00 +02:00
2024-05-24 08:05:00 +02:00
2023-08-20 21:29:09 +02:00
2024-09-04 22:19:45 +02:00
2023-08-29 22:11:55 +02:00
2019-01-01 15:32:17 +01:00
2016-01-10 15:59:26 +01:00
2024-07-08 21:11:34 +02:00
2015-11-01 16:49:04 +01:00
2017-03-05 17:04:09 +01:00
2017-03-05 17:04:09 +01:00
2024-06-03 20:40:45 +02:00
2024-07-10 19:33:33 +02:00
2007-05-05 18:24:42 +00:00
2024-09-30 19:34:04 +02:00
2024-01-27 11:26:14 +01:00
2024-05-19 11:26:44 +02:00
2021-12-16 14:41:10 +00:00
2024-01-14 21:02:54 +01:00
2024-06-03 20:40:45 +02:00
2024-06-03 20:40:45 +02:00
2024-01-14 21:02:54 +01:00
2024-01-14 21:02:54 +01:00
2024-09-30 19:40:04 +02:00
2024-07-07 20:59:42 +02:00
2024-06-03 20:40:45 +02:00
2020-08-30 17:20:20 +02:00
2024-05-08 20:17:43 +02:00
2019-12-03 22:49:09 +01:00
2024-06-03 20:40:45 +02:00
2024-01-14 21:02:54 +01:00
2014-07-19 14:04:47 +02:00
2024-06-03 20:40:45 +02:00
2022-09-10 13:13:14 +01:00
2024-01-14 21:02:54 +01:00
2021-08-14 21:25:52 +02:00
2024-04-12 18:33:48 +02:00
2024-06-10 21:13:56 +02:00
2024-07-07 20:53:04 +02:00
2024-01-14 21:02:54 +01:00
2024-01-14 21:02:54 +01:00
2024-06-03 20:40:45 +02:00
2024-06-03 20:40:45 +02:00
2024-07-07 21:20:22 +02:00
2015-01-07 16:57:10 +01:00
2024-07-07 21:17:16 +02:00
2017-03-05 17:04:09 +01:00
2017-03-05 17:04:09 +01:00
2017-03-05 17:04:09 +01:00
2024-06-03 20:40:45 +02:00
2024-06-03 20:40:45 +02:00
2023-04-22 22:40:14 +01:00
2023-02-02 13:59:48 +00:00
2017-03-05 17:04:09 +01:00
2017-03-05 17:04:09 +01:00
2023-12-16 14:27:09 +01:00
2018-08-11 18:00:22 +02:00
2023-08-28 21:32:27 +02:00
2024-01-14 21:02:54 +01:00
2023-05-14 18:50:25 +01:00
2024-01-14 21:02:54 +01:00
2024-01-14 21:02:54 +01:00
2024-01-14 21:02:54 +01:00
2017-03-05 17:04:09 +01:00
2023-08-13 10:33:05 +02:00
2017-03-05 17:04:09 +01:00
2017-03-05 17:04:09 +01:00
2023-08-13 10:33:05 +02:00
2024-08-23 18:36:08 +02:00
2017-03-05 17:04:09 +01:00
2024-06-03 20:40:45 +02:00
2022-04-27 15:25:03 +01:00
2021-09-09 21:55:11 +02:00
2024-08-14 14:43:30 +02:00
2024-07-18 20:32:04 +02:00
2024-01-14 21:02:54 +01:00
2024-01-14 21:02:54 +01:00
2024-06-03 20:40:45 +02:00
2024-09-20 21:47:19 +02:00
2024-06-03 20:40:45 +02:00
2024-06-03 20:40:45 +02:00
2024-07-11 22:51:48 +02:00
2024-01-14 21:02:54 +01:00
2017-03-05 17:04:09 +01:00
2007-05-05 17:56:55 +00:00
2024-01-14 21:02:54 +01:00
2024-09-19 19:37:38 +02:00
2024-08-14 21:49:00 +02:00
2017-03-05 17:04:09 +01:00
2017-11-02 22:58:42 +01:00
2023-04-22 22:40:14 +01:00
2023-08-28 21:32:27 +02:00
2024-05-20 14:16:17 +02:00
2023-08-11 23:07:50 +02:00
2024-06-03 20:40:45 +02:00
2021-10-23 12:08:41 +01:00
2024-09-01 09:21:16 +02:00
2023-08-13 10:33:05 +02:00
2024-07-07 21:12:47 +02:00
2023-10-26 23:03:15 +02:00
2024-06-03 20:40:45 +02:00
2024-06-03 20:40:45 +02:00
2024-01-14 21:02:54 +01:00
2024-01-14 21:02:54 +01:00
2024-06-03 20:40:45 +02:00
2024-04-22 21:07:41 +02:00
2024-06-03 20:40:45 +02:00
2017-03-05 17:04:09 +01:00
2024-06-03 20:40:45 +02:00
2017-03-05 17:04:09 +01:00
2023-08-28 21:32:27 +02:00
2024-06-03 20:40:45 +02:00
2024-06-03 20:40:45 +02:00
2024-06-03 20:40:45 +02:00
2017-03-05 17:04:09 +01:00
2012-03-11 15:57:40 +01:00
2024-01-14 21:02:54 +01:00
2022-10-16 13:11:12 +01:00
2024-01-14 21:02:54 +01:00
2024-01-14 21:02:54 +01:00
2024-05-20 14:07:30 +02:00
2017-03-05 17:04:09 +01:00
2017-03-05 17:04:09 +01:00
2017-03-05 17:04:09 +01:00
2024-09-19 19:37:38 +02:00
2024-06-03 20:40:45 +02:00
2024-05-20 14:21:53 +02:00
2023-08-13 10:26:20 +02:00
2024-01-14 21:02:54 +01:00
2024-05-13 22:00:40 +02:00
2022-01-29 22:20:48 +00:00
2019-07-19 22:05:51 +02:00
2024-06-03 20:40:45 +02:00
2017-03-05 17:04:09 +01:00
2023-02-27 15:49:53 +00:00
2024-03-02 19:27:47 +01:00
2017-03-05 17:04:09 +01:00
2024-06-03 20:40:45 +02:00
2024-06-03 20:40:45 +02:00
2024-05-31 12:00:49 +02:00
2024-09-19 19:37:38 +02:00
2004-06-13 20:20:40 +00:00
2024-01-14 21:02:54 +01:00
2024-04-14 20:43:27 +02:00
2024-05-22 16:49:17 +02:00
2022-04-27 15:25:03 +01:00
2024-03-02 19:27:47 +01:00
2024-09-23 20:12:48 +02:00
2017-03-05 17:04:09 +01:00
2024-03-02 19:27:47 +01:00
2024-04-08 22:23:22 +02:00
2024-01-14 21:02:54 +01:00
2020-10-26 21:12:46 +01:00
2024-09-23 20:12:48 +02:00
2023-08-23 21:20:00 +02:00
2024-01-14 21:02:54 +01:00
2024-06-03 20:40:45 +02:00
2023-12-28 23:17:54 +01:00
2023-12-11 17:17:20 +01:00
2023-08-28 21:32:27 +02:00
2024-06-03 20:40:45 +02:00
2024-06-21 07:49:39 +02:00
2017-03-05 17:04:09 +01:00
2016-08-30 23:26:57 +02:00
2024-01-14 21:02:54 +01:00
2017-03-05 17:04:09 +01:00
2017-03-05 17:04:09 +01:00
2017-03-05 17:04:09 +01:00
2023-08-28 21:32:27 +02:00
2024-01-14 21:02:54 +01:00
2024-09-19 19:37:38 +02:00
2017-03-05 17:04:09 +01:00
2024-05-20 14:20:09 +02:00
2017-03-05 17:04:09 +01:00
2017-03-05 17:04:09 +01:00
2017-03-05 17:04:09 +01:00
2024-06-14 20:47:05 +02:00
2023-08-22 19:28:42 +01:00
2024-01-14 21:02:54 +01:00
2024-09-10 21:43:05 +02:00
2024-08-14 21:49:00 +02:00
2024-07-07 21:14:59 +02:00
2022-10-16 13:11:12 +01:00
2024-09-19 19:37:38 +02:00
2024-05-17 18:39:24 +02:00
2024-05-01 18:42:11 +02:00
2024-09-19 19:37:38 +02:00
2024-06-10 18:20:04 +02:00
2024-01-14 21:02:54 +01:00
2022-07-29 21:36:21 +01:00
2021-01-11 19:40:15 +01:00
2020-01-27 22:47:09 +01:00
2023-11-25 15:30:46 +01:00
2017-03-05 17:04:09 +01:00
2024-09-19 19:37:38 +02:00
2021-09-09 21:55:11 +02:00
2022-06-14 17:41:28 +01:00
2024-06-03 20:40:45 +02:00
2024-01-14 21:02:54 +01:00
2017-03-05 17:04:09 +01:00
2024-07-04 11:46:05 +02:00
2021-09-09 21:55:11 +02:00
2019-01-17 16:07:22 +01:00
2024-07-07 21:07:56 +02:00
2024-07-29 20:51:05 +02:00
2024-01-14 21:02:54 +01:00
2021-10-16 15:23:36 +01:00
2023-08-11 19:30:27 +02:00
2017-03-05 17:04:09 +01:00
2022-06-14 17:41:28 +01:00
2024-06-03 20:40:45 +02:00
2020-08-15 18:55:18 +02:00
2024-07-15 20:00:48 +02:00
2024-04-18 23:53:02 +02:00
2017-03-05 17:04:09 +01:00
2017-03-05 17:04:09 +01:00
2024-09-19 19:37:38 +02:00
2023-08-09 16:50:52 +02:00
2017-03-05 17:04:09 +01:00
2023-06-10 21:40:39 +01:00
2023-08-28 21:32:27 +02:00
2024-05-20 14:03:46 +02:00
2024-01-14 21:02:54 +01:00
2022-09-18 13:04:22 +01:00
2024-05-20 18:14:25 +02:00
2024-01-14 21:02:54 +01:00
2024-06-03 20:40:45 +02:00
2014-08-22 19:21:47 +02:00
2022-07-01 18:45:04 +01:00
2024-06-03 20:40:45 +02:00
2024-01-14 21:02:54 +01:00
2024-01-14 21:02:54 +01:00
2023-11-11 09:12:27 +01:00
2024-06-03 20:40:45 +02:00
2017-03-05 17:04:09 +01:00
2024-01-14 21:02:54 +01:00
2017-03-05 17:04:09 +01:00
2024-06-03 20:40:45 +02:00
2017-03-05 17:04:09 +01:00
2022-06-14 17:41:28 +01:00
2024-01-14 21:02:54 +01:00
2024-01-14 21:02:54 +01:00
2024-07-07 21:16:08 +02:00
2024-04-14 20:28:29 +02:00
2024-04-08 22:19:06 +02:00
2024-05-21 23:27:03 +02:00
2023-08-13 10:33:05 +02:00
2024-09-19 19:37:38 +02:00