Crunch CRiSP File Editor 6 - Manual (Page 11)

Page 11
crtags [switches] file1 file2 ....
You can use Unix style wild cards for the filenames, even on the Windows platforms.
The command line switches can be grouped into three types:
- general purpose switches affecting the crtags program,
- output file format switches
- language sensitive element switches
File formats
crtags creates a tags file. Two file formats are supported: text and binary. The binary format is smaller and
contains more information needed by CRiSP's cross-referencing facility (the class browser window). The text
file format was used in older versions of CRiSP and has now been deprecated.
File
formats:crtags
The binary file format is designed to be machine independent, meaning that if you share a network
filesystem, then the tags file can be used by all CRiSP clients on the network no matter what CPU
architecture they use.
Specifying Directories
If you specify the name of a directory instead of a file then crtags will recursively scan that directory for files.
This can be a quick and convenient way of handling entire projects of source code.
Language Mapping switches
crtags allows you to specify language mapping switches on the command line. This is designed to allow you
to configure how files with non-standard extensions are handled. By default, crtags treats files with certain
extensions as detailed below.
To set the language mapping mode, you can put something like this:
xyz=pascal
on the command line. Multiple switches can be used. The left hand side should match in case the
extensions to use. The right hand side should be one of the standard file extensions recognized or the
language name.
General switches
In general, it is recommended to use crtags without any command lines flags - the default options are
sufficient to create a browser tags file.
-a Appends the new tags information to the end of the specified tags file rather than
replacing it.
-all When parsing files, duplicate definitions are normally ignored. For example in a C source
file, you might have a prototype for a function and the function definition itself. If you
specify this flag then all occurrences of the object will be listed in the tags file.
-absolute If this switch is specified then the filenames in the tags file will be the full path to the file.
This can be useful when you have a large project which spans many directories and you
want to jump to arbitrary functions in any directory.
The down-side of this switch is that the tags file may be significantly larger than if the
abbreviated filenames are used.
This is the default.
-binary Create binary format tags file (default). The binary format allows for faster cross-
referencing in the CRiSP browser and supports structural information needed to display
the class browser window.
-d Enables debug. Not useful for the end user.
-help Lists complete summary of supported languages, switches and options.
-I file This switch allows you to specify the name of a file containing a list of filenames to be