mirror of
				https://github.com/vim/vim.git
				synced 2025-10-30 09:47:20 -04:00 
			
		
		
		
	Complement "g:java_ignore_javadoc" with "g:java_ignore_html" and "g:java_ignore_markdown" to allow selectively disabling the recognition of HTML and CommonMark respectively. (Note that this is not a preview feature.) ======================== LIMITATION ======================== According to the syntactical details of JEP 467: > Any leading whitespace and the three initial / characters > are removed from each line. > > The lines are shifted left, by removing leading whitespace > characters, until the non-blank line with the least > leading whitespace has no remaining leading whitespace. > > Additional leading whitespace and any trailing whitespace > in each line is preserved, because it may be significant. the following example: ------------------------------------------------------------ /// A summary sentence. /// A list: /// - Item A. /// - Item B. /// /// Some code span, starting here ` /// 1 + 2 ` and ending at the previous \`. ------------------------------------------------------------ should be interpreted as if it were written thus: ------------------------------------------------------------ ///A summary sentence. /// A list: /// - Item A. /// - Item B. /// /// Some code span, starting here ` /// 1 + 2 ` and ending at the previous \`. ------------------------------------------------------------ Since automatic line rewriting will not be pursued, parts of such comments having significant whitespace may be ‘wrongly’ highlighted. For convenience, a &fex function is defined to ‘correct’ it: g:javaformat#RemoveCommonMarkdownWhitespace() (:help ft-java-plugin). References: https://openjdk.org/jeps/467 https://spec.commonmark.org/0.31.2 closes: #15740 Co-authored-by: Tim Pope <code@tpope.net> Signed-off-by: Aliaksei Budavei <0x000c70@gmail.com> Signed-off-by: Christian Brabandt <cb@256bit.org>
		
			
				
	
	
		
			121 lines
		
	
	
		
			3.6 KiB
		
	
	
	
		
			VimL
		
	
	
	
	
	
			
		
		
	
	
			121 lines
		
	
	
		
			3.6 KiB
		
	
	
	
		
			VimL
		
	
	
	
	
	
| " Vim filetype plugin file
 | |
| " Language:		Java
 | |
| " Maintainer:		Aliaksei Budavei <0x000c70 AT gmail DOT com>
 | |
| " Former Maintainer:	Dan Sharp
 | |
| " Repository:		https://github.com/zzzyxwvut/java-vim.git
 | |
| " Last Change:		2024 Sep 26
 | |
| "			2024 Jan 14 by Vim Project (browsefilter)
 | |
| "			2024 May 23 by Riley Bruins <ribru17@gmail.com> ('commentstring')
 | |
| 
 | |
| " Make sure the continuation lines below do not cause problems in
 | |
| " compatibility mode.
 | |
| let s:save_cpo = &cpo
 | |
| set cpo-=C
 | |
| 
 | |
| if (exists("g:java_ignore_javadoc") || exists("g:java_ignore_markdown")) &&
 | |
| 	\ exists("*javaformat#RemoveCommonMarkdownWhitespace")
 | |
|     delfunction javaformat#RemoveCommonMarkdownWhitespace
 | |
|     unlet! g:loaded_javaformat
 | |
| endif
 | |
| 
 | |
| if exists("b:did_ftplugin")
 | |
|     let &cpo = s:save_cpo
 | |
|     unlet s:save_cpo
 | |
|     finish
 | |
| endif
 | |
| 
 | |
| let b:did_ftplugin = 1
 | |
| 
 | |
| " For filename completion, prefer the .java extension over the .class
 | |
| " extension.
 | |
| set suffixes+=.class
 | |
| 
 | |
| " Enable gf on import statements.  Convert . in the package
 | |
| " name to / and append .java to the name, then search the path.
 | |
| setlocal includeexpr=substitute(v:fname,'\\.','/','g')
 | |
| setlocal suffixesadd=.java
 | |
| 
 | |
| " Clean up in case this file is sourced again.
 | |
| unlet! s:zip_func_upgradable
 | |
| 
 | |
