annotate runtime/ftplugin/README.txt @ 18486:9d887cad7315

Added tag v8.1.2237 for changeset 63ee3c2b140fe1b4801389872a8e47aec19d028b
author Bram Moolenaar <Bram@vim.org>
date Thu, 31 Oct 2019 20:00:04 +0100
parents 3fc0f57ecb91
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
1 The ftplugin directory is for Vim plugin scripts that are only used for a
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2 specific filetype.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4 All files ending in .vim in this directory and subdirectories will be sourced
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5 by Vim when it detects the filetype that matches the name of the file or
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6 subdirectory.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7 For example, these are all loaded for the "c" filetype:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9 c.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10 c_extra.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11 c/settings.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
13 Note that the "_" in "c_extra.vim" is required to separate the filetype name
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
14 from the following arbitrary name.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
15
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
16 The filetype plugins are only loaded when the ":filetype plugin" command has
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
17 been used.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19 The default filetype plugin files contain settings that 95% of the users will
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20 want to use. They do not contain personal preferences, like the value of
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
21 'shiftwidth'.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
22
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
23 If you want to do additional settings, or overrule the default filetype
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24 plugin, you can create your own plugin file. See ":help ftplugin" in Vim.