Mercurial > vim
annotate runtime/doc/filetype.txt @ 35236:3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Commit: https://github.com/vim/vim/commit/d1d9316c6621d275593f58664975faf0fc23985f
Author: Tiseno <mathias.lindgren@stabelo.se>
Date: Tue May 21 23:27:03 2024 +0200
runtime(zig): refactor zig ftplugin, remove auto format
Refactored zig ftplugin, removed upstream comment, aucmd and
auto formatting support. Updated documentation for zig configuration
settings and added new maintainer.
closes: #13803
Signed-off-by: Tiseno <mathias.lindgren@stabelo.se>
Signed-off-by: Christian Brabandt <cb@256bit.org>
author | Christian Brabandt <cb@256bit.org> |
---|---|
date | Tue, 21 May 2024 23:30:04 +0200 |
parents | 82cc33448f6b |
children | ea0402ba92f6 |
rev | line source |
---|---|
35236
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
1 *filetype.txt* For Vim version 9.1. Last change: 2024 May 21 |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
2 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
3 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
4 VIM REFERENCE MANUAL by Bram Moolenaar |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
5 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
6 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
7 Filetypes *filetype* *file-type* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
8 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
9 1. Filetypes |filetypes| |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
10 2. Filetype plugin |filetype-plugins| |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
11 3. Docs for the default filetype plugins. |ftplugin-docs| |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
12 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
13 Also see |autocmd.txt|. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
14 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
15 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
16 ============================================================================== |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
17 1. Filetypes *filetypes* *file-types* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
18 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
19 Vim can detect the type of file that is edited. This is done by checking the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
20 file name and sometimes by inspecting the contents of the file for specific |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
21 text. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
22 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
23 *:filetype* *:filet* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
24 To enable file type detection, use this command in your vimrc: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
25 :filetype on |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
26 Each time a new or existing file is edited, Vim will try to recognize the type |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
27 of the file and set the 'filetype' option. This will trigger the FileType |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
28 event, which can be used to set the syntax highlighting, set options, etc. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
29 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
30 NOTE: Filetypes and 'compatible' don't work together well, since being Vi |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
31 compatible means options are global. Resetting 'compatible' is recommended, |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
32 if you didn't do that already. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
33 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
34 Detail: The ":filetype on" command will load one of these files: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
35 Amiga $VIMRUNTIME/filetype.vim |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
36 Mac $VIMRUNTIME:filetype.vim |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
37 MS-Windows $VIMRUNTIME\filetype.vim |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
38 Unix $VIMRUNTIME/filetype.vim |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
39 VMS $VIMRUNTIME/filetype.vim |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
40 This file is a Vim script that defines autocommands for the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
41 BufNewFile and BufRead events. If the file type is not found by the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
42 name, the file $VIMRUNTIME/scripts.vim is used to detect it from the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
43 contents of the file. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
44 When the GUI is running or will start soon, the |menu.vim| script is |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
45 also sourced. See |'go-M'| about avoiding that. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
46 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
47 To add your own file types, see |new-filetype| below. To search for help on a |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
48 filetype prepend "ft-" and optionally append "-syntax", "-indent" or |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
49 "-plugin". For example: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
50 :help ft-vim-indent |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
51 :help ft-vim-syntax |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
52 :help ft-man-plugin |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
53 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
54 If the file type is not detected automatically, or it finds the wrong type, |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
55 you can either set the 'filetype' option manually, or add a modeline to your |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
56 file. Example, for an IDL file use the command: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
57 :set filetype=idl |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
58 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
59 or add this |modeline| to the file: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
60 /* vim: set filetype=idl : */ ~ |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
61 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
62 *:filetype-plugin-on* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
63 You can enable loading the plugin files for specific file types with: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
64 :filetype plugin on |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
65 If filetype detection was not switched on yet, it will be as well. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
66 This actually loads the file "ftplugin.vim" in 'runtimepath'. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
67 The result is that when a file is edited its plugin file is loaded (if there |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
68 is one for the detected filetype). |filetype-plugin| |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
69 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
70 *:filetype-plugin-off* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
71 You can disable it again with: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
72 :filetype plugin off |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
73 The filetype detection is not switched off then. But if you do switch off |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
74 filetype detection, the plugins will not be loaded either. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
75 This actually loads the file "ftplugof.vim" in 'runtimepath'. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
76 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
77 *:filetype-indent-on* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
78 You can enable loading the indent file for specific file types with: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
79 :filetype indent on |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
80 If filetype detection was not switched on yet, it will be as well. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
81 This actually loads the file "indent.vim" in 'runtimepath'. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
82 The result is that when a file is edited its indent file is loaded (if there |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
83 is one for the detected filetype). |indent-expression| |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
84 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
85 *:filetype-indent-off* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
86 You can disable it again with: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
87 :filetype indent off |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
88 The filetype detection is not switched off then. But if you do switch off |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
89 filetype detection, the indent files will not be loaded either. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
90 This actually loads the file "indoff.vim" in 'runtimepath'. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
91 This disables auto-indenting for files you will open. It will keep working in |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
92 already opened files. Reset 'autoindent', 'cindent', 'smartindent' and/or |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
93 'indentexpr' to disable indenting in an opened file. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
94 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
95 *:filetype-off* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
96 To disable file type detection, use this command: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
97 :filetype off |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
98 This will keep the flags for "plugin" and "indent", but since no file types |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
99 are being detected, they won't work until the next ":filetype on". |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
100 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
101 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
102 Overview: *:filetype-overview* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
103 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
104 command detection plugin indent ~ |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
105 :filetype on on unchanged unchanged |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
106 :filetype off off unchanged unchanged |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
107 :filetype plugin on on on unchanged |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
108 :filetype plugin off unchanged off unchanged |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
109 :filetype indent on on unchanged on |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
110 :filetype indent off unchanged unchanged off |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
111 :filetype plugin indent on on on on |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
112 :filetype plugin indent off unchanged off off |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
113 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
114 To see the current status, type: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
115 :filetype |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
116 The output looks something like this: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
117 filetype detection:ON plugin:ON indent:OFF |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
118 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
119 The file types are also used for syntax highlighting. If the ":syntax on" |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
120 command is used, the file type detection is installed too. There is no need |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
121 to do ":filetype on" after ":syntax on". |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
122 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
123 To disable one of the file types, add a line in your filetype file, see |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
124 |remove-filetype|. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
125 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
126 *filetype-detect* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
127 To detect the file type again: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
128 :filetype detect |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
129 Use this if you started with an empty file and typed text that makes it |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
130 possible to detect the file type. For example, when you entered this in a |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
131 shell script: "#!/bin/csh". |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
132 When filetype detection was off, it will be enabled first, like the "on" |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
133 argument was used. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
134 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
135 *filetype-overrule* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
136 When the same extension is used for multiple filetypes, Vim tries to guess |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
137 what kind of file it is. This doesn't always work. A number of global |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
138 variables can be used to overrule the filetype used for certain extensions: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
139 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
140 file name variable ~ |
33245
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
141 *.asa g:filetype_asa |ft-aspperl-syntax| |
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
142 |ft-aspvbs-syntax| |
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
143 *.asm g:asmsyntax |ft-asm-syntax| |
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
144 *.asp g:filetype_asp |ft-aspperl-syntax| |
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
145 |ft-aspvbs-syntax| |
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
146 *.bas g:filetype_bas |ft-basic-syntax| |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
147 *.cfg g:filetype_cfg |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
148 *.cls g:filetype_cls |
33245
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
149 *.csh g:filetype_csh |ft-csh-syntax| |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
150 *.dat g:filetype_dat |
34092
ff27442e7851
patch 9.1.0013: Modula2 filetype support lacking
Christian Brabandt <cb@256bit.org>
parents:
34057
diff
changeset
|
151 *.def g:filetype_def |
33245
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
152 *.f g:filetype_f |ft-forth-syntax| |
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
153 *.frm g:filetype_frm |ft-form-syntax| |
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
154 *.fs g:filetype_fs |ft-forth-syntax| |
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
155 *.h g:c_syntax_for_h |ft-c-syntax| |
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
156 *.i g:filetype_i |ft-progress-syntax| |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
157 *.inc g:filetype_inc |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
158 *.lsl g:filetype_lsl |
33245
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
159 *.m g:filetype_m |ft-mathematica-syntax| |
34807
7f709fa537df
patch 9.1.0276: No pandoc syntax support
Christian Brabandt <cb@256bit.org>
parents:
34765
diff
changeset
|
160 *.markdown,*.mdown,*.mkd,*.mkdn,*.mdwn,*.md |
7f709fa537df
patch 9.1.0276: No pandoc syntax support
Christian Brabandt <cb@256bit.org>
parents:
34765
diff
changeset
|
161 g:filetype_md |ft-pandoc-syntax| |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
162 *.mod g:filetype_mod |
33245
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
163 *.p g:filetype_p |ft-pascal-syntax| |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
164 *.pl g:filetype_pl |
33245
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
165 *.pp g:filetype_pp |ft-pascal-syntax| |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
166 *.prg g:filetype_prg |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
167 *.r g:filetype_r |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
168 *.sig g:filetype_sig |
33245
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
169 *.sql g:filetype_sql |ft-sql-syntax| |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
170 *.src g:filetype_src |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
171 *.sys g:filetype_sys |
33245
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
172 *.sh g:bash_is_sh |ft-sh-syntax| |
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
173 *.tex g:tex_flavor |ft-tex-plugin| |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
174 *.typ g:filetype_typ |
34052
e2e9bb5496a5
runtime(dist/ft): improve filetype detection for *.v (V/Verilog/Coq)
Christian Brabandt <cb@256bit.org>
parents:
34016
diff
changeset
|
175 *.v g:filetype_v |
33245
485561aa8f1e
runtime(doc): Add g:c_syntax_for_h to filetype-overrule docs
Christian Brabandt <cb@256bit.org>
parents:
33203
diff
changeset
|
176 *.w g:filetype_w |ft-cweb-syntax| |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
177 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
178 For a few filetypes the global variable is used only when the filetype could |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
179 not be detected: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
180 *.r g:filetype_r |ft-rexx-syntax| |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
181 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
182 *filetype-ignore* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
183 To avoid that certain files are being inspected, the g:ft_ignore_pat variable |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
184 is used. The default value is set like this: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
185 :let g:ft_ignore_pat = '\.\(Z\|gz\|bz2\|zip\|tgz\)$' |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
186 This means that the contents of compressed files are not inspected. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
187 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
188 *new-filetype* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
189 If a file type that you want to use is not detected yet, there are four ways |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
190 to add it. In any way, it's better not to modify the $VIMRUNTIME/filetype.vim |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
191 file. It will be overwritten when installing a new version of Vim. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
192 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
193 A. If you want to overrule all default file type checks. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
194 This works by writing one file for each filetype. The disadvantage is that |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
195 there can be many files. The advantage is that you can simply drop this |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
196 file in the right directory to make it work. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
197 *ftdetect* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
198 1. Create your user runtime directory. You would normally use the first |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
199 item of the 'runtimepath' option. Then create the directory "ftdetect" |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
200 inside it. Example for Unix: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
201 :!mkdir ~/.vim |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
202 :!mkdir ~/.vim/ftdetect |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
203 < |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
204 2. Create a file that contains an autocommand to detect the file type. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
205 Example: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
206 au BufRead,BufNewFile *.mine set filetype=mine |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
207 < Note that there is no "augroup" command, this has already been done |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
208 when sourcing your file. You could also use the pattern "*" and then |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
209 check the contents of the file to recognize it. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
210 Write this file as "mine.vim" in the "ftdetect" directory in your user |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
211 runtime directory. For example, for Unix: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
212 :w ~/.vim/ftdetect/mine.vim |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
213 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
214 < 3. To use the new filetype detection you must restart Vim. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
215 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
216 The files in the "ftdetect" directory are used after all the default |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
217 checks, thus they can overrule a previously detected file type. But you |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
218 can also use |:setfiletype| to keep a previously detected filetype. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
219 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
220 B. If you want to detect your file after the default file type checks. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
221 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
222 This works like A above, but instead of setting 'filetype' unconditionally |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
223 use ":setfiletype". This will only set 'filetype' if no file type was |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
224 detected yet. Example: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
225 au BufRead,BufNewFile *.txt setfiletype text |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
226 < |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
227 You can also use the already detected file type in your command. For |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
228 example, to use the file type "mypascal" when "pascal" has been detected: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
229 au BufRead,BufNewFile * if &ft == 'pascal' | set ft=mypascal |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
230 | endif |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
231 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
232 C. If your file type can be detected by the file name. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
233 1. Create your user runtime directory. You would normally use the first |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
234 item of the 'runtimepath' option. Example for Unix: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
235 :!mkdir ~/.vim |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
236 < |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
237 2. Create a file that contains autocommands to detect the file type. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
238 Example: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
239 " my filetype file |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
240 if exists("did_load_filetypes") |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
241 finish |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
242 endif |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
243 augroup filetypedetect |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
244 au! BufRead,BufNewFile *.mine setfiletype mine |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
245 au! BufRead,BufNewFile *.xyz setfiletype drawing |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
246 augroup END |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
247 < Write this file as "filetype.vim" in your user runtime directory. For |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
248 example, for Unix: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
249 :w ~/.vim/filetype.vim |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
250 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
251 < 3. To use the new filetype detection you must restart Vim. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
252 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
253 Your filetype.vim will be sourced before the default FileType autocommands |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
254 have been installed. Your autocommands will match first, and the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
255 ":setfiletype" command will make sure that no other autocommands will set |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
256 'filetype' after this. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
257 *new-filetype-scripts* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
258 D. If your filetype can only be detected by inspecting the contents of the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
259 file. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
260 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
261 1. Create your user runtime directory. You would normally use the first |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
262 item of the 'runtimepath' option. Example for Unix: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
263 :!mkdir ~/.vim |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
264 < |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
265 2. Create a vim script file for doing this. Example: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
266 if did_filetype() " filetype already set.. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
267 finish " ..don't do these checks |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
268 endif |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
269 if getline(1) =~ '^#!.*\<mine\>' |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
270 setfiletype mine |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
271 elseif getline(1) =~? '\<drawing\>' |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
272 setfiletype drawing |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
273 endif |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
274 < See $VIMRUNTIME/scripts.vim for more examples. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
275 Write this file as "scripts.vim" in your user runtime directory. For |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
276 example, for Unix: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
277 :w ~/.vim/scripts.vim |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
278 < |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
279 3. The detection will work right away, no need to restart Vim. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
280 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
281 Your scripts.vim is loaded before the default checks for file types, which |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
282 means that your rules override the default rules in |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
283 $VIMRUNTIME/scripts.vim. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
284 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
285 *remove-filetype* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
286 If a file type is detected that is wrong for you, install a filetype.vim or |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
287 scripts.vim to catch it (see above). You can set 'filetype' to a non-existing |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
288 name to avoid that it will be set later anyway: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
289 :set filetype=ignored |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
290 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
291 If you are setting up a system with many users, and you don't want each user |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
292 to add/remove the same filetypes, consider writing the filetype.vim and |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
293 scripts.vim files in a runtime directory that is used for everybody. Check |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
294 the 'runtimepath' for a directory to use. If there isn't one, set |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
295 'runtimepath' in the |system-vimrc|. Be careful to keep the default |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
296 directories! |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
297 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
298 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
299 *autocmd-osfiletypes* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
300 NOTE: this code is currently disabled, as the RISC OS implementation was |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
301 removed. In the future this will use the 'filetype' option. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
302 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
303 On operating systems which support storing a file type with the file, you can |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
304 specify that an autocommand should only be executed if the file is of a |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
305 certain type. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
306 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
307 The actual type checking depends on which platform you are running Vim |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
308 on; see your system's documentation for details. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
309 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
310 To use osfiletype checking in an autocommand you should put a list of types to |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
311 match in angle brackets in place of a pattern, like this: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
312 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
313 :au BufRead *.html,<&faf;HTML> runtime! syntax/html.vim |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
314 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
315 This will match: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
316 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
317 - Any file whose name ends in ".html" |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
318 - Any file whose type is "&faf" or "HTML", where the meaning of these types |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
319 depends on which version of Vim you are using. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
320 Unknown types are considered NOT to match. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
321 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
322 You can also specify a type and a pattern at the same time (in which case they |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
323 must both match): > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
324 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
325 :au BufRead <&fff>diff* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
326 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
327 This will match files of type "&fff" whose names start with "diff". |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
328 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
329 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
330 *plugin-details* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
331 The "plugin" directory can be in any of the directories in the 'runtimepath' |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
332 option. All of these directories will be searched for plugins and they are |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
333 all loaded. For example, if this command: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
334 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
335 set runtimepath |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
336 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
337 produces this output: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
338 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
339 runtimepath=/etc/vim,~/.vim,/usr/local/share/vim/vim82 ~ |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
340 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
341 then Vim will load all plugins in these directories and below: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
342 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
343 /etc/vim/plugin/ ~ |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
344 ~/.vim/plugin/ ~ |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
345 /usr/local/share/vim/vim82/plugin/ ~ |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
346 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
347 Note that the last one is the value of $VIMRUNTIME which has been expanded. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
348 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
349 Note that when using a plugin manager or |packages| many directories will be |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
350 added to 'runtimepath'. These plugins each require their own directory, don't |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
351 put them directly in ~/.vim/plugin. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
352 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
353 What if it looks like your plugin is not being loaded? You can find out what |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
354 happens when Vim starts up by using the |-V| argument: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
355 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
356 vim -V2 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
357 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
358 You will see a lot of messages, in between them is a remark about loading the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
359 plugins. It starts with: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
360 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
361 Searching for "plugin/**/*.vim" in ~ |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
362 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
363 There you can see where Vim looks for your plugin scripts. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
364 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
365 ============================================================================== |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
366 2. Filetype plugin *filetype-plugins* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
367 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
368 When loading filetype plugins has been enabled |:filetype-plugin-on|, options |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
369 will be set and mappings defined. These are all local to the buffer, they |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
370 will not be used for other files. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
371 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
372 Defining mappings for a filetype may get in the way of the mappings you |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
373 define yourself. There are a few ways to avoid this: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
374 1. Set the "maplocalleader" variable to the key sequence you want the mappings |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
375 to start with. Example: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
376 :let maplocalleader = "," |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
377 < All mappings will then start with a comma instead of the default, which |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
378 is a backslash. Also see |<LocalLeader>|. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
379 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
380 2. Define your own mapping. Example: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
381 :map ,p <Plug>MailQuote |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
382 < You need to check the description of the plugin file below for the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
383 functionality it offers and the string to map to. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
384 You need to define your own mapping before the plugin is loaded (before |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
385 editing a file of that type). The plugin will then skip installing the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
386 default mapping. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
387 *no_mail_maps* *g:no_mail_maps* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
388 3. Disable defining mappings for a specific filetype by setting a variable, |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
389 which contains the name of the filetype. For the "mail" filetype this |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
390 would be: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
391 :let no_mail_maps = 1 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
392 < *no_plugin_maps* *g:no_plugin_maps* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
393 4. Disable defining mappings for all filetypes by setting a variable: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
394 :let no_plugin_maps = 1 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
395 < |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
396 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
397 *ftplugin-overrule* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
398 If a global filetype plugin does not do exactly what you want, there are three |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
399 ways to change this: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
400 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
401 1. Add a few settings. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
402 You must create a new filetype plugin in a directory early in |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
403 'runtimepath'. For Unix, for example you could use this file: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
404 vim ~/.vim/ftplugin/fortran.vim |
32708
346703c4ddd1
Fix alignment in filetype.txt (#12618)
Christian Brabandt <cb@256bit.org>
parents:
32670
diff
changeset
|
405 < You can set those settings and mappings that you would like to add. Note |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
406 that the global plugin will be loaded after this, it may overrule the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
407 settings that you do here. If this is the case, you need to use one of the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
408 following two methods. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
409 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
410 2. Make a copy of the plugin and change it. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
411 You must put the copy in a directory early in 'runtimepath'. For Unix, for |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
412 example, you could do this: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
413 cp $VIMRUNTIME/ftplugin/fortran.vim ~/.vim/ftplugin/fortran.vim |
32708
346703c4ddd1
Fix alignment in filetype.txt (#12618)
Christian Brabandt <cb@256bit.org>
parents:
32670
diff
changeset
|
414 < Then you can edit the copied file to your liking. Since the b:did_ftplugin |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
415 variable will be set, the global plugin will not be loaded. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
416 A disadvantage of this method is that when the distributed plugin gets |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
417 improved, you will have to copy and modify it again. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
418 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
419 3. Overrule the settings after loading the global plugin. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
420 You must create a new filetype plugin in a directory from the end of |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
421 'runtimepath'. For Unix, for example, you could use this file: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
422 vim ~/.vim/after/ftplugin/fortran.vim |
32708
346703c4ddd1
Fix alignment in filetype.txt (#12618)
Christian Brabandt <cb@256bit.org>
parents:
32670
diff
changeset
|
423 < In this file you can change just those settings that you want to change. |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
424 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
425 ============================================================================== |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
426 3. Docs for the default filetype plugins. *ftplugin-docs* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
427 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
428 |
33203
c3c347a71e05
runtime: don't execute external commands when loading ftplugins
Christian Brabandt <cb@256bit.org>
parents:
32945
diff
changeset
|
429 *plugin_exec* *g:plugin_exec* |
c3c347a71e05
runtime: don't execute external commands when loading ftplugins
Christian Brabandt <cb@256bit.org>
parents:
32945
diff
changeset
|
430 Enable executing of external commands. This was done historically for e.g. |
c3c347a71e05
runtime: don't execute external commands when loading ftplugins
Christian Brabandt <cb@256bit.org>
parents:
32945
diff
changeset
|
431 the perl filetype plugin (and a few others) to set the search path. |
c3c347a71e05
runtime: don't execute external commands when loading ftplugins
Christian Brabandt <cb@256bit.org>
parents:
32945
diff
changeset
|
432 Disabled by default for security reasons: > |
c3c347a71e05
runtime: don't execute external commands when loading ftplugins
Christian Brabandt <cb@256bit.org>
parents:
32945
diff
changeset
|
433 :let g:plugin_exec = 1 |
c3c347a71e05
runtime: don't execute external commands when loading ftplugins
Christian Brabandt <cb@256bit.org>
parents:
32945
diff
changeset
|
434 It is also possible to enable this only for certain filetypes: > |
c3c347a71e05
runtime: don't execute external commands when loading ftplugins
Christian Brabandt <cb@256bit.org>
parents:
32945
diff
changeset
|
435 :let g:<filetype>_exec = 1 |
c3c347a71e05
runtime: don't execute external commands when loading ftplugins
Christian Brabandt <cb@256bit.org>
parents:
32945
diff
changeset
|
436 So to enable this only for ruby, set the following variable: > |
c3c347a71e05
runtime: don't execute external commands when loading ftplugins
Christian Brabandt <cb@256bit.org>
parents:
32945
diff
changeset
|
437 :let g:ruby_exec = 1 |
c3c347a71e05
runtime: don't execute external commands when loading ftplugins
Christian Brabandt <cb@256bit.org>
parents:
32945
diff
changeset
|
438 |
c3c347a71e05
runtime: don't execute external commands when loading ftplugins
Christian Brabandt <cb@256bit.org>
parents:
32945
diff
changeset
|
439 If both, the global `plugin_exec` and the `<filetype>_exec` specific variable |
33434
484543479bd7
runtime(doc): fix typos.
Christian Brabandt <cb@256bit.org>
parents:
33245
diff
changeset
|
440 are set, the filetype specific variable should have precedent. |
33203
c3c347a71e05
runtime: don't execute external commands when loading ftplugins
Christian Brabandt <cb@256bit.org>
parents:
32945
diff
changeset
|
441 |
34765
63dcbb94eefb
runtime(doc): sort filetype.txt in the alphabetical order (#14395)
Christian Brabandt <cb@256bit.org>
parents:
34429
diff
changeset
|
442 |
63dcbb94eefb
runtime(doc): sort filetype.txt in the alphabetical order (#14395)
Christian Brabandt <cb@256bit.org>
parents:
34429
diff
changeset
|
443 ASCIIDOC *ft-asciidoc-plugin* |
63dcbb94eefb
runtime(doc): sort filetype.txt in the alphabetical order (#14395)
Christian Brabandt <cb@256bit.org>
parents:
34429
diff
changeset
|
444 |
63dcbb94eefb
runtime(doc): sort filetype.txt in the alphabetical order (#14395)
Christian Brabandt <cb@256bit.org>
parents:
34429
diff
changeset
|
445 To enable |folding| use this: > |
63dcbb94eefb
runtime(doc): sort filetype.txt in the alphabetical order (#14395)
Christian Brabandt <cb@256bit.org>
parents:
34429
diff
changeset
|
446 let g:asciidoc_folding = 1 |
63dcbb94eefb
runtime(doc): sort filetype.txt in the alphabetical order (#14395)
Christian Brabandt <cb@256bit.org>
parents:
34429
diff
changeset
|
447 |
63dcbb94eefb
runtime(doc): sort filetype.txt in the alphabetical order (#14395)
Christian Brabandt <cb@256bit.org>
parents:
34429
diff
changeset
|
448 To disable nesting of folded headers use this: > |
63dcbb94eefb
runtime(doc): sort filetype.txt in the alphabetical order (#14395)
Christian Brabandt <cb@256bit.org>
parents:
34429
diff
changeset
|
449 let g:asciidoc_foldnested = 0 |
63dcbb94eefb
runtime(doc): sort filetype.txt in the alphabetical order (#14395)
Christian Brabandt <cb@256bit.org>
parents:
34429
diff
changeset
|
450 |
63dcbb94eefb
runtime(doc): sort filetype.txt in the alphabetical order (#14395)
Christian Brabandt <cb@256bit.org>
parents:
34429
diff
changeset
|
451 To disable folding everything under the title use this: > |
63dcbb94eefb
runtime(doc): sort filetype.txt in the alphabetical order (#14395)
Christian Brabandt <cb@256bit.org>
parents:
34429
diff
changeset
|
452 let asciidoc_fold_under_title = 0 |
63dcbb94eefb
runtime(doc): sort filetype.txt in the alphabetical order (#14395)
Christian Brabandt <cb@256bit.org>
parents:
34429
diff
changeset
|
453 |
63dcbb94eefb
runtime(doc): sort filetype.txt in the alphabetical order (#14395)
Christian Brabandt <cb@256bit.org>
parents:
34429
diff
changeset
|
454 |
35219
82cc33448f6b
runtime(arduino): Add Arduino ftplugin and indent files (#14811)
Christian Brabandt <cb@256bit.org>
parents:
34997
diff
changeset
|
455 ARDUINO *ft-arduino-plugin* |
82cc33448f6b
runtime(arduino): Add Arduino ftplugin and indent files (#14811)
Christian Brabandt <cb@256bit.org>
parents:
34997
diff
changeset
|
456 |
82cc33448f6b
runtime(arduino): Add Arduino ftplugin and indent files (#14811)
Christian Brabandt <cb@256bit.org>
parents:
34997
diff
changeset
|
457 By default the following options are set, in accordance with the default |
82cc33448f6b
runtime(arduino): Add Arduino ftplugin and indent files (#14811)
Christian Brabandt <cb@256bit.org>
parents:
34997
diff
changeset
|
458 settings of Arduino IDE: > |
82cc33448f6b
runtime(arduino): Add Arduino ftplugin and indent files (#14811)
Christian Brabandt <cb@256bit.org>
parents:
34997
diff
changeset
|
459 |
82cc33448f6b
runtime(arduino): Add Arduino ftplugin and indent files (#14811)
Christian Brabandt <cb@256bit.org>
parents:
34997
diff
changeset
|
460 setlocal expandtab tabstop=2 softtabstop=2 shiftwidth=2 |
82cc33448f6b
runtime(arduino): Add Arduino ftplugin and indent files (#14811)
Christian Brabandt <cb@256bit.org>
parents:
34997
diff
changeset
|
461 |
82cc33448f6b
runtime(arduino): Add Arduino ftplugin and indent files (#14811)
Christian Brabandt <cb@256bit.org>
parents:
34997
diff
changeset
|
462 To disable this behavior, set the following variable in your vimrc: > |
82cc33448f6b
runtime(arduino): Add Arduino ftplugin and indent files (#14811)
Christian Brabandt <cb@256bit.org>
parents:
34997
diff
changeset
|
463 |
82cc33448f6b
runtime(arduino): Add Arduino ftplugin and indent files (#14811)
Christian Brabandt <cb@256bit.org>
parents:
34997
diff
changeset
|
464 let g:arduino_recommended_style = 0 |
82cc33448f6b
runtime(arduino): Add Arduino ftplugin and indent files (#14811)
Christian Brabandt <cb@256bit.org>
parents:
34997
diff
changeset
|
465 |
82cc33448f6b
runtime(arduino): Add Arduino ftplugin and indent files (#14811)
Christian Brabandt <cb@256bit.org>
parents:
34997
diff
changeset
|
466 |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
467 AWK *ft-awk-plugin* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
468 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
469 Support for features specific to GNU Awk, like @include, can be enabled by |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
470 setting: > |
33203
c3c347a71e05
runtime: don't execute external commands when loading ftplugins
Christian Brabandt <cb@256bit.org>
parents:
32945
diff
changeset
|
471 :let g:awk_is_gawk = 1 |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
472 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
473 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
474 CHANGELOG *ft-changelog-plugin* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
475 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
476 Allows for easy entrance of Changelog entries in Changelog files. There are |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
477 some commands, mappings, and variables worth exploring: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
478 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
479 Options: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
480 'comments' is made empty to not mess up formatting. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
481 'textwidth' is set to 78, which is standard. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
482 'formatoptions' the 't' flag is added to wrap when inserting text. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
483 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
484 Commands: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
485 NewChangelogEntry Adds a new Changelog entry in an intelligent fashion |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
486 (see below). |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
487 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
488 Local mappings: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
489 <Leader>o Starts a new Changelog entry in an equally intelligent |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
490 fashion (see below). |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
491 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
492 Global mappings: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
493 NOTE: The global mappings are accessed by sourcing the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
494 ftplugin/changelog.vim file first, e.g. with > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
495 runtime ftplugin/changelog.vim |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
496 < in your |.vimrc|. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
497 <Leader>o Switches to the ChangeLog buffer opened for the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
498 current directory, or opens it in a new buffer if it |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
499 exists in the current directory. Then it does the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
500 same as the local <Leader>o described above. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
501 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
502 Variables: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
503 g:changelog_timeformat Deprecated; use g:changelog_dateformat instead. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
504 g:changelog_dateformat The date (and time) format used in ChangeLog entries. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
505 The format accepted is the same as for the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
506 |strftime()| function. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
507 The default is "%Y-%m-%d" which is the standard format |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
508 for many ChangeLog layouts. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
509 g:changelog_username The name and email address of the user. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
510 The default is deduced from environment variables and |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
511 system files. It searches /etc/passwd for the comment |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
512 part of the current user, which informally contains |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
513 the real name of the user up to the first separating |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
514 comma. then it checks the $NAME environment variable |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
515 and finally runs `whoami` and `hostname` to build an |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
516 email address. The final form is > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
517 Full Name <user@host> |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
518 < |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
519 g:changelog_new_date_format |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
520 The format to use when creating a new date-entry. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
521 The following table describes special tokens in the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
522 string: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
523 %% insert a single '%' character |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
524 %d insert the date from above |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
525 %u insert the user from above |
34429
a0754587f167
runtime(doc): fix inconsistent indent (#14089)
Christian Brabandt <cb@256bit.org>
parents:
34358
diff
changeset
|
526 %p insert result of b:changelog_entry_prefix |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
527 %c where to position cursor when done |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
528 The default is "%d %u\n\n\t* %p%c\n\n", which produces |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
529 something like (| is where cursor will be, unless at |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
530 the start of the line where it denotes the beginning |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
531 of the line) > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
532 |2003-01-14 Full Name <user@host> |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
533 | |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
534 | * prefix| |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
535 < |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
536 g:changelog_new_entry_format |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
537 The format used when creating a new entry. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
538 The following table describes special tokens in the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
539 string: |
34429
a0754587f167
runtime(doc): fix inconsistent indent (#14089)
Christian Brabandt <cb@256bit.org>
parents:
34358
diff
changeset
|
540 %p insert result of b:changelog_entry_prefix |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
541 %c where to position cursor when done |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
542 The default is "\t*%c", which produces something |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
543 similar to > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
544 | * prefix| |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
545 < |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
546 g:changelog_date_entry_search |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
547 The search pattern to use when searching for a |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
548 date-entry. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
549 The same tokens that can be used for |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
550 g:changelog_new_date_format can be used here as well. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
551 The default is '^\s*%d\_s*%u' which finds lines |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
552 matching the form > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
553 |2003-01-14 Full Name <user@host> |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
554 < and some similar formats. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
555 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
556 g:changelog_date_end_entry_search |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
557 The search pattern to use when searching for the end |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
558 of a date-entry. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
559 The same tokens that can be used for |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
560 g:changelog_new_date_format can be used here as well. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
561 The default is '^\s*$' which finds lines that contain |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
562 only whitespace or are completely empty. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
563 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
564 b:changelog_name *b:changelog_name* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
565 Name of the ChangeLog file to look for. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
566 The default is 'ChangeLog'. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
567 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
568 b:changelog_path |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
569 Path of the ChangeLog to use for the current buffer. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
570 The default is empty, thus looking for a file named |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
571 |b:changelog_name| in the same directory as the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
572 current buffer. If not found, the parent directory of |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
573 the current buffer is searched. This continues |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
574 recursively until a file is found or there are no more |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
575 parent directories to search. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
576 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
577 b:changelog_entry_prefix |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
578 Name of a function to call to generate a prefix to a |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
579 new entry. This function takes no arguments and |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
580 should return a string containing the prefix. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
581 Returning an empty prefix is fine. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
582 The default generates the shortest path between the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
583 ChangeLog's pathname and the current buffers pathname. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
584 In the future, it will also be possible to use other |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
585 variable contexts for this variable, for example, g:. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
586 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
587 The Changelog entries are inserted where they add the least amount of text. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
588 After figuring out the current date and user, the file is searched for an |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
589 entry beginning with the current date and user and if found adds another item |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
590 under it. If not found, a new entry and item is prepended to the beginning of |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
591 the Changelog. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
592 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
593 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
594 FORTRAN *ft-fortran-plugin* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
595 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
596 Options: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
597 'expandtab' is switched on to avoid tabs as required by the Fortran |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
598 standards unless the user has set fortran_have_tabs in .vimrc. |
33894
cf2ae76cbbf7
runtime(fortran): update syntax and ftplugins
Christian Brabandt <cb@256bit.org>
parents:
33434
diff
changeset
|
599 'textwidth' is set to 80 for fixed source format whereas it is set to 132 |
cf2ae76cbbf7
runtime(fortran): update syntax and ftplugins
Christian Brabandt <cb@256bit.org>
parents:
33434
diff
changeset
|
600 for free source format. Setting the fortran_extended_line_length |
cf2ae76cbbf7
runtime(fortran): update syntax and ftplugins
Christian Brabandt <cb@256bit.org>
parents:
33434
diff
changeset
|
601 variable increases the width to 132 for fixed source format. |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
602 'formatoptions' is set to break code and comment lines and to preserve long |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
603 lines. You can format comments with |gq|. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
604 For further discussion of fortran_have_tabs and the method used for the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
605 detection of source format see |ft-fortran-syntax|. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
606 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
607 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
608 FREEBASIC *ft-freebasic-plugin* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
609 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
610 This plugin aims to treat the four FreeBASIC dialects, "fb", "qb", "fblite" |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
611 and "deprecated", as distinct languages. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
612 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
613 The dialect will be set to the first name found in g:freebasic_forcelang, any |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
614 #lang directive or $lang metacommand in the file being edited, or finally |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
615 g:freebasic_lang. These global variables conceptually map to the fbc options |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
616 -forcelang and -lang. If no dialect is explicitly specified "fb" will be |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
617 used. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
618 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
619 For example, to set the dialect to a default of "fblite" but still allow for |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
620 any #lang directive overrides, use the following command: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
621 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
622 let g:freebasic_lang = "fblite" |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
623 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
624 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
625 GIT COMMIT *ft-gitcommit-plugin* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
626 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
627 One command, :DiffGitCached, is provided to show a diff of the current commit |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
628 in the preview window. It is equivalent to calling "git diff --cached" plus |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
629 any arguments given to the command. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
630 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
631 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
632 GPROF *ft-gprof-plugin* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
633 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
634 The gprof filetype plugin defines a mapping <C-]> to jump from a function |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
635 entry in the gprof flat profile or from a function entry in the call graph |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
636 to the details of that function in the call graph. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
637 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
638 The mapping can be disabled with: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
639 let g:no_gprof_maps = 1 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
640 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
641 |
34997
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
642 JAVA *ft-java-plugin* |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
643 |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
644 Whenever the variable "g:ftplugin_java_source_path" is defined and its value |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
645 is a filename whose extension is either ".jar" or ".zip", e.g.: > |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
646 let g:ftplugin_java_source_path = '/path/to/src.jar' |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
647 let g:ftplugin_java_source_path = '/path/to/src.zip' |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
648 < |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
649 and the |zip| plugin has already been sourced, the |gf| command can be used to |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
650 open the archive and the |n| command can be used to look for the selected type |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
651 and the <Return> key can be used to load a listed file. |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
652 |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
653 Note that the effect of using the "gf" command WITHIN a buffer loaded with the |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
654 Zip plugin depends on the version of the Zip plugin. For the Zip plugin |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
655 versions that do not support Jar type archives, consider creating symbolic |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
656 links with the ".zip" extension for each Jar archive of interest and assigning |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
657 any such file to the variable from now on. |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
658 |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
659 Otherwise, for the defined variable "g:ftplugin_java_source_path", the local |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
660 value of the 'path' option will be further modified by prefixing the value of |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
661 the variable, e.g.: > |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
662 let g:ftplugin_java_source_path = $JDK_SRC_PATH |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
663 let &l:path = g:ftplugin_java_source_path . ',' . &l:path |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
664 < |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
665 and the "gf" command can be used on a fully-qualified type to look for a file |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
666 in the "path" and to try to load it. |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
667 |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
668 Remember to manually trigger the |FileType| event from a buffer with a Java |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
669 file loaded in it each time after assigning a new value to the variable: > |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
670 doautocmd FileType |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
671 < |
6130f51d7db3
runtime(java): Support "g:ftplugin_java_source_path" with archived files
Christian Brabandt <cb@256bit.org>
parents:
34822
diff
changeset
|
672 |
33904
c2955068ea16
runtime(json): Add json formating plugin (Issue #11426) (#11506)
Christian Brabandt <cb@256bit.org>
parents:
33894
diff
changeset
|
673 JSON-FORMAT *ft-json-plugin* |
c2955068ea16
runtime(json): Add json formating plugin (Issue #11426) (#11506)
Christian Brabandt <cb@256bit.org>
parents:
33894
diff
changeset
|
674 |
c2955068ea16
runtime(json): Add json formating plugin (Issue #11426) (#11506)
Christian Brabandt <cb@256bit.org>
parents:
33894
diff
changeset
|
675 JSON filetype can be extended to use 'formatexpr' and "json.FormatExpr()" |
c2955068ea16
runtime(json): Add json formating plugin (Issue #11426) (#11506)
Christian Brabandt <cb@256bit.org>
parents:
33894
diff
changeset
|
676 function for json formatting (using |gq|). |
c2955068ea16
runtime(json): Add json formating plugin (Issue #11426) (#11506)
Christian Brabandt <cb@256bit.org>
parents:
33894
diff
changeset
|
677 |
c2955068ea16
runtime(json): Add json formating plugin (Issue #11426) (#11506)
Christian Brabandt <cb@256bit.org>
parents:
33894
diff
changeset
|
678 Add following lines to $HOME/.vim/ftplugin/json.vim: > |
c2955068ea16
runtime(json): Add json formating plugin (Issue #11426) (#11506)
Christian Brabandt <cb@256bit.org>
parents:
33894
diff
changeset
|
679 |
c2955068ea16
runtime(json): Add json formating plugin (Issue #11426) (#11506)
Christian Brabandt <cb@256bit.org>
parents:
33894
diff
changeset
|
680 vim9script |
c2955068ea16
runtime(json): Add json formating plugin (Issue #11426) (#11506)
Christian Brabandt <cb@256bit.org>
parents:
33894
diff
changeset
|
681 import autoload 'dist/json.vim' |
c2955068ea16
runtime(json): Add json formating plugin (Issue #11426) (#11506)
Christian Brabandt <cb@256bit.org>
parents:
33894
diff
changeset
|
682 setl formatexpr=json.FormatExpr() |
c2955068ea16
runtime(json): Add json formating plugin (Issue #11426) (#11506)
Christian Brabandt <cb@256bit.org>
parents:
33894
diff
changeset
|
683 |
c2955068ea16
runtime(json): Add json formating plugin (Issue #11426) (#11506)
Christian Brabandt <cb@256bit.org>
parents:
33894
diff
changeset
|
684 |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
685 MAIL *ft-mail-plugin* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
686 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
687 Options: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
688 'modeline' is switched off to avoid the danger of trojan horses, and to |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
689 avoid that a Subject line with "Vim:" in it will cause an |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
690 error message. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
691 'textwidth' is set to 72. This is often recommended for e-mail. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
692 'formatoptions' is set to break text lines and to repeat the comment leader |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
693 in new lines, so that a leading ">" for quotes is repeated. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
694 You can also format quoted text with |gq|. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
695 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
696 Local mappings: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
697 <LocalLeader>q or \\MailQuote |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
698 Quotes the text selected in Visual mode, or from the cursor position |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
699 to the end of the file in Normal mode. This means "> " is inserted in |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
700 each line. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
701 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
702 MAN *ft-man-plugin* *:Man* *man.vim* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
703 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
704 This plugin displays a manual page in a nice way. See |find-manpage| in the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
705 user manual for more information. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
706 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
707 To start using the |:Man| command before any manual page has been loaded, |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
708 source this script from your startup |vimrc| file: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
709 runtime ftplugin/man.vim |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
710 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
711 Options: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
712 'iskeyword' The '.' character is added to support the use of CTRL-] on the |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
713 manual page name. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
714 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
715 Commands: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
716 Man {name} Display the manual page for {name} in a window. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
717 Man {number} {name} |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
718 Display the manual page for {name} in a section {number}. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
719 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
720 Global mapping: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
721 <Leader>K Displays the manual page for the word under the cursor. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
722 <Plug>ManPreGetPage |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
723 idem, allows for using a mapping: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
724 nmap <F1> <Plug>ManPreGetPage |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
725 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
726 Local mappings: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
727 CTRL-] Jump to the manual page for the word under the cursor. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
728 CTRL-T Jump back to the previous manual page. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
729 q Same as the |:quit| command. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
730 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
731 To use a vertical split instead of horizontal: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
732 let g:ft_man_open_mode = 'vert' |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
733 To use a new tab: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
734 let g:ft_man_open_mode = 'tab' |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
735 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
736 To enable |folding|, use this: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
737 let g:ft_man_folding_enable = 1 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
738 If you do not like the default folding, use an |autocommand| to add your desired |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
739 folding style instead. For example: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
740 autocmd FileType man setlocal foldmethod=indent foldenable |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
741 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
742 If you would like :Man {number} {name} to behave like man {number} {name} by |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
743 not running man {name} if no page is found, then use this: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
744 let g:ft_man_no_sect_fallback = 1 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
745 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
746 You may also want to set 'keywordprg' to make the |K| command open a manual |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
747 page in a Vim window: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
748 set keywordprg=:Man |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
749 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
750 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
751 MANPAGER *manpager.vim* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
752 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
753 The |:Man| command allows you to turn Vim into a manpager (that syntax |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
754 highlights manpages and follows linked manpages on hitting CTRL-]). |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
755 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
756 For bash,zsh,ksh or dash, add to the config file (.bashrc,.zshrc, ...) |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
757 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
758 export MANPAGER="vim +MANPAGER --not-a-term -" |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
759 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
760 For (t)csh, add to the config file |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
761 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
762 setenv MANPAGER "vim +MANPAGER --not-a-term -" |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
763 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
764 For fish, add to the config file |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
765 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
766 set -x MANPAGER "vim +MANPAGER --not-a-term -" |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
767 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
768 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
769 MARKDOWN *ft-markdown-plugin* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
770 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
771 To enable folding use this: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
772 let g:markdown_folding = 1 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
773 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
774 'expandtab' will be set by default. If you do not want that use this: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
775 let g:markdown_recommended_style = 0 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
776 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
777 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
778 PDF *ft-pdf-plugin* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
779 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
780 Two maps, <C-]> and <C-T>, are provided to simulate a tag stack for navigating |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
781 the PDF. The following are treated as tags: |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
782 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
783 - The byte offset after "startxref" to the xref table |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
784 - The byte offset after the /Prev key in the trailer to an earlier xref table |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
785 - A line of the form "0123456789 00000 n" in the xref table |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
786 - An object reference like "1 0 R" anywhere in the PDF |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
787 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
788 These maps can be disabled with > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
789 :let g:no_pdf_maps = 1 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
790 < |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
791 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
792 PYTHON *ft-python-plugin* *PEP8* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
793 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
794 By default the following options are set, in accordance with PEP8: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
795 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
796 setlocal expandtab shiftwidth=4 softtabstop=4 tabstop=8 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
797 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
798 To disable this behavior, set the following variable in your vimrc: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
799 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
800 let g:python_recommended_style = 0 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
801 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
802 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
803 QF QUICKFIX *qf.vim* *ft-qf-plugin* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
804 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
805 The "qf" filetype is used for the quickfix window, see |quickfix-window|. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
806 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
807 The quickfix filetype plugin includes configuration for displaying the command |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
808 that produced the quickfix list in the |status-line|. To disable this setting, |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
809 configure as follows: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
810 :let g:qf_disable_statusline = 1 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
811 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
812 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
813 R MARKDOWN *ft-rmd-plugin* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
814 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
815 By default ftplugin/html.vim is not sourced. If you want it sourced, add to |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
816 your |vimrc|: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
817 let rmd_include_html = 1 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
818 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
819 The 'formatexpr' option is set dynamically with different values for R code |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
820 and for Markdown code. If you prefer that 'formatexpr' is not set, add to your |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
821 |vimrc|: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
822 let rmd_dynamic_comments = 0 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
823 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
824 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
825 R RESTRUCTURED TEXT *ft-rrst-plugin* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
826 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
827 The 'formatexpr' option is set dynamically with different values for R code |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
828 and for ReStructured text. If you prefer that 'formatexpr' is not set, add to |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
829 your |vimrc|: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
830 let rrst_dynamic_comments = 0 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
831 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
832 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
833 RESTRUCTUREDTEXT *ft-rst-plugin* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
834 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
835 The following formatting setting are optionally available: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
836 setlocal expandtab shiftwidth=3 softtabstop=3 tabstop=8 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
837 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
838 To enable this behavior, set the following variable in your vimrc: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
839 let g:rst_style = 1 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
840 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
841 |
34016
34f6f3678cae
runtime(r): Update R runtime files and docs (#13757)
Christian Brabandt <cb@256bit.org>
parents:
33904
diff
changeset
|
842 RNOWEB *ft-rnoweb-plugin* |
34f6f3678cae
runtime(r): Update R runtime files and docs (#13757)
Christian Brabandt <cb@256bit.org>
parents:
33904
diff
changeset
|
843 |
34f6f3678cae
runtime(r): Update R runtime files and docs (#13757)
Christian Brabandt <cb@256bit.org>
parents:
33904
diff
changeset
|
844 The 'formatexpr' option is set dynamically with different values for R code |
34f6f3678cae
runtime(r): Update R runtime files and docs (#13757)
Christian Brabandt <cb@256bit.org>
parents:
33904
diff
changeset
|
845 and for LaTeX code. If you prefer that 'formatexpr' is not set, add to your |
34f6f3678cae
runtime(r): Update R runtime files and docs (#13757)
Christian Brabandt <cb@256bit.org>
parents:
33904
diff
changeset
|
846 |vimrc|: > |
34f6f3678cae
runtime(r): Update R runtime files and docs (#13757)
Christian Brabandt <cb@256bit.org>
parents:
33904
diff
changeset
|
847 let rnw_dynamic_comments = 0 |
34f6f3678cae
runtime(r): Update R runtime files and docs (#13757)
Christian Brabandt <cb@256bit.org>
parents:
33904
diff
changeset
|
848 |
34f6f3678cae
runtime(r): Update R runtime files and docs (#13757)
Christian Brabandt <cb@256bit.org>
parents:
33904
diff
changeset
|
849 |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
850 RPM SPEC *ft-spec-plugin* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
851 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
852 Since the text for this plugin is rather long it has been put in a separate |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
853 file: |pi_spec.txt|. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
854 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
855 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
856 RUST *ft-rust* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
857 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
858 Since the text for this plugin is rather long it has been put in a separate |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
859 file: |ft_rust.txt|. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
860 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
861 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
862 SQL *ft-sql* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
863 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
864 Since the text for this plugin is rather long it has been put in a separate |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
865 file: |ft_sql.txt|. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
866 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
867 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
868 TEX *ft-tex-plugin* *g:tex_flavor* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
869 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
870 If the first line of a *.tex file has the form > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
871 %&<format> |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
872 then this determined the file type: plaintex (for plain TeX), context (for |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
873 ConTeXt), or tex (for LaTeX). Otherwise, the file is searched for keywords to |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
874 choose context or tex. If no keywords are found, it defaults to plaintex. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
875 You can change the default by defining the variable g:tex_flavor to the format |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
876 (not the file type) you use most. Use one of these: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
877 let g:tex_flavor = "plain" |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
878 let g:tex_flavor = "context" |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
879 let g:tex_flavor = "latex" |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
880 Currently no other formats are recognized. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
881 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
882 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
883 VIM *ft-vim-plugin* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
884 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
885 The Vim filetype plugin defines mappings to move to the start and end of |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
886 functions with [[ and ]]. Move around comments with ]" and [". |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
887 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
888 The mappings can be disabled with: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
889 let g:no_vim_maps = 1 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
890 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
891 |
35236
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
892 ZIG *ft-zig-plugin* |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
893 |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
894 *g:zig_recommended_style* |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
895 By default the following indentation options are set, in accordance with Zig's |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
896 recommended style (https://ziglang.org/documentation/master/): > |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
897 |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
898 setlocal expandtab shiftwidth=4 softtabstop=4 tabstop=8 |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
899 < |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
900 To disable this behavior, set |g:zig_recommended_style| to 0: > |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
901 |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
902 let g:zig_recommended_style = 0 |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
903 < |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
904 *g:zig_std_dir* |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
905 The path to the Zig standard library. The Zig |ftplugin| reads |g:zig_std_dir| |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
906 and appends it to the 'path' for Zig files. Where the Zig standard library |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
907 is located is system and installation method dependent. |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
908 |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
909 One can automatically set |g:zig_std_dir| using `zig env`: > |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
910 |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
911 let g:zig_std_dir = json_decode(system('zig env'))['std_dir'] |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
912 < |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
913 This can, for example, be put in a FileType |:autocmd| or user |ftplugin| to |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
914 only load when a Zig file is opened. |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
915 |
3b6868b38118
runtime(zig): refactor zig ftplugin, remove auto format
Christian Brabandt <cb@256bit.org>
parents:
35219
diff
changeset
|
916 |
32670
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
917 ZIMBU *ft-zimbu-plugin* |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
918 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
919 The Zimbu filetype plugin defines mappings to move to the start and end of |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
920 functions with [[ and ]]. |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
921 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
922 The mappings can be disabled with: > |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
923 let g:no_zimbu_maps = 1 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
924 < |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
925 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
926 |
695b50472e85
Fix line endings issue
Christian Brabandt <cb@256bit.org>
parents:
32669
diff
changeset
|
927 vim:tw=78:ts=8:noet:ft=help:norl: |