| """" STRIVE TO REMAIN COMPATIBLE FOR AT LEAST VIM 7.0.
 | |
| 
 | |
| " Documented in ":help ft-java-plugin".
 | |
| if exists("g:ftplugin_java_source_path") &&
 | |
| 		\ type(g:ftplugin_java_source_path) == type("")
 | |
|     if filereadable(g:ftplugin_java_source_path)
 | |
| 	if exists("#zip") &&
 | |
| 		    \ g:ftplugin_java_source_path =~# '.\.\%(jar\|zip\)$'
 | |
| 	    if !exists("s:zip_files")
 | |
| 		let s:zip_files = {}
 | |
| 	    endif
 | |
| 
 | |
| 	    let s:zip_files[bufnr('%')] = g:ftplugin_java_source_path
 | |
| 	    let s:zip_files[0] = g:ftplugin_java_source_path
 | |
| 	    let s:zip_func_upgradable = 1
 | |
| 
 | |
| 	    function! JavaFileTypeZipFile() abort
 | |
| 		let @/ = substitute(v:fname, '\.', '\\/', 'g') . '.java'
 | |
| 		return get(s:zip_files, bufnr('%'), s:zip_files[0])
 | |
| 	    endfunction
 | |
| 
 | |
| 	    " E120 for "inex=s:JavaFileTypeZipFile()" before v8.2.3900.
 | |
| 	    setlocal includeexpr=JavaFileTypeZipFile()
 | |
| 	    setlocal suffixesadd<
 | |
| 	endif
 | |
|     else
 | |
| 	let &l:path = g:ftplugin_java_source_path . ',' . &l:path
 | |
|     endif
 | |
| endif
 | |
| 
 | |
| " Set 'formatoptions' to break comment lines but not other lines,
 | |
| " and insert the comment leader when hitting <CR> or using "o".
 | |
| setlocal formatoptions-=t formatoptions+=croql
 | |
| 
 | |
| " Set 'comments' to format Markdown Javadoc comments and dashed lists
 | |
| " in other multi-line comments (it behaves just like C).
 | |
| setlocal comments& comments^=:///,sO:*\ -,mO:*\ \ ,exO:*/
 | |
| 
 | |
| setlocal commentstring=//\ %s
 | |
| 
 | |
| " Change the :browse e filter to primarily show Java-related files.
 | |
| if (has("gui_win32") || has("gui_gtk")) && !exists("b:browsefilter")
 | |
|     let  b:browsefilter="Java Files (*.java)\t*.java\n" .
 | |
| 		\	"Properties Files (*.prop*)\t*.prop*\n" .
 | |
| 		\	"Manifest Files (*.mf)\t*.mf\n"
 | |
|     if has("win32")
 | |
| 	let b:browsefilter .= "All Files (*.*)\t*\n"
 | |
|     else
 | |
| 	let b:browsefilter .= "All Files (*)\t*\n"
 | |
|     endif
 | |
| endif
 | |
| 
 | |
| " Undo the stuff we changed.
 | |
| let b:undo_ftplugin = "setlocal suffixes< suffixesadd<" .
 | |
| 		\     " formatoptions< comments< commentstring< path< includeexpr<" .
 | |
| 		\     " | unlet! b:browsefilter"
 | |
| 
 | |
| " See ":help vim9-mix".
 | |
| if !has("vim9script")
 | |
|     let &cpo = s:save_cpo
 | |
|     unlet s:save_cpo
 | |
|     finish
 | |
| endif
 | |
| 
 | |
| if exists("s:zip_func_upgradable")
 | |
|     delfunction! JavaFileTypeZipFile
 | |
| 
 | |
|     def! s:JavaFileTypeZipFile(): string
 | |
| 	@/ = substitute(v:fname, '\.', '\\/', 'g') .. '.java'
 | |
| 	return get(zip_files, bufnr('%'), zip_files[0])
 | |
|     enddef
 | |
| 
 | |
|     setlocal includeexpr=s:JavaFileTypeZipFile()
 | |
|     setlocal suffixesadd<
 | |
| endif
 | |
| 
 | |
| " Restore the saved compatibility options.
 | |
| let &cpo = s:save_cpo
 | |
| unlet s:save_cpo
 | |
| " vim: fdm=syntax sw=4 ts=8 noet sta
 |