Configure Ctags Function Index
Menu: Configure > Ctags Function Index
Default Shortcut Key: none
Macro function: ConfigureCtagsFunctionIndex()
The Configure Ctags Function Index command provides options that relate to the Ctags Function Index feature.
Index all files that are open for editing
When this option is checked, indexing information will be gathered for all files that are open for editing. If the Auto-index on startup... option is checked (see below), this indexing will occur automatically shortly after startup, and files that are opened later in the editing session will be indexed as they are opened. If the Auto-index option is unchecked, indexing will not occur until and unless the Ctags Function Index command is issued.
Index the extra files named below
When this option is checked, files named in the accompanying list will also be indexed, even if they are not open for editing in the editor. Use this list to name files that you would always like to be indexed, even when you're not editing these files. The edit box below the list is used to enter the full filepath of the file to be added. Click the Add button to add the file to the list. Use the button with the ellipsis button (...) to browse for a file. The Delete key can be used to remove an unwanted entry from the list. Right-clicking in the file list will display a context menu, which additionally contains options to Edit the selected entry and to Delete All entries.
List display options
Stay on top
When checked, this option causes the Ctags Function Index dialog to remain on top of other windows.
Show grid lines
This option controls whether or not grid lines will be displayed between rows and columns in the Ctags Function Index.
Show full filepaths in list
Use this option if you prefer that full filepaths be displayed in the Ctags Function Index. This option is useful when you're editing files that have the same filename, but reside in different directories.
Tool tip options
Auto-index on startup so that tool tips can be shown before function list is opened
Use this option to ensure that popup function prototype tool tips can be displayed even if the Ctags Function Index command has not been issued.
Display popup tool tips for function and procedures
Use this option to control whether prototypes for functions and procedures will be displayed in popup tool tips. The information that is displayed will be dependent on the language being used. For the C programming language, a popup tool tip for a function might look like this:
Display popup tool tips for various other identifiers
Use this option to control whether informative tool tips will be displayed for global variables, structures, members, macros, typedefs and other recognized identifiers. The information that is displayed for an identifier will be dependent on the language being used. For example, when hovering over an identifier that has been #defined in the C programming language, the tool tip might look like this:
Ctags Execution Options
If you have good reason to do so, you can change the path to the Ctags program, its command line option flags, or the path to the output file it creates. Doing so could adversely affect Boxer's ability to process tag information, so proceed with caution. You can use the Restore defaults button to restore the settings to their recommended values.
Exuberant Ctags supports a comprehensive set of command line option flags. With some experimentation, they can even be used to add support for indexing languages not supported by the program in its as-released form. Full information about the Ctags program can be found at the Exuberant Ctags website.