vbtags(3f)

NAME

vbtags - Generate a Visual Basic tags file

SYNOPSIS

me "@vbtags" [-v%tag-option=<flags>] [files]

DESCRIPTION

The start-up file vbtags.emf may be invoked from the command line to generate a tags file for Visual Basic files, vb(9).

Given a list of files a tags file tags is generated in the current directory, which may be used by the find-tag(2) command. If no files are specified the default file list is "./", i.e. process the current directory. If a directory name is given (such as the default "./") all Visual Basic files within the directory will be processed.

The value of variable %tag-option is used to control the tag generation process, its value <flags> can contain any number of the following flags:

a


Append new tags to the existing tag file, note that if also using flag 'm' multiple 'tags' to the same item may be created.

m


Enable multiple tags. This enables the existence of 2 tags with the same tag name, but typically with different locations. See help on find-tag(2) for more information on multiple tag support.

p


Add prototype declarations (i.e. lines marked with Declare and a function or subroutine name).

r


Enables recursive mode, any sub-directory found within any given directories will also be processed.

v


Add global variables to the tag file. (i.e. variables marked with Public or Private).

NOTES

This function is invoked from menu

Tools -> Visual Basic Tools -> Generate Tags File

when the user requests a tags file to be generated.

The user setup file "myvbtags.emf" is executed by vbtags during start-up, this file can be used to over-ride any of the vbtags configuration variables (see below).

The following variables are set within "vbtags.emf" and are used to control the process:-

%tag-option


Tags options flag, default value is "". See above for more information.

%tag-filemask


A list of source file masks to be processed when a directory is given, default value is ":*.bas:*.cls:*.asp:".

%tag-ignoredir


A list of directories to be ignored when recursive option is used, default value is ":SCCS/:CVS/:.git/:.svn/:".

These variables can be changed using the -v command-line option or via the "myvbtags.emf" file

SEE ALSO

find-tag(2), start-up(3), vb(9).

(c) Copyright JASSPA 2025
Last Modified: 2025/07/18
Generated On: 2025/09/29