Extending the taglist plugin

You can extend the taglist plugin to add support for new languages and also modify the support for the above listed languages.

You should NOT make modifications to the taglist plugin script file to add support for new languages. You will lose these changes when you upgrade to the next version of the taglist plugin. Instead you should follow the below described instructions to extend the taglist plugin.

You can extend the taglist plugin by setting variables in the .vimrc or _vimrc file. The name of these variables depends on the language name and is described below.

Modifying support for an existing language

To determine the filetype name used by Vim for a file, use the following command in the buffer containing the file:

    :set filetype

For example, to modify the support for the perl language files, you have to set the tlist_perl_settings variable. To modify the support for java files, you have to set the tlist_java_settings variable.

The format of the value set in the tlist_xxx_settings variable is

    <language_name>;flag1:name1;flag2:name2;flag3:name3

The first field 'language_name' is the name used by exuberant ctags to refer to this language file. This name can be different from the file type name used by Vim. For example, for C++, the language name used by ctags is 'c++' but the filetype name used by Vim is 'cpp'.

The remaining fields follow the format "flag:name". The sub-field 'flag' is the language specific flag used by exuberant ctags to generate the corresponding tags. For example, for the C language, to list only the functions, the 'f' flag is used. To get the list of flags supported by exuberant ctags for the various languages use the following command:

    $ ctags --list-kinds=all

For example, to list only the classes and functions defined in a C++ language file, add the following line to your .vimrc file:

        let tlist_cpp_settings = 'c++;c:class;f:function'

For example, to display only functions defined in a C file and to use "My Functions" as the title for the function tags, use

        let tlist_c_settings = 'c;f:My Functions'

Adding support for a new language

To add support for a new language, set the tlist_xxx_settings variable appropriately as described above. Replace 'xxx' in the variable name with the Vim filetype name for the new language.

For example, to extend the taglist plugin to support the latex language, you can use the following line (assuming, you have already extended exuberant ctags to support the latex language):

        let tlist_tex_settings='latex;b:bibitem;c:command;l:label'

Language specific extensions

The extensions to exuberant ctags and the taglist plugin to support additional programming languages are listed below. These extensions are contributed by users of the taglist plugin.

• ActionScript
  Add the following lines to the $HOME/.ctags or $HOME/ctags.conf file:

  --langdef=actionscript
  --langmap=actionscript:.as
  --regex-actionscript=/^[ \t]*[(private| public|static) ( \t)]*function[ \t]+([A-Za-z0-9_]+)[ \t]*\(/\1/f, function, functions/
  --regex-actionscript=/^[ \t]*[(public) ( \t)]*function[ \t]+(set|get) [ \t]+([A-Za-z0-9_]+)[ \t]*\(/\1 \2/p,property, properties/
  --regex-actionscript=/^[ \t]*[(private| public|static) ( \t)]*var[ \t]+([A-Za-z0-9_]+)[ \t]*/\1/v,variable, variables/
  --regex-actionscript=/.*\.prototype \.([A-Za-z0-9 ]+)=([ \t]?)function( [ \t]?)*\(/\1/ f,function, functions/
  --regex-actionscript=/^[ \t]*class[ \t]+([A-Za-z0-9_]+)[ \t]*/\1/c,class, classes/
  

  Add the following lines to the ~/.vimrc or $HOME\_vimrc file:

  " actionscript language
  let tlist_actionscript_settings = 'actionscript;c:class;f:method;p:property;v:variable'
  

• Latex
  Add the following lines to the $HOME/.ctags or $HOME/ctags.conf file:

  --langdef=latex
  --langmap=latex:.tex
  --regex-latex=/^\\part[[:space:]]*(\[[^]]*\])?[[:space:]]*\{([^}]+)\}/PART \2/s,part/
  --regex-latex=/^\\part[[:space:]]*\*[[:space:]]*\{([^}]+)\}/PART \1/s,part/
  --regex-latex=/^\\chapter[[:space:]]*(\[[^]]*\])?[[:space:]]*\{([^}]+)\}/CHAP \2/s,chapter/
  --regex-latex=/^\\chapter[[:space:]]*\*[[:space:]]*\{([^}]+)\}/CHAP \1/s,chapter/
  --regex-latex=/^\\section[[:space:]]*(\[[^]]*\])?[[:space:]]*\{([^}]+)\}/\. \2/s,section/
  --regex-latex=/^\\section[[:space:]]*\*[[:space:]]*\{([^}]+)\}/\. \1/s,section/
  --regex-latex=/^\\subsection[[:space:]]*(\[[^]]*\])?[[:space:]]*\{([^}]+)\}/\.\. \2/s,subsection/
  --regex-latex=/^\\subsection[[:space:]]*\*[[:space:]]*\{([^}]+)\}/\.\. \1/s,subsection/
  --regex-latex=/^\\subsubsection[[:space:]]*(\[[^]]*\])?[[:space:]]*\{([^}]+)\}/\.\.\. \2/s,subsubsection/
  --regex-latex=/^\\subsubsection[[:space:]]*\*[[:space:]]*\{([^}]+)\}/\.\.\. \1/s,subsubsection/
  --regex-latex=/^\\includegraphics[[:space:]]*(\[[^]]*\])?[[:space:]]*(\[[^]]*\])?[[:space:]]*\{([^}]+)\}/\3/g,graphic+listing/
  --regex-latex=/^\\lstinputlisting[[:space:]]*(\[[^]]*\])?[[:space:]]*(\[[^]]*\])?[[:space:]]*\{([^}]+)\}/\3/g,graphic+listing/
  --regex-latex=/\\label[[:space:]]*\{([^}]+)\}/\1/l,label/
  --regex-latex=/\\ref[[:space:]]*\{([^}]+)\}/\1/r,ref/
  --regex-latex=/\\pageref[[:space:]]*\{([^}]+)\}/\1/p,pageref/
  --regex-make=/^([^:# \t]+)[ \t]*[:]{1,2}/\1/t,targets/
  

  Add the following lines to the ~/.vimrc or $HOME\_vimrc file:

  let tlist_tex_settings   = 'latex;s:sections;g:graphics;l:labels'
  let tlist_make_settings  = 'make;m:makros;t:targets'