vim/YouCompleteMe
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Auto merge of #3087 - micbou:filepath-blacklist-docs, r=micbou

Browse Source 
[READY] Add g:ycm_filepath_blacklist option to documentation

See PR https://github.com/Valloric/ycmd/pull/1061.

<!-- Reviewable:start -->
---
This change is [<img src="https://reviewable.io/review_button.svg" height="34" align="absmiddle" alt="Reviewable"/>](https://reviewable.io/reviews/valloric/youcompleteme/3087)
<!-- Reviewable:end -->
This commit is contained in:
zzbot 2018-07-25 11:24:43 -07:00 committed by GitHub
commit 8a911c1a80
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 100 additions and 50 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
README.md
View File

@ -2117,8 +2117,8 @@ let g:ycm_auto_trigger = 1
This option controls for which Vim filetypes (see `:h filetype`) should YCM be This option controls for which Vim filetypes (see `:h filetype`) should YCM be
turned on. The option value should be a Vim dictionary with keys being filetype turned on. The option value should be a Vim dictionary with keys being filetype
strings (like `python`, `cpp` etc) and values being unimportant (the dictionary strings (like `python`, `cpp`, etc.) and values being unimportant (the
is used like a hash set, meaning that only the keys matter). dictionary is used like a hash set, meaning that only the keys matter).
The `*` key is special and matches all filetypes. By default, the whitelist The `*` key is special and matches all filetypes. By default, the whitelist
contains only this `*` key. contains only this `*` key.
@ -2149,8 +2149,8 @@ let g:ycm_filetype_whitelist = { '*': 1 }
This option controls for which Vim filetypes (see `:h filetype`) should YCM be This option controls for which Vim filetypes (see `:h filetype`) should YCM be
turned off. The option value should be a Vim dictionary with keys being filetype turned off. The option value should be a Vim dictionary with keys being filetype
strings (like `python`, `cpp` etc) and values being unimportant (the dictionary strings (like `python`, `cpp`, etc.) and values being unimportant (the
is used like a hash set, meaning that only the keys matter). dictionary is used like a hash set, meaning that only the keys matter).
See the `g:ycm_filetype_whitelist` option for more details on how this works. See the `g:ycm_filetype_whitelist` option for more details on how this works.
@ -2175,7 +2175,7 @@ let g:ycm_filetype_blacklist = {
This option controls for which Vim filetypes (see `:h filetype`) should the YCM This option controls for which Vim filetypes (see `:h filetype`) should the YCM
semantic completion engine be turned off. The option value should be a Vim semantic completion engine be turned off. The option value should be a Vim
dictionary with keys being filetype strings (like `python`, `cpp` etc) and dictionary with keys being filetype strings (like `python`, `cpp`, etc.) and
values being unimportant (the dictionary is used like a hash set, meaning that values being unimportant (the dictionary is used like a hash set, meaning that
only the keys matter). The listed filetypes will be ignored by the YCM semantic only the keys matter). The listed filetypes will be ignored by the YCM semantic
completion engine, but the identifier-based completion engine will still trigger completion engine, but the identifier-based completion engine will still trigger
@ -2195,6 +2195,31 @@ let g:ycm_filetype_specific_completion_to_disable = {
\} \}
``` ```
### The `g:ycm_filepath_blacklist` option
This option controls for which Vim filetypes (see `:h filetype`) should filepath
completion be disabled. The option value should be a Vim dictionary with keys
being filetype strings (like `python`, `cpp`, etc.) and values being unimportant
(the dictionary is used like a hash set, meaning that only the keys matter).
The `*` key is special and matches all filetypes. Use this key if you want to
completely disable filepath completion:
```viml
let g:ycm_filepath_blacklist = { '*': 1 }
```
You can get the filetype of the current file in Vim with `:set ft?`.
Default: `[see next line]`
```viml
let g:ycm_filepath_blacklist = {
\ 'html' : 1,
\ 'jsx' : 1,
\ 'xml' : 1,
\}
```
### The `g:ycm_show_diagnostics_ui` option ### The `g:ycm_show_diagnostics_ui` option
When set, this option turns on YCM's diagnostic display features. See the When set, this option turns on YCM's diagnostic display features. See the

115
doc/youcompleteme.txt
View File

@ -105,47 +105,48 @@ Contents ~
6. The |g:ycm_filetype_whitelist| option 6. The |g:ycm_filetype_whitelist| option
7. The |g:ycm_filetype_blacklist| option 7. The |g:ycm_filetype_blacklist| option
8. The |g:ycm_filetype_specific_completion_to_disable| option 8. The |g:ycm_filetype_specific_completion_to_disable| option
9. The |g:ycm_show_diagnostics_ui| option 9. The |g:ycm_filepath_blacklist| option
10. The |g:ycm_error_symbol| option 10. The |g:ycm_show_diagnostics_ui| option
11. The |g:ycm_warning_symbol| option 11. The |g:ycm_error_symbol| option
12. The |g:ycm_enable_diagnostic_signs| option 12. The |g:ycm_warning_symbol| option
13. The |g:ycm_enable_diagnostic_highlighting| option 13. The |g:ycm_enable_diagnostic_signs| option
14. The |g:ycm_echo_current_diagnostic| option 14. The |g:ycm_enable_diagnostic_highlighting| option
15. The |g:ycm_filter_diagnostics| option 15. The |g:ycm_echo_current_diagnostic| option
16. The |g:ycm_always_populate_location_list| option 16. The |g:ycm_filter_diagnostics| option
17. The |g:ycm_open_loclist_on_ycm_diags| option 17. The |g:ycm_always_populate_location_list| option
18. The |g:ycm_complete_in_comments| option 18. The |g:ycm_open_loclist_on_ycm_diags| option
19. The |g:ycm_complete_in_strings| option 19. The |g:ycm_complete_in_comments| option
20. The |g:ycm_collect_identifiers_from_comments_and_strings| option 20. The |g:ycm_complete_in_strings| option
21. The |g:ycm_collect_identifiers_from_tags_files| option 21. The |g:ycm_collect_identifiers_from_comments_and_strings| option
22. The |g:ycm_seed_identifiers_with_syntax| option 22. The |g:ycm_collect_identifiers_from_tags_files| option
23. The |g:ycm_extra_conf_vim_data| option 23. The |g:ycm_seed_identifiers_with_syntax| option
24. The |g:ycm_server_python_interpreter| option 24. The |g:ycm_extra_conf_vim_data| option
25. The |g:ycm_keep_logfiles| option 25. The |g:ycm_server_python_interpreter| option
26. The |g:ycm_log_level| option 26. The |g:ycm_keep_logfiles| option
27. The |g:ycm_auto_start_csharp_server| option 27. The |g:ycm_log_level| option
28. The |g:ycm_auto_stop_csharp_server| option 28. The |g:ycm_auto_start_csharp_server| option
29. The |g:ycm_csharp_server_port| option 29. The |g:ycm_auto_stop_csharp_server| option
30. The |g:ycm_csharp_insert_namespace_expr| option 30. The |g:ycm_csharp_server_port| option
31. The |g:ycm_add_preview_to_completeopt| option 31. The |g:ycm_csharp_insert_namespace_expr| option
32. The |g:ycm_autoclose_preview_window_after_completion| option 32. The |g:ycm_add_preview_to_completeopt| option
33. The |g:ycm_autoclose_preview_window_after_insertion| option 33. The |g:ycm_autoclose_preview_window_after_completion| option
34. The |g:ycm_max_diagnostics_to_display| option 34. The |g:ycm_autoclose_preview_window_after_insertion| option
35. The |g:ycm_key_list_select_completion| option 35. The |g:ycm_max_diagnostics_to_display| option
36. The |g:ycm_key_list_previous_completion| option 36. The |g:ycm_key_list_select_completion| option
37. The |g:ycm_key_list_stop_completion| option 37. The |g:ycm_key_list_previous_completion| option
38. The |g:ycm_key_invoke_completion| option 38. The |g:ycm_key_list_stop_completion| option
39. The |g:ycm_key_detailed_diagnostics| option 39. The |g:ycm_key_invoke_completion| option
40. The |g:ycm_global_ycm_extra_conf| option 40. The |g:ycm_key_detailed_diagnostics| option
41. The |g:ycm_confirm_extra_conf| option 41. The |g:ycm_global_ycm_extra_conf| option
42. The |g:ycm_extra_conf_globlist| option 42. The |g:ycm_confirm_extra_conf| option
43. The |g:ycm_filepath_completion_use_working_dir| option 43. The |g:ycm_extra_conf_globlist| option
44. The |g:ycm_semantic_triggers| option 44. The |g:ycm_filepath_completion_use_working_dir| option
45. The |g:ycm_cache_omnifunc| option 45. The |g:ycm_semantic_triggers| option
46. The |g:ycm_use_ultisnips_completer| option 46. The |g:ycm_cache_omnifunc| option
47. The |g:ycm_goto_buffer_command| option 47. The |g:ycm_use_ultisnips_completer| option
48. The |g:ycm_disable_for_files_larger_than_kb| option 48. The |g:ycm_goto_buffer_command| option
49. The |g:ycm_python_binary_path| option 49. The |g:ycm_disable_for_files_larger_than_kb| option
50. The |g:ycm_python_binary_path| option
13. FAQ |youcompleteme-faq| 13. FAQ |youcompleteme-faq|
1. I used to be able to 'import vim' in '.ycm_extra_conf.py', but now can't |youcompleteme-i-used-to-be-able-to-import-vim-in-.ycm_extra_conf.py-but-now-cant| 1. I used to be able to 'import vim' in '.ycm_extra_conf.py', but now can't |youcompleteme-i-used-to-be-able-to-import-vim-in-.ycm_extra_conf.py-but-now-cant|
2. I get 'ImportError' exceptions that mention 'PyInit_ycm_core' or 'initycm_core' |youcompleteme-i-get-importerror-exceptions-that-mention-pyinit_ycm_core-or-initycm_core| 2. I get 'ImportError' exceptions that mention 'PyInit_ycm_core' or 'initycm_core' |youcompleteme-i-get-importerror-exceptions-that-mention-pyinit_ycm_core-or-initycm_core|
@ -2402,8 +2403,8 @@ The *g:ycm_filetype_whitelist* option
This option controls for which Vim filetypes (see ':h filetype') should YCM be This option controls for which Vim filetypes (see ':h filetype') should YCM be
turned on. The option value should be a Vim dictionary with keys being filetype turned on. The option value should be a Vim dictionary with keys being filetype
strings (like 'python', 'cpp' etc) and values being unimportant (the dictionary strings (like 'python', 'cpp', etc.) and values being unimportant (the
is used like a hash set, meaning that only the keys matter). dictionary is used like a hash set, meaning that only the keys matter).
The '*' key is special and matches all filetypes. By default, the whitelist The '*' key is special and matches all filetypes. By default, the whitelist
contains only this '*' key. contains only this '*' key.
@ -2433,7 +2434,7 @@ The *g:ycm_filetype_blacklist* option
This option controls for which Vim filetypes (see ':h filetype') should YCM be This option controls for which Vim filetypes (see ':h filetype') should YCM be
turned off. The option value should be a Vim dictionary with keys being turned off. The option value should be a Vim dictionary with keys being
filetype strings (like 'python', 'cpp' etc) and values being unimportant (the filetype strings (like 'python', 'cpp', etc.) and values being unimportant (the
dictionary is used like a hash set, meaning that only the keys matter). dictionary is used like a hash set, meaning that only the keys matter).
See the |g:ycm_filetype_whitelist| option for more details on how this works. See the |g:ycm_filetype_whitelist| option for more details on how this works.
@ -2458,7 +2459,7 @@ The *g:ycm_filetype_specific_completion_to_disable* option
This option controls for which Vim filetypes (see ':h filetype') should the YCM This option controls for which Vim filetypes (see ':h filetype') should the YCM
semantic completion engine be turned off. The option value should be a Vim semantic completion engine be turned off. The option value should be a Vim
dictionary with keys being filetype strings (like 'python', 'cpp' etc) and dictionary with keys being filetype strings (like 'python', 'cpp', etc.) and
values being unimportant (the dictionary is used like a hash set, meaning that values being unimportant (the dictionary is used like a hash set, meaning that
only the keys matter). The listed filetypes will be ignored by the YCM semantic only the keys matter). The listed filetypes will be ignored by the YCM semantic
completion engine, but the identifier-based completion engine will still completion engine, but the identifier-based completion engine will still
@ -2477,6 +2478,30 @@ Default: '[see next line]'
\} \}
< <
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
The *g:ycm_filepath_blacklist* option
This option controls for which Vim filetypes (see ':h filetype') should
filepath completion be disabled. The option value should be a Vim dictionary
with keys being filetype strings (like 'python', 'cpp', etc.) and values being
unimportant (the dictionary is used like a hash set, meaning that only the keys
matter).
The '*' key is special and matches all filetypes. Use this key if you want to
completely disable filepath completion:
>
let g:ycm_filepath_blacklist = { '*': 1 }
<
You can get the filetype of the current file in Vim with ':set ft?'.
Default: '[see next line]'
>
let g:ycm_filepath_blacklist = {
\ 'html' : 1,
\ 'jsx' : 1,
\ 'xml' : 1,
\}
<
-------------------------------------------------------------------------------
The *g:ycm_show_diagnostics_ui* option The *g:ycm_show_diagnostics_ui* option
When set, this option turns on YCM's diagnostic display features. See the When set, this option turns on YCM's diagnostic display features. See the