| 
									
										
										
										
											2012-10-05 22:26:30 +02:00
										 |  |  |  | " Vim syntax file | 
					
						
							| 
									
										
										
										
											2024-04-14 19:57:00 +03:00
										 |  |  |  | " Language:		Java | 
					
						
							|  |  |  |  | " Maintainer:		Aliaksei Budavei <0x000c70 AT gmail DOT com> | 
					
						
							|  |  |  |  | " Former Maintainer:	Claudio Fleiner <claudio@fleiner.com> | 
					
						
							|  |  |  |  | " Repository:		https://github.com/zzzyxwvut/java-vim.git | 
					
						
							| 
									
										
										
										
											2024-05-31 12:11:34 +03:00
										 |  |  |  | " Last Change:		2024 May 30 | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | 
 | 
					
						
							|  |  |  |  | " Please check :help java.vim for comments on some of the options available. | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-08-30 23:26:57 +02:00
										 |  |  |  | " quit when a syntax file was already loaded | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | if !exists("main_syntax") | 
					
						
							| 
									
										
										
										
											2016-08-30 23:26:57 +02:00
										 |  |  |  |   if exists("b:current_syntax") | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  |     finish | 
					
						
							|  |  |  |  |   endif | 
					
						
							|  |  |  |  |   " we define it here so that included files can test for it | 
					
						
							|  |  |  |  |   let main_syntax='java' | 
					
						
							| 
									
										
										
										
											2010-01-06 20:54:52 +01:00
										 |  |  |  |   syn region javaFold start="{" end="}" transparent fold | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | endif | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2012-10-05 22:26:30 +02:00
										 |  |  |  | let s:cpo_save = &cpo | 
					
						
							|  |  |  |  | set cpo&vim | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  | """" STRIVE TO REMAIN COMPATIBLE FOR AT LEAST VIM 7.0. | 
					
						
							|  |  |  |  | let s:ff = {} | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | function! s:ff.LeftConstant(x, y) abort | 
					
						
							|  |  |  |  |   return a:x | 
					
						
							|  |  |  |  | endfunction | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | function! s:ff.RightConstant(x, y) abort | 
					
						
							|  |  |  |  |   return a:y | 
					
						
							|  |  |  |  | endfunction | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | if !exists("*s:ReportOnce") | 
					
						
							|  |  |  |  |   function s:ReportOnce(message) abort | 
					
						
							|  |  |  |  |     echomsg 'syntax/java.vim: ' . a:message | 
					
						
							|  |  |  |  |   endfunction | 
					
						
							|  |  |  |  | else | 
					
						
							|  |  |  |  |   function! s:ReportOnce(dummy) | 
					
						
							|  |  |  |  |   endfunction | 
					
						
							|  |  |  |  | endif | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-04-04 21:51:18 +02:00
										 |  |  |  | " Admit the ASCII dollar sign to keyword characters (JLS-17, §3.8): | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  | try | 
					
						
							|  |  |  |  |   exec 'syntax iskeyword ' . &l:iskeyword . ',$' | 
					
						
							|  |  |  |  | catch /\<E410:/ | 
					
						
							|  |  |  |  |   call s:ReportOnce(v:exception) | 
					
						
							|  |  |  |  |   setlocal iskeyword+=$ | 
					
						
							|  |  |  |  | endtry | 
					
						
							| 
									
										
										
										
											2024-04-04 21:51:18 +02:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | " some characters that cannot be in a java program (outside a string) | 
					
						
							|  |  |  |  | syn match javaError "[\\@`]" | 
					
						
							| 
									
										
										
										
											2015-03-02 23:16:07 +01:00
										 |  |  |  | syn match javaError "<<<\|\.\.\|=>\|||=\|&&=\|\*\/" | 
					
						
							| 
									
										
										
										
											2012-10-05 22:26:30 +02:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | " use separate name so that it can be deleted in javacc.vim | 
					
						
							|  |  |  |  | syn match   javaError2 "#\|=<" | 
					
						
							| 
									
										
										
										
											2016-08-31 22:22:10 +02:00
										 |  |  |  | hi def link javaError2 javaError | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-04-04 21:51:18 +02:00
										 |  |  |  | " Keywords (JLS-17, §3.9): | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | syn keyword javaExternal	native package | 
					
						
							| 
									
										
										
										
											2024-04-04 21:51:18 +02:00
										 |  |  |  | syn match   javaExternal	"\<import\>\%(\s\+static\>\)\=" | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | syn keyword javaError		goto const | 
					
						
							|  |  |  |  | syn keyword javaConditional	if else switch | 
					
						
							|  |  |  |  | syn keyword javaRepeat		while for do | 
					
						
							|  |  |  |  | syn keyword javaBoolean		true false | 
					
						
							|  |  |  |  | syn keyword javaConstant	null | 
					
						
							|  |  |  |  | syn keyword javaTypedef		this super | 
					
						
							| 
									
										
										
										
											2024-04-04 21:51:18 +02:00
										 |  |  |  | syn keyword javaOperator	new instanceof | 
					
						
							|  |  |  |  | syn match   javaOperator	"\<var\>\%(\s*(\)\@!" | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
											  
											
												runtime(java): Recognise _when_ clauses in _switch_ blocks
Also:
- distinguish _yield_ when used as a contextual keyword from
  when used qualified as a method or a method reference (as
  can be seen in testdir/input/java_switch.java, variables
  and method declarations named _yield_ will be recognised
  as the namesake keyword--consider picking other names for
  variables, and defining g:java_highlight_functions to have
  method names painted; since _yield_ statements can have
  trailing parens, they must be recognised as statements,
  for only qualified _yield_ method calls are supported);
- recognise grouped _default_ _case_ labels;
- describe primitive types for _case_ labels (JLS, §14.11,
  §3.10.1);
- recognise some non-ASCII identifiers (see javaLambdaDef,
  javaUserLabel) (further improvement for better recognition
  of identifiers will be arranged in a separate PR).
Because the arrow '->' is used in two kinds of expressions,
lambda (abstractions) and _switch_, necessary changes were
made for the recognition of either (and further improvement
touching lambda expressions will be separately arranged).
Because 'default' is used for instance method declarations
in interfaces and in _switch_ labels, necessary changes were
made for the recognition of either (and further improvement
touching method declarations will be separately arranged).
Finally, it deemed appropriate to put 'yield' in the syntax
group of javaOperator rather than javaStatement, for its
member 'var' is also another contextual keyword (e.g., this
is valid syntax: "var var = var(test.var);").
References:
https://openjdk.org/jeps/361 (Switch Expressions)
https://openjdk.org/jeps/440 (Record Patterns)
https://openjdk.org/jeps/441 (Pattern Matching for switch)
Also, add a Java specific filetype plugin for the syntax
test, so that no soft-wrapping of long indented lines occur.
Otherwise the syntax scripts would miss a few lines during
scrolling and verification of the screen dumps.
closes: #14105
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-02-28 21:30:22 +01:00
										 |  |  |  | " Since the yield statement, which could take a parenthesised operand, | 
					
						
							|  |  |  |  | " and _qualified_ yield methods get along within the switch block | 
					
						
							|  |  |  |  | " (JLS-17, §3.8), it seems futile to make a region definition for this | 
					
						
							|  |  |  |  | " block; instead look for the _yield_ word alone, and if found, | 
					
						
							|  |  |  |  | " backtrack (arbitrarily) 80 bytes, at most, on the matched line and, | 
					
						
							|  |  |  |  | " if necessary, on the line before that (h: \@<=), trying to match | 
					
						
							|  |  |  |  | " neither a method reference nor a qualified method invocation. | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  | try | 
					
						
							|  |  |  |  |   syn match   javaOperator	"\%(\%(::\|\.\)[[:space:]\n]*\)\@80<!\<yield\>" | 
					
						
							|  |  |  |  |   let s:ff.Peek = s:ff.LeftConstant | 
					
						
							|  |  |  |  | catch /\<E59:/ | 
					
						
							|  |  |  |  |   call s:ReportOnce(v:exception) | 
					
						
							|  |  |  |  |   syn match   javaOperator	"\%(\%(::\|\.\)[[:space:]\n]*\)\@<!\<yield\>" | 
					
						
							|  |  |  |  |   let s:ff.Peek = s:ff.RightConstant | 
					
						
							|  |  |  |  | endtry | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | syn keyword javaType		boolean char byte short int long float double | 
					
						
							|  |  |  |  | syn keyword javaType		void | 
					
						
							| 
									
										
											  
											
												runtime(java): Recognise _when_ clauses in _switch_ blocks
Also:
- distinguish _yield_ when used as a contextual keyword from
  when used qualified as a method or a method reference (as
  can be seen in testdir/input/java_switch.java, variables
  and method declarations named _yield_ will be recognised
  as the namesake keyword--consider picking other names for
  variables, and defining g:java_highlight_functions to have
  method names painted; since _yield_ statements can have
  trailing parens, they must be recognised as statements,
  for only qualified _yield_ method calls are supported);
- recognise grouped _default_ _case_ labels;
- describe primitive types for _case_ labels (JLS, §14.11,
  §3.10.1);
- recognise some non-ASCII identifiers (see javaLambdaDef,
  javaUserLabel) (further improvement for better recognition
  of identifiers will be arranged in a separate PR).
Because the arrow '->' is used in two kinds of expressions,
lambda (abstractions) and _switch_, necessary changes were
made for the recognition of either (and further improvement
touching lambda expressions will be separately arranged).
Because 'default' is used for instance method declarations
in interfaces and in _switch_ labels, necessary changes were
made for the recognition of either (and further improvement
touching method declarations will be separately arranged).
Finally, it deemed appropriate to put 'yield' in the syntax
group of javaOperator rather than javaStatement, for its
member 'var' is also another contextual keyword (e.g., this
is valid syntax: "var var = var(test.var);").
References:
https://openjdk.org/jeps/361 (Switch Expressions)
https://openjdk.org/jeps/440 (Record Patterns)
https://openjdk.org/jeps/441 (Pattern Matching for switch)
Also, add a Java specific filetype plugin for the syntax
test, so that no soft-wrapping of long indented lines occur.
Otherwise the syntax scripts would miss a few lines during
scrolling and verification of the screen dumps.
closes: #14105
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-02-28 21:30:22 +01:00
										 |  |  |  | syn keyword javaStatement	return | 
					
						
							| 
									
										
										
										
											2024-04-04 21:51:18 +02:00
										 |  |  |  | syn keyword javaStorageClass	static synchronized transient volatile strictfp serializable | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | syn keyword javaExceptions	throw try catch finally | 
					
						
							|  |  |  |  | syn keyword javaAssert		assert | 
					
						
							| 
									
										
										
										
											2024-04-04 21:51:18 +02:00
										 |  |  |  | syn keyword javaMethodDecl	throws | 
					
						
							|  |  |  |  | " Differentiate a "MyClass.class" literal from the keyword "class". | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | syn match   javaTypedef		"\.\s*\<class\>"ms=s+1 | 
					
						
							| 
									
										
										
										
											2024-04-04 21:51:18 +02:00
										 |  |  |  | syn keyword javaClassDecl	enum extends implements interface | 
					
						
							|  |  |  |  | syn match   javaClassDecl	"\<permits\>\%(\s*(\)\@!" | 
					
						
							|  |  |  |  | syn match   javaClassDecl	"\<record\>\%(\s*(\)\@!" | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | syn match   javaClassDecl	"^class\>" | 
					
						
							|  |  |  |  | syn match   javaClassDecl	"[^.]\s*\<class\>"ms=s+1 | 
					
						
							| 
									
										
										
										
											2024-04-14 19:57:00 +03:00
										 |  |  |  | syn match   javaAnnotation	"@\%(\K\k*\.\)*\K\k*\>" | 
					
						
							| 
									
										
										
										
											2010-05-14 23:24:24 +02:00
										 |  |  |  | syn match   javaClassDecl	"@interface\>" | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | syn keyword javaBranch		break continue nextgroup=javaUserLabelRef skipwhite | 
					
						
							|  |  |  |  | syn match   javaUserLabelRef	"\k\+" contained | 
					
						
							| 
									
										
										
										
											2006-04-30 18:54:39 +00:00
										 |  |  |  | syn match   javaVarArg		"\.\.\." | 
					
						
							| 
									
										
										
										
											2024-04-04 21:51:18 +02:00
										 |  |  |  | syn keyword javaScopeDecl	public protected private | 
					
						
							|  |  |  |  | syn keyword javaConceptKind	abstract final | 
					
						
							|  |  |  |  | syn match   javaConceptKind	"\<non-sealed\>" | 
					
						
							|  |  |  |  | syn match   javaConceptKind	"\<sealed\>\%(\s*(\)\@!" | 
					
						
							| 
									
										
											  
											
												runtime(java): Recognise _when_ clauses in _switch_ blocks
Also:
- distinguish _yield_ when used as a contextual keyword from
  when used qualified as a method or a method reference (as
  can be seen in testdir/input/java_switch.java, variables
  and method declarations named _yield_ will be recognised
  as the namesake keyword--consider picking other names for
  variables, and defining g:java_highlight_functions to have
  method names painted; since _yield_ statements can have
  trailing parens, they must be recognised as statements,
  for only qualified _yield_ method calls are supported);
- recognise grouped _default_ _case_ labels;
- describe primitive types for _case_ labels (JLS, §14.11,
  §3.10.1);
- recognise some non-ASCII identifiers (see javaLambdaDef,
  javaUserLabel) (further improvement for better recognition
  of identifiers will be arranged in a separate PR).
Because the arrow '->' is used in two kinds of expressions,
lambda (abstractions) and _switch_, necessary changes were
made for the recognition of either (and further improvement
touching lambda expressions will be separately arranged).
Because 'default' is used for instance method declarations
in interfaces and in _switch_ labels, necessary changes were
made for the recognition of either (and further improvement
touching method declarations will be separately arranged).
Finally, it deemed appropriate to put 'yield' in the syntax
group of javaOperator rather than javaStatement, for its
member 'var' is also another contextual keyword (e.g., this
is valid syntax: "var var = var(test.var);").
References:
https://openjdk.org/jeps/361 (Switch Expressions)
https://openjdk.org/jeps/440 (Record Patterns)
https://openjdk.org/jeps/441 (Pattern Matching for switch)
Also, add a Java specific filetype plugin for the syntax
test, so that no soft-wrapping of long indented lines occur.
Otherwise the syntax scripts would miss a few lines during
scrolling and verification of the screen dumps.
closes: #14105
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-02-28 21:30:22 +01:00
										 |  |  |  | syn match   javaConceptKind	"\<default\>\%(\s*\%(:\|->\)\)\@!" | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-04-04 21:51:18 +02:00
										 |  |  |  | " Note that a "module-info" file will be recognised with an arbitrary | 
					
						
							|  |  |  |  | " file extension (or no extension at all) so that more than one such | 
					
						
							|  |  |  |  | " declaration for the same Java module can be maintained for modular | 
					
						
							|  |  |  |  | " testing in a project without attendant confusion for IDEs, with the | 
					
						
							|  |  |  |  | " ".java\=" extension used for a production version and an arbitrary | 
					
						
							|  |  |  |  | " extension used for a testing version. | 
					
						
							|  |  |  |  | let s:module_info_cur_buf = fnamemodify(bufname("%"), ":t") =~ '^module-info\%(\.class\>\)\@!' | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  | lockvar s:module_info_cur_buf | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | if !(v:version < 704) | 
					
						
							|  |  |  |  |   " Request the new regexp engine for [:upper:] and [:lower:]. | 
					
						
							|  |  |  |  |   let [s:ff.Engine, s:ff.UpperCase, s:ff.LowerCase] = repeat([s:ff.LeftConstant], 3) | 
					
						
							|  |  |  |  | else | 
					
						
							|  |  |  |  |   " XXX: \C\<[^a-z0-9]\k*\> rejects "type", but matches "τύπος". | 
					
						
							|  |  |  |  |   " XXX: \C\<[^A-Z0-9]\k*\> rejects "Method", but matches "Μέθοδος". | 
					
						
							|  |  |  |  |   let [s:ff.Engine, s:ff.UpperCase, s:ff.LowerCase] = repeat([s:ff.RightConstant], 3) | 
					
						
							|  |  |  |  | endif | 
					
						
							| 
									
										
										
										
											2024-04-04 21:51:18 +02:00
										 |  |  |  | 
 | 
					
						
							|  |  |  |  | " Java modules (since Java 9, for "module-info.java" file). | 
					
						
							|  |  |  |  | if s:module_info_cur_buf | 
					
						
							|  |  |  |  |   syn keyword javaModuleStorageClass	module transitive | 
					
						
							|  |  |  |  |   syn keyword javaModuleStmt		open requires exports opens uses provides | 
					
						
							|  |  |  |  |   syn keyword javaModuleExternal	to with | 
					
						
							| 
									
										
										
										
											2018-07-29 15:07:52 +02:00
										 |  |  |  | endif | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2006-01-19 22:16:24 +00:00
										 |  |  |  | if exists("java_highlight_java_lang_ids") | 
					
						
							|  |  |  |  |   let java_highlight_all=1 | 
					
						
							|  |  |  |  | endif | 
					
						
							| 
									
										
										
										
											2018-07-29 15:07:52 +02:00
										 |  |  |  | if exists("java_highlight_all")  || exists("java_highlight_java")  || exists("java_highlight_java_lang") | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  |   " java.lang.* | 
					
						
							| 
									
										
										
										
											2022-06-09 20:45:54 +01:00
										 |  |  |  |   " | 
					
						
							|  |  |  |  |   " The keywords of javaR_JavaLang, javaC_JavaLang, javaE_JavaLang, | 
					
						
							|  |  |  |  |   " and javaX_JavaLang are sub-grouped according to the Java version | 
					
						
							|  |  |  |  |   " of their introduction, and sub-group keywords (that is, class | 
					
						
							|  |  |  |  |   " names) are arranged in alphabetical order, so that future newer | 
					
						
							|  |  |  |  |   " keywords can be pre-sorted and appended without disturbing | 
					
						
							|  |  |  |  |   " the current keyword placement. The below _match_es follow suit. | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-03-26 20:12:05 +03:00
										 |  |  |  |   syn keyword javaR_JavaLang ArithmeticException ArrayIndexOutOfBoundsException ArrayStoreException ClassCastException IllegalArgumentException IllegalMonitorStateException IllegalThreadStateException IndexOutOfBoundsException NegativeArraySizeException NullPointerException NumberFormatException RuntimeException SecurityException StringIndexOutOfBoundsException IllegalStateException UnsupportedOperationException EnumConstantNotPresentException TypeNotPresentException IllegalCallerException LayerInstantiationException WrongThreadException MatchException | 
					
						
							| 
									
										
										
										
											2006-01-19 22:16:24 +00:00
										 |  |  |  |   syn cluster javaClasses add=javaR_JavaLang | 
					
						
							| 
									
										
										
										
											2016-08-31 22:22:10 +02:00
										 |  |  |  |   hi def link javaR_JavaLang javaR_Java | 
					
						
							| 
									
										
										
										
											2022-06-09 20:45:54 +01:00
										 |  |  |  |   " Member enumerations: | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  |   exec 'syn match javaC_JavaLang "\%(\<Thread\.\)\@' . s:ff.Peek('7', '') . '<=\<State\>"' | 
					
						
							|  |  |  |  |   exec 'syn match javaC_JavaLang "\%(\<Character\.\)\@' . s:ff.Peek('10', '') . '<=\<UnicodeScript\>"' | 
					
						
							|  |  |  |  |   exec 'syn match javaC_JavaLang "\%(\<ProcessBuilder\.Redirect\.\)\@' . s:ff.Peek('24', '') . '<=\<Type\>"' | 
					
						
							|  |  |  |  |   exec 'syn match javaC_JavaLang "\%(\<StackWalker\.\)\@' . s:ff.Peek('12', '') . '<=\<Option\>"' | 
					
						
							|  |  |  |  |   exec 'syn match javaC_JavaLang "\%(\<System\.Logger\.\)\@' . s:ff.Peek('14', '') . '<=\<Level\>"' | 
					
						
							| 
									
										
										
										
											2022-06-09 20:45:54 +01:00
										 |  |  |  |   " Member classes: | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  |   exec 'syn match javaC_JavaLang "\%(\<Character\.\)\@' . s:ff.Peek('10', '') . '<=\<Subset\>"' | 
					
						
							|  |  |  |  |   exec 'syn match javaC_JavaLang "\%(\<Character\.\)\@' . s:ff.Peek('10', '') . '<=\<UnicodeBlock\>"' | 
					
						
							|  |  |  |  |   exec 'syn match javaC_JavaLang "\%(\<ProcessBuilder\.\)\@' . s:ff.Peek('15', '') . '<=\<Redirect\>"' | 
					
						
							|  |  |  |  |   exec 'syn match javaC_JavaLang "\%(\<ModuleLayer\.\)\@' . s:ff.Peek('12', '') . '<=\<Controller\>"' | 
					
						
							|  |  |  |  |   exec 'syn match javaC_JavaLang "\%(\<Runtime\.\)\@' . s:ff.Peek('8', '') . '<=\<Version\>"' | 
					
						
							|  |  |  |  |   exec 'syn match javaC_JavaLang "\%(\<System\.\)\@' . s:ff.Peek('7', '') . '<=\<LoggerFinder\>"' | 
					
						
							|  |  |  |  |   exec 'syn match javaC_JavaLang "\%(\<Enum\.\)\@' . s:ff.Peek('5', '') . '<=\<EnumDesc\>"' | 
					
						
							| 
									
										
										
										
											2022-06-09 20:45:54 +01:00
										 |  |  |  |   syn keyword javaC_JavaLang Boolean Character Class ClassLoader Compiler Double Float Integer Long Math Number Object Process Runtime SecurityManager String StringBuffer Thread ThreadGroup Byte Short Void InheritableThreadLocal Package RuntimePermission ThreadLocal StrictMath StackTraceElement Enum ProcessBuilder StringBuilder ClassValue Module ModuleLayer StackWalker Record | 
					
						
							|  |  |  |  |   syn match   javaC_JavaLang "\<System\>"	" See javaDebug. | 
					
						
							| 
									
										
										
										
											2024-04-04 21:51:18 +02:00
										 |  |  |  |   " As of JDK 21, java.lang.Compiler is no more (deprecated in JDK 9). | 
					
						
							| 
									
										
										
										
											2024-03-26 20:12:05 +03:00
										 |  |  |  |   syn keyword javaLangDeprecated Compiler | 
					
						
							| 
									
										
										
										
											2006-01-19 22:16:24 +00:00
										 |  |  |  |   syn cluster javaClasses add=javaC_JavaLang | 
					
						
							| 
									
										
										
										
											2016-08-31 22:22:10 +02:00
										 |  |  |  |   hi def link javaC_JavaLang javaC_Java | 
					
						
							| 
									
										
										
										
											2022-06-09 20:45:54 +01:00
										 |  |  |  |   syn keyword javaE_JavaLang AbstractMethodError ClassCircularityError ClassFormatError Error IllegalAccessError IncompatibleClassChangeError InstantiationError InternalError LinkageError NoClassDefFoundError NoSuchFieldError NoSuchMethodError OutOfMemoryError StackOverflowError ThreadDeath UnknownError UnsatisfiedLinkError VerifyError VirtualMachineError ExceptionInInitializerError UnsupportedClassVersionError AssertionError BootstrapMethodError | 
					
						
							| 
									
										
										
										
											2006-01-19 22:16:24 +00:00
										 |  |  |  |   syn cluster javaClasses add=javaE_JavaLang | 
					
						
							| 
									
										
										
										
											2016-08-31 22:22:10 +02:00
										 |  |  |  |   hi def link javaE_JavaLang javaE_Java | 
					
						
							| 
									
										
										
										
											2022-06-09 20:45:54 +01:00
										 |  |  |  |   syn keyword javaX_JavaLang ClassNotFoundException CloneNotSupportedException Exception IllegalAccessException InstantiationException InterruptedException NoSuchMethodException Throwable NoSuchFieldException ReflectiveOperationException | 
					
						
							| 
									
										
										
										
											2006-01-19 22:16:24 +00:00
										 |  |  |  |   syn cluster javaClasses add=javaX_JavaLang | 
					
						
							| 
									
										
										
										
											2016-08-31 22:22:10 +02:00
										 |  |  |  |   hi def link javaX_JavaLang javaX_Java | 
					
						
							| 
									
										
										
										
											2006-01-19 22:16:24 +00:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-08-31 22:22:10 +02:00
										 |  |  |  |   hi def link javaR_Java javaR_ | 
					
						
							|  |  |  |  |   hi def link javaC_Java javaC_ | 
					
						
							|  |  |  |  |   hi def link javaE_Java javaE_ | 
					
						
							|  |  |  |  |   hi def link javaX_Java javaX_ | 
					
						
							|  |  |  |  |   hi def link javaX_		     javaExceptions | 
					
						
							|  |  |  |  |   hi def link javaR_		     javaExceptions | 
					
						
							|  |  |  |  |   hi def link javaE_		     javaExceptions | 
					
						
							|  |  |  |  |   hi def link javaC_		     javaConstant | 
					
						
							| 
									
										
										
										
											2006-01-19 22:16:24 +00:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  |   syn keyword javaLangObject clone equals finalize getClass hashCode | 
					
						
							|  |  |  |  |   syn keyword javaLangObject notify notifyAll toString wait | 
					
						
							| 
									
										
										
										
											2016-08-31 22:22:10 +02:00
										 |  |  |  |   hi def link javaLangObject		     javaConstant | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | endif | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  | if filereadable(expand("<sfile>:p:h") . "/javaid.vim") | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  |   source <sfile>:p:h/javaid.vim | 
					
						
							|  |  |  |  | endif | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | if exists("java_space_errors") | 
					
						
							|  |  |  |  |   if !exists("java_no_trail_space_error") | 
					
						
							| 
									
										
										
										
											2010-05-14 23:24:24 +02:00
										 |  |  |  |     syn match	javaSpaceError	"\s\+$" | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  |   endif | 
					
						
							|  |  |  |  |   if !exists("java_no_tab_space_error") | 
					
						
							| 
									
										
										
										
											2010-05-14 23:24:24 +02:00
										 |  |  |  |     syn match	javaSpaceError	" \+\t"me=e-1 | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  |   endif | 
					
						
							|  |  |  |  | endif | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  | exec 'syn match javaUserLabel "^\s*\<\K\k*\>\%(\<default\>\)\@' . s:ff.Peek('7', '') . '<!\s*:"he=e-1' | 
					
						
							| 
									
										
											  
											
												runtime(java): Recognise _when_ clauses in _switch_ blocks
Also:
- distinguish _yield_ when used as a contextual keyword from
  when used qualified as a method or a method reference (as
  can be seen in testdir/input/java_switch.java, variables
  and method declarations named _yield_ will be recognised
  as the namesake keyword--consider picking other names for
  variables, and defining g:java_highlight_functions to have
  method names painted; since _yield_ statements can have
  trailing parens, they must be recognised as statements,
  for only qualified _yield_ method calls are supported);
- recognise grouped _default_ _case_ labels;
- describe primitive types for _case_ labels (JLS, §14.11,
  §3.10.1);
- recognise some non-ASCII identifiers (see javaLambdaDef,
  javaUserLabel) (further improvement for better recognition
  of identifiers will be arranged in a separate PR).
Because the arrow '->' is used in two kinds of expressions,
lambda (abstractions) and _switch_, necessary changes were
made for the recognition of either (and further improvement
touching lambda expressions will be separately arranged).
Because 'default' is used for instance method declarations
in interfaces and in _switch_ labels, necessary changes were
made for the recognition of either (and further improvement
touching method declarations will be separately arranged).
Finally, it deemed appropriate to put 'yield' in the syntax
group of javaOperator rather than javaStatement, for its
member 'var' is also another contextual keyword (e.g., this
is valid syntax: "var var = var(test.var);").
References:
https://openjdk.org/jeps/361 (Switch Expressions)
https://openjdk.org/jeps/440 (Record Patterns)
https://openjdk.org/jeps/441 (Pattern Matching for switch)
Also, add a Java specific filetype plugin for the syntax
test, so that no soft-wrapping of long indented lines occur.
Otherwise the syntax scripts would miss a few lines during
scrolling and verification of the screen dumps.
closes: #14105
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-02-28 21:30:22 +01:00
										 |  |  |  | syn region  javaLabelRegion	transparent matchgroup=javaLabel start="\<case\>" matchgroup=NONE end=":\|->" contains=javaLabelCastType,javaLabelNumber,javaCharacter,javaString,javaConstant,@javaClasses,javaLabelDefault,javaLabelVarType,javaLabelWhenClause | 
					
						
							|  |  |  |  | syn region  javaLabelRegion	transparent matchgroup=javaLabel start="\<default\>\%(\s*\%(:\|->\)\)\@=" matchgroup=NONE end=":\|->" oneline | 
					
						
							|  |  |  |  | " Consider grouped _default_ _case_ labels, i.e. | 
					
						
							|  |  |  |  | " case null, default -> | 
					
						
							|  |  |  |  | " case null: default: | 
					
						
							|  |  |  |  | syn keyword javaLabelDefault	contained default | 
					
						
							|  |  |  |  | syn keyword javaLabelVarType	contained var | 
					
						
							|  |  |  |  | syn keyword javaLabelCastType	contained char byte short int | 
					
						
							|  |  |  |  | " Allow for the contingency of the enclosing region not being able to | 
					
						
							|  |  |  |  | " _keep_ its _end_, e.g. case ':':. | 
					
						
							|  |  |  |  | syn region  javaLabelWhenClause	contained transparent matchgroup=javaLabel start="\<when\>" matchgroup=NONE end=":"me=e-1 end="->"me=e-2 contains=TOP,javaExternal | 
					
						
							|  |  |  |  | syn match   javaLabelNumber	contained "\<0\>[lL]\@!" | 
					
						
							|  |  |  |  | syn match   javaLabelNumber	contained "\<\%(0\%([xX]\x\%(_*\x\)*\|_*\o\%(_*\o\)*\|[bB][01]\%(_*[01]\)*\)\|[1-9]\%(_*\d\)*\)\>[lL]\@!" | 
					
						
							|  |  |  |  | hi def link javaLabelDefault	javaLabel | 
					
						
							|  |  |  |  | hi def link javaLabelVarType	javaOperator | 
					
						
							|  |  |  |  | hi def link javaLabelNumber	javaNumber | 
					
						
							|  |  |  |  | hi def link javaLabelCastType	javaType | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | 
 | 
					
						
							|  |  |  |  | " Comments | 
					
						
							|  |  |  |  | syn keyword javaTodo		 contained TODO FIXME XXX | 
					
						
							| 
									
										
										
										
											2024-03-03 17:51:01 +03:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | if exists("java_comment_strings") | 
					
						
							|  |  |  |  |   syn region  javaCommentString    contained start=+"+ end=+"+ end=+$+ end=+\*/+me=s-1,he=s-1 contains=javaSpecial,javaCommentStar,javaSpecialChar,@Spell | 
					
						
							| 
									
										
										
										
											2024-03-03 17:51:01 +03:00
										 |  |  |  |   syn region  javaCommentString    contained start=+"""[ \t\x0c\r]*$+hs=e+1 end=+"""+he=s-1 contains=javaSpecial,javaCommentStar,javaSpecialChar,@Spell,javaSpecialError,javaTextBlockError | 
					
						
							|  |  |  |  |   syn region  javaComment2String   contained start=+"+ end=+$\|"+ contains=javaSpecial,javaSpecialChar,@Spell | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  |   syn match   javaCommentCharacter contained "'\\[^']\{1,6\}'" contains=javaSpecialChar | 
					
						
							|  |  |  |  |   syn match   javaCommentCharacter contained "'\\''" contains=javaSpecialChar | 
					
						
							|  |  |  |  |   syn match   javaCommentCharacter contained "'[^\\]'" | 
					
						
							| 
									
										
											  
											
												runtime(java): Recognise string templates (#14150)
As this is encouraged in the referenced JEPs, "to visually
distinguish a string template from a string literal, and
a text block template from a text block", the default
colours for java\%[Debug]StrTempl are made distinct from
java\%[Debug]String.
According to §3.2 Lexical Translations (JLS, c. 1996 or any
more recent version), line terminators, white space, and
comments are discarded before tokens are accepted. Since
a template expression comprises a template processor, a dot,
and a template, it may be visually appealing to break up
its head across a few lines whenever its tail already spans
multiple lines.  Curiously, no allowance for it is made in
the distributed tests for OpenJDK 21; the proposed regexp
patterns take in consideration a line terminator and white
space after a dot.
References:
https://openjdk.org/jeps/430 (Preview)
https://openjdk.org/jeps/459 (Second Preview)
https://openjdk.org/jeps/465
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-03-09 20:03:11 +03:00
										 |  |  |  |   syn cluster javaCommentSpecial add=javaCommentString,javaCommentCharacter,javaNumber,javaStrTempl | 
					
						
							|  |  |  |  |   syn cluster javaCommentSpecial2 add=javaComment2String,javaCommentCharacter,javaNumber,javaStrTempl | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | endif | 
					
						
							| 
									
										
										
										
											2024-03-03 17:51:01 +03:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
											  
											
												runtime(java): Recognise the inline kind of the {@return} tag (#14284)
Also:
- Refine comment matching (javaComment{Error\ and,Start}).
- Continue rewriting regexps (prefer atom grouping with
  non-capturing parens; factor out common prefixes in
  alternations).
- Allow for relative paths with the _file_ attribute of
  {@snippet}.
- Anticipate HTML in the @see tags.
- Match the nullary method parens in javaDocSeeTagParam.
- Improve the boundary patterns for summary sentences of
  documentation.
> This sentence ends at ... or at the first tag (as defined
> below).
There are Java documentation tags (@) and there are HTML
tags (<?>) (with Markdown looming large; see JEP 467).  With
block tags, e.g. @param, @return, @see, we begin another
documentation "sentence" whether or not the author has
terminated the summary sentence with a period; with
.<!-- -->, we may follow abbreviations, enumerations,
initials, (but instead consider @literal or  ) _within_
the summary sentence.  On the other hand, inline tags, e.g.
@code, @link, @literal, should not terminate the summary
sentence.
References:
https://bugs.openjdk.org/browse/JDK-8075778
https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html#firstsentence
https://docs.oracle.com/en/java/javase/21/docs/specs/javadoc/doc-comment-spec.html
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-03-25 18:18:28 +03:00
										 |  |  |  | syn region  javaComment		matchgroup=javaCommentStart start="/\*" end="\*/" contains=@javaCommentSpecial,javaTodo,javaCommentError,javaSpaceError,@Spell | 
					
						
							| 
									
										
										
										
											2010-05-14 23:24:24 +02:00
										 |  |  |  | syn match   javaCommentStar	 contained "^\s*\*[^/]"me=e-1 | 
					
						
							|  |  |  |  | syn match   javaCommentStar	 contained "^\s*\*$" | 
					
						
							| 
									
										
										
										
											2024-03-22 21:32:48 +03:00
										 |  |  |  | syn match   javaLineComment	"//.*" contains=@javaCommentSpecial2,javaTodo,javaCommentMarkupTag,javaSpaceError,@Spell | 
					
						
							| 
									
										
											  
											
												runtime(java): Recognise the inline kind of the {@return} tag (#14284)
Also:
- Refine comment matching (javaComment{Error\ and,Start}).
- Continue rewriting regexps (prefer atom grouping with
  non-capturing parens; factor out common prefixes in
  alternations).
- Allow for relative paths with the _file_ attribute of
  {@snippet}.
- Anticipate HTML in the @see tags.
- Match the nullary method parens in javaDocSeeTagParam.
- Improve the boundary patterns for summary sentences of
  documentation.
> This sentence ends at ... or at the first tag (as defined
> below).
There are Java documentation tags (@) and there are HTML
tags (<?>) (with Markdown looming large; see JEP 467).  With
block tags, e.g. @param, @return, @see, we begin another
documentation "sentence" whether or not the author has
terminated the summary sentence with a period; with
.<!-- -->, we may follow abbreviations, enumerations,
initials, (but instead consider @literal or  ) _within_
the summary sentence.  On the other hand, inline tags, e.g.
@code, @link, @literal, should not terminate the summary
sentence.
References:
https://bugs.openjdk.org/browse/JDK-8075778
https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html#firstsentence
https://docs.oracle.com/en/java/javase/21/docs/specs/javadoc/doc-comment-spec.html
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-03-25 18:18:28 +03:00
										 |  |  |  | syn match   javaCommentMarkupTag contained "@\%(end\|highlight\|link\|replace\|start\)\>" nextgroup=javaCommentMarkupTagAttr,javaSpaceError skipwhite | 
					
						
							|  |  |  |  | syn match   javaCommentMarkupTagAttr contained "\<region\>" nextgroup=javaCommentMarkupTagAttr,javaSpaceError skipwhite | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  | exec 'syn region javaCommentMarkupTagAttr contained transparent matchgroup=htmlArg start=/\<\%(re\%(gex\|gion\|placement\)\|substring\|t\%(arget\|ype\)\)\%(\s*=\)\@=/ matchgroup=htmlString end=/\%(=\s*\)\@' . s:ff.Peek('80', '') . '<=\%("[^"]\+"\|' . "\x27[^\x27]\\+\x27" . '\|\%([.-]\|\k\)\+\)/ nextgroup=javaCommentMarkupTagAttr,javaSpaceError skipwhite oneline' | 
					
						
							| 
									
										
										
										
											2024-03-22 21:32:48 +03:00
										 |  |  |  | hi def link javaCommentMarkupTagAttr htmlArg | 
					
						
							| 
									
										
										
										
											2016-08-31 22:22:10 +02:00
										 |  |  |  | hi def link javaCommentString javaString | 
					
						
							|  |  |  |  | hi def link javaComment2String javaString | 
					
						
							|  |  |  |  | hi def link javaCommentCharacter javaCharacter | 
					
						
							| 
									
										
											  
											
												runtime(java): Recognise the inline kind of the {@return} tag (#14284)
Also:
- Refine comment matching (javaComment{Error\ and,Start}).
- Continue rewriting regexps (prefer atom grouping with
  non-capturing parens; factor out common prefixes in
  alternations).
- Allow for relative paths with the _file_ attribute of
  {@snippet}.
- Anticipate HTML in the @see tags.
- Match the nullary method parens in javaDocSeeTagParam.
- Improve the boundary patterns for summary sentences of
  documentation.
> This sentence ends at ... or at the first tag (as defined
> below).
There are Java documentation tags (@) and there are HTML
tags (<?>) (with Markdown looming large; see JEP 467).  With
block tags, e.g. @param, @return, @see, we begin another
documentation "sentence" whether or not the author has
terminated the summary sentence with a period; with
.<!-- -->, we may follow abbreviations, enumerations,
initials, (but instead consider @literal or  ) _within_
the summary sentence.  On the other hand, inline tags, e.g.
@code, @link, @literal, should not terminate the summary
sentence.
References:
https://bugs.openjdk.org/browse/JDK-8075778
https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html#firstsentence
https://docs.oracle.com/en/java/javase/21/docs/specs/javadoc/doc-comment-spec.html
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-03-25 18:18:28 +03:00
										 |  |  |  | syn match   javaCommentError contained "/\*"me=e-1 display | 
					
						
							|  |  |  |  | hi def link javaCommentError javaError | 
					
						
							|  |  |  |  | hi def link javaCommentStart javaComment | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | 
 | 
					
						
							|  |  |  |  | if !exists("java_ignore_javadoc") && main_syntax != 'jsp' | 
					
						
							|  |  |  |  |   syntax case ignore | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  | 
 | 
					
						
							|  |  |  |  |   " Include HTML syntax coloring for Javadoc comments. | 
					
						
							| 
									
										
										
										
											2022-06-09 20:45:54 +01:00
										 |  |  |  |   syntax include @javaHtml syntax/html.vim | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  |   unlet b:current_syntax | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  | 
 | 
					
						
							|  |  |  |  |   " HTML enables spell checking for all text that is not in a syntax | 
					
						
							|  |  |  |  |   " item (:syntax spell toplevel); instead, limit spell checking to | 
					
						
							|  |  |  |  |   " items matchable with syntax groups containing the @Spell cluster. | 
					
						
							|  |  |  |  |   try | 
					
						
							|  |  |  |  |     syntax spell default | 
					
						
							|  |  |  |  |   catch /\<E390:/ | 
					
						
							|  |  |  |  |     call s:ReportOnce(v:exception) | 
					
						
							|  |  |  |  |   endtry | 
					
						
							| 
									
										
										
										
											2010-01-06 20:54:52 +01:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
											  
											
												runtime(java): Recognise the inline kind of the {@return} tag (#14284)
Also:
- Refine comment matching (javaComment{Error\ and,Start}).
- Continue rewriting regexps (prefer atom grouping with
  non-capturing parens; factor out common prefixes in
  alternations).
- Allow for relative paths with the _file_ attribute of
  {@snippet}.
- Anticipate HTML in the @see tags.
- Match the nullary method parens in javaDocSeeTagParam.
- Improve the boundary patterns for summary sentences of
  documentation.
> This sentence ends at ... or at the first tag (as defined
> below).
There are Java documentation tags (@) and there are HTML
tags (<?>) (with Markdown looming large; see JEP 467).  With
block tags, e.g. @param, @return, @see, we begin another
documentation "sentence" whether or not the author has
terminated the summary sentence with a period; with
.<!-- -->, we may follow abbreviations, enumerations,
initials, (but instead consider @literal or  ) _within_
the summary sentence.  On the other hand, inline tags, e.g.
@code, @link, @literal, should not terminate the summary
sentence.
References:
https://bugs.openjdk.org/browse/JDK-8075778
https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html#firstsentence
https://docs.oracle.com/en/java/javase/21/docs/specs/javadoc/doc-comment-spec.html
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-03-25 18:18:28 +03:00
										 |  |  |  |   syn region javaDocComment	start="/\*\*" end="\*/" keepend contains=javaCommentTitle,@javaHtml,javaDocTags,javaDocSeeTag,javaDocCodeTag,javaDocSnippetTag,javaTodo,javaCommentError,javaSpaceError,@Spell | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  |   exec 'syn region javaCommentTitle contained matchgroup=javaDocComment start="/\*\*" matchgroup=javaCommentTitle end="\.$" end="\.[ \t\r]\@=" end="\%(^\s*\**\s*\)\@' . s:ff.Peek('80', '') . '<=@"me=s-2,he=s-1 end="\*/"me=s-1,he=s-1 contains=@javaHtml,javaCommentStar,javaTodo,javaCommentError,javaSpaceError,@Spell,javaDocTags,javaDocSeeTag,javaDocCodeTag,javaDocSnippetTag' | 
					
						
							| 
									
										
											  
											
												runtime(java): Recognise the inline kind of the {@return} tag (#14284)
Also:
- Refine comment matching (javaComment{Error\ and,Start}).
- Continue rewriting regexps (prefer atom grouping with
  non-capturing parens; factor out common prefixes in
  alternations).
- Allow for relative paths with the _file_ attribute of
  {@snippet}.
- Anticipate HTML in the @see tags.
- Match the nullary method parens in javaDocSeeTagParam.
- Improve the boundary patterns for summary sentences of
  documentation.
> This sentence ends at ... or at the first tag (as defined
> below).
There are Java documentation tags (@) and there are HTML
tags (<?>) (with Markdown looming large; see JEP 467).  With
block tags, e.g. @param, @return, @see, we begin another
documentation "sentence" whether or not the author has
terminated the summary sentence with a period; with
.<!-- -->, we may follow abbreviations, enumerations,
initials, (but instead consider @literal or  ) _within_
the summary sentence.  On the other hand, inline tags, e.g.
@code, @link, @literal, should not terminate the summary
sentence.
References:
https://bugs.openjdk.org/browse/JDK-8075778
https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html#firstsentence
https://docs.oracle.com/en/java/javase/21/docs/specs/javadoc/doc-comment-spec.html
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-03-25 18:18:28 +03:00
										 |  |  |  |   syn region javaCommentTitle	contained matchgroup=javaDocComment start="/\*\*\s*\r\=\n\=\s*\**\s*\%({@return\>\)\@=" matchgroup=javaCommentTitle end="}\%(\s*\.*\)*" contains=@javaHtml,javaCommentStar,javaTodo,javaCommentError,javaSpaceError,@Spell,javaDocTags,javaDocSeeTag,javaDocCodeTag,javaDocSnippetTag | 
					
						
							| 
									
										
										
										
											2024-03-22 21:32:48 +03:00
										 |  |  |  |   syn region javaDocTags	contained start="{@\%(li\%(teral\|nk\%(plain\)\=\)\|inherit[Dd]oc\|doc[rR]oot\|value\)\>" end="}" | 
					
						
							| 
									
										
											  
											
												runtime(java): Recognise the inline kind of the {@return} tag (#14284)
Also:
- Refine comment matching (javaComment{Error\ and,Start}).
- Continue rewriting regexps (prefer atom grouping with
  non-capturing parens; factor out common prefixes in
  alternations).
- Allow for relative paths with the _file_ attribute of
  {@snippet}.
- Anticipate HTML in the @see tags.
- Match the nullary method parens in javaDocSeeTagParam.
- Improve the boundary patterns for summary sentences of
  documentation.
> This sentence ends at ... or at the first tag (as defined
> below).
There are Java documentation tags (@) and there are HTML
tags (<?>) (with Markdown looming large; see JEP 467).  With
block tags, e.g. @param, @return, @see, we begin another
documentation "sentence" whether or not the author has
terminated the summary sentence with a period; with
.<!-- -->, we may follow abbreviations, enumerations,
initials, (but instead consider @literal or  ) _within_
the summary sentence.  On the other hand, inline tags, e.g.
@code, @link, @literal, should not terminate the summary
sentence.
References:
https://bugs.openjdk.org/browse/JDK-8075778
https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html#firstsentence
https://docs.oracle.com/en/java/javase/21/docs/specs/javadoc/doc-comment-spec.html
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-03-25 18:18:28 +03:00
										 |  |  |  |   syn match  javaDocTags	contained "@\%(param\|exception\|throws\|since\)\s\+\S\+" contains=javaDocParam | 
					
						
							|  |  |  |  |   syn match  javaDocParam	contained "\s\S\+" | 
					
						
							|  |  |  |  |   syn match  javaDocTags	contained "@\%(version\|author\|return\|deprecated\|serial\%(Field\|Data\)\=\)\>" | 
					
						
							|  |  |  |  |   syn region javaDocSeeTag	contained matchgroup=javaDocTags start="@see\s\+" matchgroup=NONE end="\_."re=e-1 contains=javaDocSeeTagParam | 
					
						
							|  |  |  |  |   syn match  javaDocSeeTagParam	contained @"\_[^"]\+"\|<a\s\+\_.\{-}</a>\|\%(\k\|\.\)*\%(#\k\+\%((\_[^)]*)\)\=\)\=@ contains=@javaHtml extend | 
					
						
							| 
									
										
										
										
											2024-03-22 21:32:48 +03:00
										 |  |  |  |   syn region javaCodeSkipBlock	contained transparent start="{\%(@code\>\)\@!" end="}" contains=javaCodeSkipBlock,javaDocCodeTag | 
					
						
							|  |  |  |  |   syn region javaDocCodeTag	contained start="{@code\>" end="}" contains=javaDocCodeTag,javaCodeSkipBlock | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  |   exec 'syn region javaDocSnippetTagAttr contained transparent matchgroup=htmlArg start=/\<\%(class\|file\|id\|lang\|region\)\%(\s*=\)\@=/ matchgroup=htmlString end=/:$/ end=/\%(=\s*\)\@' . s:ff.Peek('80', '') . '<=\%("[^"]\+"\|' . "\x27[^\x27]\\+\x27" . '\|\%([.\\/-]\|\k\)\+\)/ nextgroup=javaDocSnippetTagAttr skipwhite skipnl' | 
					
						
							| 
									
										
										
										
											2024-03-22 21:32:48 +03:00
										 |  |  |  |   syn region javaSnippetSkipBlock contained transparent start="{\%(@snippet\>\)\@!" end="}" contains=javaSnippetSkipBlock,javaDocSnippetTag,javaCommentMarkupTag | 
					
						
							|  |  |  |  |   syn region javaDocSnippetTag	contained start="{@snippet\>" end="}" contains=javaDocSnippetTag,javaSnippetSkipBlock,javaDocSnippetTagAttr,javaCommentMarkupTag | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  |   syntax case match | 
					
						
							|  |  |  |  | endif | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | " match the special comment /**/ | 
					
						
							|  |  |  |  | syn match   javaComment		 "/\*\*/" | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | " Strings and constants | 
					
						
							| 
									
										
										
										
											2010-05-14 23:24:24 +02:00
										 |  |  |  | syn match   javaSpecialError	 contained "\\." | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | syn match   javaSpecialCharError contained "[^']" | 
					
						
							| 
									
										
										
										
											2024-03-02 01:11:14 +03:00
										 |  |  |  | " Escape Sequences (JLS-17, §3.10.7): | 
					
						
							| 
									
										
										
										
											2024-03-03 17:51:01 +03:00
										 |  |  |  | syn match   javaSpecialChar	 contained "\\\%(u\x\x\x\x\|[0-3]\o\o\|\o\o\=\|[bstnfr"'\\]\)" | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | syn region  javaString		start=+"+ end=+"+ end=+$+ contains=javaSpecialChar,javaSpecialError,@Spell | 
					
						
							| 
									
										
										
										
											2024-03-03 17:51:01 +03:00
										 |  |  |  | syn region  javaString		start=+"""[ \t\x0c\r]*$+hs=e+1 end=+"""+he=s-1 contains=javaSpecialChar,javaSpecialError,javaTextBlockError,@Spell | 
					
						
							|  |  |  |  | syn match   javaTextBlockError	+"""\s*"""+ | 
					
						
							| 
									
										
											  
											
												runtime(java): Recognise string templates (#14150)
As this is encouraged in the referenced JEPs, "to visually
distinguish a string template from a string literal, and
a text block template from a text block", the default
colours for java\%[Debug]StrTempl are made distinct from
java\%[Debug]String.
According to §3.2 Lexical Translations (JLS, c. 1996 or any
more recent version), line terminators, white space, and
comments are discarded before tokens are accepted. Since
a template expression comprises a template processor, a dot,
and a template, it may be visually appealing to break up
its head across a few lines whenever its tail already spans
multiple lines.  Curiously, no allowance for it is made in
the distributed tests for OpenJDK 21; the proposed regexp
patterns take in consideration a line terminator and white
space after a dot.
References:
https://openjdk.org/jeps/430 (Preview)
https://openjdk.org/jeps/459 (Second Preview)
https://openjdk.org/jeps/465
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-03-09 20:03:11 +03:00
										 |  |  |  | syn region  javaStrTemplEmbExp	 contained matchgroup=javaStrTempl start="\\{" end="}" contains=TOP | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  | exec 'syn region javaStrTempl start=+\%(\.[[:space:]\n]*\)\@' . s:ff.Peek('80', '') . '<="+ end=+"+ contains=javaStrTemplEmbExp,javaSpecialChar,javaSpecialError,@Spell' | 
					
						
							|  |  |  |  | exec 'syn region javaStrTempl start=+\%(\.[[:space:]\n]*\)\@' . s:ff.Peek('80', '') . '<="""[ \t\x0c\r]*$+hs=e+1 end=+"""+he=s-1 contains=javaStrTemplEmbExp,javaSpecialChar,javaSpecialError,javaTextBlockError,@Spell' | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | syn match   javaCharacter	 "'[^']*'" contains=javaSpecialChar,javaSpecialCharError | 
					
						
							|  |  |  |  | syn match   javaCharacter	 "'\\''" contains=javaSpecialChar | 
					
						
							|  |  |  |  | syn match   javaCharacter	 "'[^\\]'" | 
					
						
							| 
									
										
										
										
											2024-03-02 01:11:14 +03:00
										 |  |  |  | " Integer literals (JLS-17, §3.10.1): | 
					
						
							|  |  |  |  | syn keyword javaNumber		 0 0l 0L | 
					
						
							|  |  |  |  | syn match   javaNumber		 "\<\%(0\%([xX]\x\%(_*\x\)*\|_*\o\%(_*\o\)*\|[bB][01]\%(_*[01]\)*\)\|[1-9]\%(_*\d\)*\)[lL]\=\>" | 
					
						
							|  |  |  |  | " Decimal floating-point literals (JLS-17, §3.10.2): | 
					
						
							|  |  |  |  | " Against "\<\d\+\>\.": | 
					
						
							|  |  |  |  | syn match   javaNumber		 "\<\d\%(_*\d\)*\." | 
					
						
							|  |  |  |  | syn match   javaNumber		 "\%(\<\d\%(_*\d\)*\.\%(\d\%(_*\d\)*\)\=\|\.\d\%(_*\d\)*\)\%([eE][-+]\=\d\%(_*\d\)*\)\=[fFdD]\=\>" | 
					
						
							|  |  |  |  | syn match   javaNumber		 "\<\d\%(_*\d\)*[eE][-+]\=\d\%(_*\d\)*[fFdD]\=\>" | 
					
						
							|  |  |  |  | syn match   javaNumber		 "\<\d\%(_*\d\)*\%([eE][-+]\=\d\%(_*\d\)*\)\=[fFdD]\>" | 
					
						
							|  |  |  |  | " Hexadecimal floating-point literals (JLS-17, §3.10.2): | 
					
						
							|  |  |  |  | syn match   javaNumber		 "\<0[xX]\%(\x\%(_*\x\)*\.\=\|\%(\x\%(_*\x\)*\)\=\.\x\%(_*\x\)*\)[pP][-+]\=\d\%(_*\d\)*[fFdD]\=\>" | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-03-02 01:11:14 +03:00
										 |  |  |  | " Unicode characters | 
					
						
							|  |  |  |  | syn match   javaSpecial "\\u\x\x\x\x" | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
											  
											
												runtime(java): Improve the recognition of the "style" method declarations
- Request the new regexp engine (v7.3.970) for [:upper:] and
  [:lower:].
- Recognise declarations of in-line annotated methods.
- Recognise declarations of _strictfp_ methods.
- Establish partial order for method modifiers as shown in
  the MethodModifier production; namely, _public_ and
  friends should be written the leftmost, possibly followed
  by _abstract_ or _default_, or possibly followed by other
  modifiers.
- Stop looking for parameterisable primitive types (void<?>,
  int<Object>, etc., are malformed).
- Stop looking for arrays of _void_.
- Acknowledge the prevailing convention for method names to
  begin with a small letter and for class/interface names to
  begin with a capital letter; and, therefore, desist from
  claiming declarations of enum constants and constructors
  with javaFuncDef.
  Rationale:
    + Constructor is distinct from method:
      * its (overloaded) name is not arbitrary;
      * its return type is implicit;
      * its _throws_ clause depends on indirect vagaries of
        instance (variable) initialisers;
      * its invocation makes other constructors of its type
        hierarchy invoked one by one, concluding with the
        primordial constructor;
      * its explicit invocation, via _this_ or _super_, can
        only appear as the first statement in a constructor
        (not anymore, see JEP 447); else, its _super_ call
        cannot appear in constructors of _record_ or _enum_;
        and neither invocation is allowed for the primordial
        constructor;
      * it is not a member of its class, like initialisers,
        and is never inherited;
      * it is never _abstract_ or _native_.
    + Constructor declarations tend to be few in number and
      merit visual recognition from method declarations.
    + Enum constants define a fixed set of type instances
      and more resemble class variable initialisers.
Note that the code duplicated for @javaFuncParams is written
keeping in mind for g:java_highlight_functions a pending 3rd
variant, which would require none of the :syn-cluster added
groups.
closes: #14620
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-04-24 21:04:25 +02:00
										 |  |  |  | " Method declarations (JLS-17, §8.4.3, §8.4.4, §9.4). | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | if exists("java_highlight_functions") | 
					
						
							| 
									
										
											  
											
												runtime(java): Improve the recognition of the "style" method declarations
- Request the new regexp engine (v7.3.970) for [:upper:] and
  [:lower:].
- Recognise declarations of in-line annotated methods.
- Recognise declarations of _strictfp_ methods.
- Establish partial order for method modifiers as shown in
  the MethodModifier production; namely, _public_ and
  friends should be written the leftmost, possibly followed
  by _abstract_ or _default_, or possibly followed by other
  modifiers.
- Stop looking for parameterisable primitive types (void<?>,
  int<Object>, etc., are malformed).
- Stop looking for arrays of _void_.
- Acknowledge the prevailing convention for method names to
  begin with a small letter and for class/interface names to
  begin with a capital letter; and, therefore, desist from
  claiming declarations of enum constants and constructors
  with javaFuncDef.
  Rationale:
    + Constructor is distinct from method:
      * its (overloaded) name is not arbitrary;
      * its return type is implicit;
      * its _throws_ clause depends on indirect vagaries of
        instance (variable) initialisers;
      * its invocation makes other constructors of its type
        hierarchy invoked one by one, concluding with the
        primordial constructor;
      * its explicit invocation, via _this_ or _super_, can
        only appear as the first statement in a constructor
        (not anymore, see JEP 447); else, its _super_ call
        cannot appear in constructors of _record_ or _enum_;
        and neither invocation is allowed for the primordial
        constructor;
      * it is not a member of its class, like initialisers,
        and is never inherited;
      * it is never _abstract_ or _native_.
    + Constructor declarations tend to be few in number and
      merit visual recognition from method declarations.
    + Enum constants define a fixed set of type instances
      and more resemble class variable initialisers.
Note that the code duplicated for @javaFuncParams is written
keeping in mind for g:java_highlight_functions a pending 3rd
variant, which would require none of the :syn-cluster added
groups.
closes: #14620
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-04-24 21:04:25 +02:00
										 |  |  |  |   syn cluster javaFuncParams contains=javaAnnotation,@javaClasses,javaType,javaVarArg,javaComment,javaLineComment | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-04-29 21:24:35 +03:00
										 |  |  |  |   if java_highlight_functions =~# '^indent[1-8]\=$' | 
					
						
							|  |  |  |  |     let s:last = java_highlight_functions[-1 :] | 
					
						
							|  |  |  |  |     let s:indent = s:last != 't' ? repeat("\x20", s:last) : "\t" | 
					
						
							| 
									
										
											  
											
												runtime(java): Improve the recognition of the "style" method declarations
- Request the new regexp engine (v7.3.970) for [:upper:] and
  [:lower:].
- Recognise declarations of in-line annotated methods.
- Recognise declarations of _strictfp_ methods.
- Establish partial order for method modifiers as shown in
  the MethodModifier production; namely, _public_ and
  friends should be written the leftmost, possibly followed
  by _abstract_ or _default_, or possibly followed by other
  modifiers.
- Stop looking for parameterisable primitive types (void<?>,
  int<Object>, etc., are malformed).
- Stop looking for arrays of _void_.
- Acknowledge the prevailing convention for method names to
  begin with a small letter and for class/interface names to
  begin with a capital letter; and, therefore, desist from
  claiming declarations of enum constants and constructors
  with javaFuncDef.
  Rationale:
    + Constructor is distinct from method:
      * its (overloaded) name is not arbitrary;
      * its return type is implicit;
      * its _throws_ clause depends on indirect vagaries of
        instance (variable) initialisers;
      * its invocation makes other constructors of its type
        hierarchy invoked one by one, concluding with the
        primordial constructor;
      * its explicit invocation, via _this_ or _super_, can
        only appear as the first statement in a constructor
        (not anymore, see JEP 447); else, its _super_ call
        cannot appear in constructors of _record_ or _enum_;
        and neither invocation is allowed for the primordial
        constructor;
      * it is not a member of its class, like initialisers,
        and is never inherited;
      * it is never _abstract_ or _native_.
    + Constructor declarations tend to be few in number and
      merit visual recognition from method declarations.
    + Enum constants define a fixed set of type instances
      and more resemble class variable initialisers.
Note that the code duplicated for @javaFuncParams is written
keeping in mind for g:java_highlight_functions a pending 3rd
variant, which would require none of the :syn-cluster added
groups.
closes: #14620
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-04-24 21:04:25 +02:00
										 |  |  |  |     syn cluster javaFuncParams add=javaScopeDecl,javaConceptKind,javaStorageClass,javaExternal | 
					
						
							| 
									
										
										
										
											2024-04-29 21:24:35 +03:00
										 |  |  |  |     " Try to not match other type members, initialiser blocks, enum | 
					
						
							|  |  |  |  |     " constants (JLS-17, §8.9.1), and constructors (JLS-17, §8.1.7): | 
					
						
							|  |  |  |  |     " at any _conventional_ indentation, skip over all fields with | 
					
						
							|  |  |  |  |     " "[^=]*", all records with "\<record\s", and let the "*Skip*" | 
					
						
							|  |  |  |  |     " definitions take care of constructor declarations and enum | 
					
						
							|  |  |  |  |     " constants (with no support for @Foo(value = "bar")). | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  |     exec 'syn region javaFuncDef start=+^' . s:indent . '\%(<[^>]\+>\+\s\+\|\%(\%(@\%(\K\k*\.\)*\K\k*\>\)\s\+\)\+\)\=\%(\<\K\k*\>\.\)*\K\k*\>[^=]*\%(\<record\)\@' . s:ff.Peek('6', '') . '<!\s\K\k*\s*(+ end=+)+ contains=@javaFuncParams' | 
					
						
							| 
									
										
										
										
											2024-04-29 21:24:35 +03:00
										 |  |  |  |     " As long as package-private constructors cannot be matched with | 
					
						
							|  |  |  |  |     " javaFuncDef, do not look with javaConstructorSkipDeclarator for | 
					
						
							|  |  |  |  |     " them. | 
					
						
							|  |  |  |  |     exec 'syn match javaConstructorSkipDeclarator transparent +^' . s:indent . '\%(\%(@\%(\K\k*\.\)*\K\k*\>\)\s\+\)*p\%(ublic\|rotected\|rivate\)\s\+\%(<[^>]\+>\+\s\+\)\=\K\k*\s*\ze(+ contains=javaAnnotation,javaScopeDecl' | 
					
						
							|  |  |  |  |     exec 'syn match javaEnumSkipArgumentativeConstant transparent +^' . s:indent . '\%(\%(@\%(\K\k*\.\)*\K\k*\>\)\s\+\)*\K\k*\s*\ze(+ contains=javaAnnotation' | 
					
						
							|  |  |  |  |     unlet s:indent s:last | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  |   else | 
					
						
							| 
									
										
										
										
											2024-04-14 19:57:00 +03:00
										 |  |  |  |     " This is the "style" variant (:help ft-java-syntax). | 
					
						
							| 
									
										
											  
											
												runtime(java): Improve the recognition of the "style" method declarations
- Request the new regexp engine (v7.3.970) for [:upper:] and
  [:lower:].
- Recognise declarations of in-line annotated methods.
- Recognise declarations of _strictfp_ methods.
- Establish partial order for method modifiers as shown in
  the MethodModifier production; namely, _public_ and
  friends should be written the leftmost, possibly followed
  by _abstract_ or _default_, or possibly followed by other
  modifiers.
- Stop looking for parameterisable primitive types (void<?>,
  int<Object>, etc., are malformed).
- Stop looking for arrays of _void_.
- Acknowledge the prevailing convention for method names to
  begin with a small letter and for class/interface names to
  begin with a capital letter; and, therefore, desist from
  claiming declarations of enum constants and constructors
  with javaFuncDef.
  Rationale:
    + Constructor is distinct from method:
      * its (overloaded) name is not arbitrary;
      * its return type is implicit;
      * its _throws_ clause depends on indirect vagaries of
        instance (variable) initialisers;
      * its invocation makes other constructors of its type
        hierarchy invoked one by one, concluding with the
        primordial constructor;
      * its explicit invocation, via _this_ or _super_, can
        only appear as the first statement in a constructor
        (not anymore, see JEP 447); else, its _super_ call
        cannot appear in constructors of _record_ or _enum_;
        and neither invocation is allowed for the primordial
        constructor;
      * it is not a member of its class, like initialisers,
        and is never inherited;
      * it is never _abstract_ or _native_.
    + Constructor declarations tend to be few in number and
      merit visual recognition from method declarations.
    + Enum constants define a fixed set of type instances
      and more resemble class variable initialisers.
Note that the code duplicated for @javaFuncParams is written
keeping in mind for g:java_highlight_functions a pending 3rd
variant, which would require none of the :syn-cluster added
groups.
closes: #14620
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-04-24 21:04:25 +02:00
										 |  |  |  |     syn cluster javaFuncParams add=javaScopeDecl,javaConceptKind,javaStorageClass,javaExternal | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  |     " Match arbitrarily indented camelCasedName method declarations. | 
					
						
							|  |  |  |  |     " Match: [@ɐ] [abstract] [<α, β>] Τʬ[<γ>][[][]] μʭʭ(/* ... */); | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  |     exec 'syn region javaFuncDef start=/' . s:ff.Engine('\%#=2', '') . '^\s\+\%(\%(@\%(\K\k*\.\)*\K\k*\>\)\s\+\)*\%(p\%(ublic\|rotected\|rivate\)\s\+\)\=\%(\%(abstract\|default\)\s\+\|\%(\%(final\|\%(native\|strictfp\)\|s\%(tatic\|ynchronized\)\)\s\+\)*\)\=\%(<.*[[:space:]-]\@' . s:ff.Peek('1', '') . '<!>\s\+\)\=\%(void\|\%(b\%(oolean\|yte\)\|char\|short\|int\|long\|float\|double\|\%(\<\K\k*\>\.\)*\<' . s:ff.UpperCase('[$_[:upper:]]', '[^a-z0-9]') . '\k*\>\%(<[^(){}]*[[:space:]-]\@' . s:ff.Peek('1', '') . '<!>\)\=\)\%(\[\]\)*\)\s\+\<' . s:ff.LowerCase('[$_[:lower:]]', '[^A-Z0-9]') . '\k*\>\s*(/ end=/)/ skip=/\/\*.\{-}\*\/\|\/\/.*$/ contains=@javaFuncParams' | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  |   endif | 
					
						
							| 
									
										
										
										
											2024-04-14 19:57:00 +03:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  |   syn match javaBraces "[{}]" | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | endif | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | if exists("java_highlight_debug") | 
					
						
							|  |  |  |  |   " Strings and constants | 
					
						
							| 
									
										
										
										
											2024-03-03 17:51:01 +03:00
										 |  |  |  |   syn match   javaDebugSpecial		contained "\\\%(u\x\x\x\x\|[0-3]\o\o\|\o\o\=\|[bstnfr"'\\]\)" | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  |   syn region  javaDebugString		contained start=+"+  end=+"+  contains=javaDebugSpecial | 
					
						
							| 
									
										
										
										
											2024-03-03 17:51:01 +03:00
										 |  |  |  |   syn region  javaDebugString		contained start=+"""[ \t\x0c\r]*$+hs=e+1 end=+"""+he=s-1 contains=javaDebugSpecial,javaDebugTextBlockError | 
					
						
							| 
									
										
											  
											
												runtime(java): Recognise string templates (#14150)
As this is encouraged in the referenced JEPs, "to visually
distinguish a string template from a string literal, and
a text block template from a text block", the default
colours for java\%[Debug]StrTempl are made distinct from
java\%[Debug]String.
According to §3.2 Lexical Translations (JLS, c. 1996 or any
more recent version), line terminators, white space, and
comments are discarded before tokens are accepted. Since
a template expression comprises a template processor, a dot,
and a template, it may be visually appealing to break up
its head across a few lines whenever its tail already spans
multiple lines.  Curiously, no allowance for it is made in
the distributed tests for OpenJDK 21; the proposed regexp
patterns take in consideration a line terminator and white
space after a dot.
References:
https://openjdk.org/jeps/430 (Preview)
https://openjdk.org/jeps/459 (Second Preview)
https://openjdk.org/jeps/465
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-03-09 20:03:11 +03:00
										 |  |  |  |   " The highlight groups of java{StrTempl,Debug{,Paren,StrTempl}}\, | 
					
						
							|  |  |  |  |   " share one colour by default. Do not conflate unrelated parens. | 
					
						
							|  |  |  |  |   syn region  javaDebugStrTemplEmbExp	contained matchgroup=javaDebugStrTempl start="\\{" end="}" contains=javaComment,javaLineComment,javaDebug\%(Paren\)\@!.* | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  |   exec 'syn region javaDebugStrTempl contained start=+\%(\.[[:space:]\n]*\)\@' . s:ff.Peek('80', '') . '<="+ end=+"+ contains=javaDebugStrTemplEmbExp,javaDebugSpecial' | 
					
						
							|  |  |  |  |   exec 'syn region javaDebugStrTempl contained start=+\%(\.[[:space:]\n]*\)\@' . s:ff.Peek('80', '') . '<="""[ \t\x0c\r]*$+hs=e+1 end=+"""+he=s-1 contains=javaDebugStrTemplEmbExp,javaDebugSpecial,javaDebugTextBlockError' | 
					
						
							| 
									
										
										
										
											2024-03-03 17:51:01 +03:00
										 |  |  |  |   syn match   javaDebugTextBlockError	contained +"""\s*"""+ | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  |   syn match   javaDebugCharacter	contained "'[^\\]'" | 
					
						
							|  |  |  |  |   syn match   javaDebugSpecialCharacter contained "'\\.'" | 
					
						
							|  |  |  |  |   syn match   javaDebugSpecialCharacter contained "'\\''" | 
					
						
							| 
									
										
										
										
											2024-03-02 01:11:14 +03:00
										 |  |  |  |   syn keyword javaDebugNumber		contained 0 0l 0L | 
					
						
							| 
									
										
										
										
											2024-03-03 17:51:01 +03:00
										 |  |  |  |   syn match   javaDebugNumber		contained "\<\d\%(_*\d\)*\." | 
					
						
							| 
									
										
										
										
											2024-03-02 01:11:14 +03:00
										 |  |  |  |   syn match   javaDebugNumber		contained "\<\%(0\%([xX]\x\%(_*\x\)*\|_*\o\%(_*\o\)*\|[bB][01]\%(_*[01]\)*\)\|[1-9]\%(_*\d\)*\)[lL]\=\>" | 
					
						
							|  |  |  |  |   syn match   javaDebugNumber		contained "\%(\<\d\%(_*\d\)*\.\%(\d\%(_*\d\)*\)\=\|\.\d\%(_*\d\)*\)\%([eE][-+]\=\d\%(_*\d\)*\)\=[fFdD]\=\>" | 
					
						
							|  |  |  |  |   syn match   javaDebugNumber		contained "\<\d\%(_*\d\)*[eE][-+]\=\d\%(_*\d\)*[fFdD]\=\>" | 
					
						
							|  |  |  |  |   syn match   javaDebugNumber		contained "\<\d\%(_*\d\)*\%([eE][-+]\=\d\%(_*\d\)*\)\=[fFdD]\>" | 
					
						
							|  |  |  |  |   syn match   javaDebugNumber		contained "\<0[xX]\%(\x\%(_*\x\)*\.\=\|\%(\x\%(_*\x\)*\)\=\.\x\%(_*\x\)*\)[pP][-+]\=\d\%(_*\d\)*[fFdD]\=\>" | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  |   syn keyword javaDebugBoolean		contained true false | 
					
						
							|  |  |  |  |   syn keyword javaDebugType		contained null this super | 
					
						
							|  |  |  |  |   syn region javaDebugParen  start=+(+ end=+)+ contained contains=javaDebug.*,javaDebugParen | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-04-14 19:57:00 +03:00
										 |  |  |  |   " To make this work, define the highlighting for these groups. | 
					
						
							|  |  |  |  |   syn match javaDebug "\<System\.\%(out\|err\)\.print\%(ln\)\=\s*("me=e-1 contains=javaDebug.* nextgroup=javaDebugParen | 
					
						
							|  |  |  |  | " FIXME: What API does "p" belong to? | 
					
						
							|  |  |  |  | " syn match javaDebug "\<p\s*("me=e-1 contains=javaDebug.* nextgroup=javaDebugParen | 
					
						
							|  |  |  |  |   syn match javaDebug "\<\K\k*\.printStackTrace\s*("me=e-1 contains=javaDebug.* nextgroup=javaDebugParen | 
					
						
							|  |  |  |  | " FIXME: What API do "trace*" belong to? | 
					
						
							|  |  |  |  | " syn match javaDebug "\<trace[SL]\=\s*("me=e-1 contains=javaDebug.* nextgroup=javaDebugParen | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-08-31 22:22:10 +02:00
										 |  |  |  |   hi def link javaDebug		 Debug | 
					
						
							|  |  |  |  |   hi def link javaDebugString		 DebugString | 
					
						
							| 
									
										
											  
											
												runtime(java): Recognise string templates (#14150)
As this is encouraged in the referenced JEPs, "to visually
distinguish a string template from a string literal, and
a text block template from a text block", the default
colours for java\%[Debug]StrTempl are made distinct from
java\%[Debug]String.
According to §3.2 Lexical Translations (JLS, c. 1996 or any
more recent version), line terminators, white space, and
comments are discarded before tokens are accepted. Since
a template expression comprises a template processor, a dot,
and a template, it may be visually appealing to break up
its head across a few lines whenever its tail already spans
multiple lines.  Curiously, no allowance for it is made in
the distributed tests for OpenJDK 21; the proposed regexp
patterns take in consideration a line terminator and white
space after a dot.
References:
https://openjdk.org/jeps/430 (Preview)
https://openjdk.org/jeps/459 (Second Preview)
https://openjdk.org/jeps/465
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-03-09 20:03:11 +03:00
										 |  |  |  |   hi def link javaDebugStrTempl		 Macro | 
					
						
							| 
									
										
										
										
											2024-05-10 15:49:06 +03:00
										 |  |  |  |   hi def link javaDebugTextBlockError	 Error | 
					
						
							| 
									
										
										
										
											2016-08-31 22:22:10 +02:00
										 |  |  |  |   hi def link javaDebugType		 DebugType | 
					
						
							|  |  |  |  |   hi def link javaDebugBoolean		 DebugBoolean | 
					
						
							|  |  |  |  |   hi def link javaDebugNumber		 Debug | 
					
						
							|  |  |  |  |   hi def link javaDebugSpecial		 DebugSpecial | 
					
						
							|  |  |  |  |   hi def link javaDebugSpecialCharacter DebugSpecial | 
					
						
							|  |  |  |  |   hi def link javaDebugCharacter	 DebugString | 
					
						
							|  |  |  |  |   hi def link javaDebugParen		 Debug | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  |   hi def link DebugString		 String | 
					
						
							|  |  |  |  |   hi def link DebugSpecial		 Special | 
					
						
							|  |  |  |  |   hi def link DebugBoolean		 Boolean | 
					
						
							|  |  |  |  |   hi def link DebugType		 Type | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | endif | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | if exists("java_mark_braces_in_parens_as_errors") | 
					
						
							|  |  |  |  |   syn match javaInParen		 contained "[{}]" | 
					
						
							| 
									
										
										
										
											2016-08-31 22:22:10 +02:00
										 |  |  |  |   hi def link javaInParen	javaError | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | endif | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | " catch errors caused by wrong parenthesis | 
					
						
							| 
									
										
										
										
											2015-03-02 23:16:07 +01:00
										 |  |  |  | syn region  javaParenT	transparent matchgroup=javaParen  start="(" end=")" contains=@javaTop,javaParenT1 | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | syn region  javaParenT1 transparent matchgroup=javaParen1 start="(" end=")" contains=@javaTop,javaParenT2 contained | 
					
						
							|  |  |  |  | syn region  javaParenT2 transparent matchgroup=javaParen2 start="(" end=")" contains=@javaTop,javaParenT  contained | 
					
						
							| 
									
										
										
										
											2010-05-14 23:24:24 +02:00
										 |  |  |  | syn match   javaParenError	 ")" | 
					
						
							| 
									
										
										
										
											2004-12-09 21:34:53 +00:00
										 |  |  |  | " catch errors caused by wrong square parenthesis | 
					
						
							| 
									
										
										
										
											2015-03-02 23:16:07 +01:00
										 |  |  |  | syn region  javaParenT	transparent matchgroup=javaParen  start="\[" end="\]" contains=@javaTop,javaParenT1 | 
					
						
							| 
									
										
										
										
											2004-12-09 21:34:53 +00:00
										 |  |  |  | syn region  javaParenT1 transparent matchgroup=javaParen1 start="\[" end="\]" contains=@javaTop,javaParenT2 contained | 
					
						
							|  |  |  |  | syn region  javaParenT2 transparent matchgroup=javaParen2 start="\[" end="\]" contains=@javaTop,javaParenT  contained | 
					
						
							| 
									
										
										
										
											2010-05-14 23:24:24 +02:00
										 |  |  |  | syn match   javaParenError	 "\]" | 
					
						
							| 
									
										
										
										
											2004-12-09 21:34:53 +00:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-08-31 22:22:10 +02:00
										 |  |  |  | hi def link javaParenError	javaError | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-05-31 12:11:34 +03:00
										 |  |  |  | " Lambda expressions (JLS-17, §15.27). | 
					
						
							| 
									
										
										
										
											2015-03-02 23:16:07 +01:00
										 |  |  |  | if exists("java_highlight_functions") | 
					
						
							| 
									
										
										
										
											2024-04-14 19:57:00 +03:00
										 |  |  |  |   " Make ()-matching definitions after the parenthesis error catcher. | 
					
						
							| 
									
										
										
										
											2024-05-31 12:11:34 +03:00
										 |  |  |  |   " | 
					
						
							|  |  |  |  |   " Match: ([@A [@B ...] final] var a[, var b, ...]) -> | 
					
						
							|  |  |  |  |   "	| ([@A [@B ...] final] T[<α>][[][]] a[, T b, ...]) -> | 
					
						
							|  |  |  |  |   " There is no recognition of expressions interspersed with comments | 
					
						
							|  |  |  |  |   " or of expressions whose parameterised parameter types are written | 
					
						
							|  |  |  |  |   " across multiple lines. | 
					
						
							|  |  |  |  |   exec 'syn match javaLambdaDef "\k\@' . s:ff.Peek('4', '') . '<!([[:space:]\n]*\%(\%(@\%(\K\k*\.\)*\K\k*\>\%((\_.\{-1,})\)\{-,1}[[:space:]\n]\+\)*\%(final[[:space:]\n]\+\)\=\%(\<\K\k*\>\.\)*\<\K\k*\>\%(<[^(){}]*[[:space:]-]\@' . s:ff.Peek('1', '') . '<!>\)\=\%(\%(\%(\[\]\)\+\|\.\.\.\)\)\=[[:space:]\n]\+\<\K\k*\>\%(\[\]\)*\%(,[[:space:]\n]*\)\=\)\+)[[:space:]\n]*->" contains=javaAnnotation,javaParamModifier,javaLambdaVarType,javaType,@javaClasses,javaVarArg' | 
					
						
							|  |  |  |  |   " Match: () -> | 
					
						
							|  |  |  |  |   "	| (a[, b, ...]) -> | 
					
						
							|  |  |  |  |   exec 'syn match javaLambdaDef "\k\@' . s:ff.Peek('4', '') . '<!([[:space:]\n]*\%(\<\K\k*\>\%(,[[:space:]\n]*\)\=\)*)[[:space:]\n]*->"' | 
					
						
							|  |  |  |  |   " Match: a -> | 
					
						
							|  |  |  |  |   exec 'syn match javaLambdaDef "\<\K\k*\>\%(\<default\>\)\@' . s:ff.Peek('7', '') . '<![[:space:]\n]*->"' | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  |   syn keyword javaParamModifier contained final | 
					
						
							|  |  |  |  |   hi def link javaParamModifier javaConceptKind | 
					
						
							|  |  |  |  |   syn keyword javaLambdaVarType contained var | 
					
						
							|  |  |  |  |   hi def link javaLambdaVarType javaOperator | 
					
						
							| 
									
										
										
										
											2015-03-02 23:16:07 +01:00
										 |  |  |  | endif | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-05-10 15:49:06 +03:00
										 |  |  |  | " The @javaTop cluster comprises non-contained Java syntax groups. | 
					
						
							|  |  |  |  | " Note that the syntax file "aidl.vim" relies on its availability. | 
					
						
							|  |  |  |  | syn cluster javaTop contains=TOP,javaDocComment,javaFold,javaParenError,javaParenT | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | if !exists("java_minlines") | 
					
						
							|  |  |  |  |   let java_minlines = 10 | 
					
						
							|  |  |  |  | endif | 
					
						
							| 
									
										
											  
											
												runtime(java): Recognise the inline kind of the {@return} tag (#14284)
Also:
- Refine comment matching (javaComment{Error\ and,Start}).
- Continue rewriting regexps (prefer atom grouping with
  non-capturing parens; factor out common prefixes in
  alternations).
- Allow for relative paths with the _file_ attribute of
  {@snippet}.
- Anticipate HTML in the @see tags.
- Match the nullary method parens in javaDocSeeTagParam.
- Improve the boundary patterns for summary sentences of
  documentation.
> This sentence ends at ... or at the first tag (as defined
> below).
There are Java documentation tags (@) and there are HTML
tags (<?>) (with Markdown looming large; see JEP 467).  With
block tags, e.g. @param, @return, @see, we begin another
documentation "sentence" whether or not the author has
terminated the summary sentence with a period; with
.<!-- -->, we may follow abbreviations, enumerations,
initials, (but instead consider @literal or  ) _within_
the summary sentence.  On the other hand, inline tags, e.g.
@code, @link, @literal, should not terminate the summary
sentence.
References:
https://bugs.openjdk.org/browse/JDK-8075778
https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html#firstsentence
https://docs.oracle.com/en/java/javase/21/docs/specs/javadoc/doc-comment-spec.html
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-03-25 18:18:28 +03:00
										 |  |  |  | 
 | 
					
						
							|  |  |  |  | " Note that variations of a /*/ balanced comment, e.g., /*/*/, /*//*/, | 
					
						
							|  |  |  |  | " /* /*/, /*  /*/, etc., may have their rightmost /*/ part accepted | 
					
						
							|  |  |  |  | " as a comment start by ':syntax sync ccomment'; consider alternatives | 
					
						
							|  |  |  |  | " to make synchronisation start further towards file's beginning by | 
					
						
							|  |  |  |  | " bumping up g:java_minlines or issuing ':syntax sync fromstart' or | 
					
						
							|  |  |  |  | " preferring &foldmethod set to 'syntax'. | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | exec "syn sync ccomment javaComment minlines=" . java_minlines | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | " The default highlighting. | 
					
						
							| 
									
										
										
										
											2016-08-31 22:22:10 +02:00
										 |  |  |  | hi def link javaLambdaDef		Function | 
					
						
							|  |  |  |  | hi def link javaFuncDef		Function | 
					
						
							|  |  |  |  | hi def link javaVarArg			Function | 
					
						
							|  |  |  |  | hi def link javaBraces			Function | 
					
						
							|  |  |  |  | hi def link javaBranch			Conditional | 
					
						
							|  |  |  |  | hi def link javaUserLabelRef		javaUserLabel | 
					
						
							|  |  |  |  | hi def link javaLabel			Label | 
					
						
							|  |  |  |  | hi def link javaUserLabel		Label | 
					
						
							|  |  |  |  | hi def link javaConditional		Conditional | 
					
						
							|  |  |  |  | hi def link javaRepeat			Repeat | 
					
						
							|  |  |  |  | hi def link javaExceptions		Exception | 
					
						
							|  |  |  |  | hi def link javaAssert			Statement | 
					
						
							|  |  |  |  | hi def link javaStorageClass		StorageClass | 
					
						
							|  |  |  |  | hi def link javaMethodDecl		javaStorageClass | 
					
						
							|  |  |  |  | hi def link javaClassDecl		javaStorageClass | 
					
						
							|  |  |  |  | hi def link javaScopeDecl		javaStorageClass | 
					
						
							| 
									
										
											  
											
												runtime(java): Recognise _when_ clauses in _switch_ blocks
Also:
- distinguish _yield_ when used as a contextual keyword from
  when used qualified as a method or a method reference (as
  can be seen in testdir/input/java_switch.java, variables
  and method declarations named _yield_ will be recognised
  as the namesake keyword--consider picking other names for
  variables, and defining g:java_highlight_functions to have
  method names painted; since _yield_ statements can have
  trailing parens, they must be recognised as statements,
  for only qualified _yield_ method calls are supported);
- recognise grouped _default_ _case_ labels;
- describe primitive types for _case_ labels (JLS, §14.11,
  §3.10.1);
- recognise some non-ASCII identifiers (see javaLambdaDef,
  javaUserLabel) (further improvement for better recognition
  of identifiers will be arranged in a separate PR).
Because the arrow '->' is used in two kinds of expressions,
lambda (abstractions) and _switch_, necessary changes were
made for the recognition of either (and further improvement
touching lambda expressions will be separately arranged).
Because 'default' is used for instance method declarations
in interfaces and in _switch_ labels, necessary changes were
made for the recognition of either (and further improvement
touching method declarations will be separately arranged).
Finally, it deemed appropriate to put 'yield' in the syntax
group of javaOperator rather than javaStatement, for its
member 'var' is also another contextual keyword (e.g., this
is valid syntax: "var var = var(test.var);").
References:
https://openjdk.org/jeps/361 (Switch Expressions)
https://openjdk.org/jeps/440 (Record Patterns)
https://openjdk.org/jeps/441 (Pattern Matching for switch)
Also, add a Java specific filetype plugin for the syntax
test, so that no soft-wrapping of long indented lines occur.
Otherwise the syntax scripts would miss a few lines during
scrolling and verification of the screen dumps.
closes: #14105
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-02-28 21:30:22 +01:00
										 |  |  |  | hi def link javaConceptKind		NonText | 
					
						
							| 
									
										
										
										
											2018-07-29 15:07:52 +02:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-08-31 22:22:10 +02:00
										 |  |  |  | hi def link javaBoolean		Boolean | 
					
						
							|  |  |  |  | hi def link javaSpecial		Special | 
					
						
							|  |  |  |  | hi def link javaSpecialError		Error | 
					
						
							|  |  |  |  | hi def link javaSpecialCharError	Error | 
					
						
							|  |  |  |  | hi def link javaString			String | 
					
						
							| 
									
										
											  
											
												runtime(java): Recognise string templates (#14150)
As this is encouraged in the referenced JEPs, "to visually
distinguish a string template from a string literal, and
a text block template from a text block", the default
colours for java\%[Debug]StrTempl are made distinct from
java\%[Debug]String.
According to §3.2 Lexical Translations (JLS, c. 1996 or any
more recent version), line terminators, white space, and
comments are discarded before tokens are accepted. Since
a template expression comprises a template processor, a dot,
and a template, it may be visually appealing to break up
its head across a few lines whenever its tail already spans
multiple lines.  Curiously, no allowance for it is made in
the distributed tests for OpenJDK 21; the proposed regexp
patterns take in consideration a line terminator and white
space after a dot.
References:
https://openjdk.org/jeps/430 (Preview)
https://openjdk.org/jeps/459 (Second Preview)
https://openjdk.org/jeps/465
Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
											
										 
											2024-03-09 20:03:11 +03:00
										 |  |  |  | hi def link javaStrTempl		Macro | 
					
						
							| 
									
										
										
										
											2016-08-31 22:22:10 +02:00
										 |  |  |  | hi def link javaCharacter		Character | 
					
						
							|  |  |  |  | hi def link javaSpecialChar		SpecialChar | 
					
						
							|  |  |  |  | hi def link javaNumber			Number | 
					
						
							|  |  |  |  | hi def link javaError			Error | 
					
						
							| 
									
										
										
										
											2024-05-10 15:49:06 +03:00
										 |  |  |  | hi def link javaTextBlockError		Error | 
					
						
							| 
									
										
										
										
											2016-08-31 22:22:10 +02:00
										 |  |  |  | hi def link javaStatement		Statement | 
					
						
							|  |  |  |  | hi def link javaOperator		Operator | 
					
						
							|  |  |  |  | hi def link javaComment		Comment | 
					
						
							|  |  |  |  | hi def link javaDocComment		Comment | 
					
						
							|  |  |  |  | hi def link javaLineComment		Comment | 
					
						
							|  |  |  |  | hi def link javaConstant		Constant | 
					
						
							|  |  |  |  | hi def link javaTypedef		Typedef | 
					
						
							|  |  |  |  | hi def link javaTodo			Todo | 
					
						
							|  |  |  |  | hi def link javaAnnotation		PreProc | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | hi def link javaCommentTitle		SpecialComment | 
					
						
							|  |  |  |  | hi def link javaDocTags		Special | 
					
						
							| 
									
										
										
										
											2024-03-22 21:32:48 +03:00
										 |  |  |  | hi def link javaDocCodeTag		Special | 
					
						
							|  |  |  |  | hi def link javaDocSnippetTag		Special | 
					
						
							| 
									
										
										
										
											2016-08-31 22:22:10 +02:00
										 |  |  |  | hi def link javaDocParam		Function | 
					
						
							|  |  |  |  | hi def link javaDocSeeTagParam		Function | 
					
						
							|  |  |  |  | hi def link javaCommentStar		javaComment | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | hi def link javaType			Type | 
					
						
							|  |  |  |  | hi def link javaExternal		Include | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | hi def link htmlComment		Special | 
					
						
							|  |  |  |  | hi def link htmlCommentPart		Special | 
					
						
							| 
									
										
										
										
											2024-03-22 21:32:48 +03:00
										 |  |  |  | hi def link htmlArg			Type | 
					
						
							|  |  |  |  | hi def link htmlString			String | 
					
						
							| 
									
										
										
										
											2016-08-31 22:22:10 +02:00
										 |  |  |  | hi def link javaSpaceError		Error | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-04-04 21:51:18 +02:00
										 |  |  |  | if s:module_info_cur_buf | 
					
						
							|  |  |  |  |   hi def link javaModuleStorageClass	StorageClass | 
					
						
							|  |  |  |  |   hi def link javaModuleStmt		Statement | 
					
						
							|  |  |  |  |   hi def link javaModuleExternal	Include | 
					
						
							| 
									
										
										
										
											2018-07-29 15:07:52 +02:00
										 |  |  |  | endif | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | let b:current_syntax = "java" | 
					
						
							|  |  |  |  | 
 | 
					
						
							|  |  |  |  | if main_syntax == 'java' | 
					
						
							|  |  |  |  |   unlet main_syntax | 
					
						
							|  |  |  |  | endif | 
					
						
							|  |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-04-04 21:51:18 +02:00
										 |  |  |  | let b:spell_options = "contained" | 
					
						
							| 
									
										
										
										
											2012-10-05 22:26:30 +02:00
										 |  |  |  | let &cpo = s:cpo_save | 
					
						
							| 
									
										
										
										
											2024-05-11 00:39:31 +03:00
										 |  |  |  | unlet s:module_info_cur_buf s:ff s:cpo_save | 
					
						
							| 
									
										
										
										
											2004-06-13 20:20:40 +00:00
										 |  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2024-05-10 15:49:06 +03:00
										 |  |  |  | " vim: sw=2 ts=8 noet sta |