Crunch CRiSP File Editor 6 - Manual (Page 12)

Page 12
included on the command line. This allows you to generate a list of files and store them in
a file rather than being exposed to the command line limitations of certain operating
systems.
Multiple -I switches can be specified on the command line and can be intermingled with
normal files. If you use this switch is must be the last switch on the command line.
-ignorecase When sorting the tags file during the output stage, ignore the case of data elements.
-len nnn Specifies the length of the context line to include in the tags file. The default is 10, which
means that for each tag, not only is the line number within a file recorded but also a
portion of the matching line. This is designed to be used, because as files are edited, the
recorded line number may no longer exactly match the recorded tag. In this case, the
CRiSP tag macro will search for the line using the actual contents of the line.
Large values will significantly increase the size of the tags file, so there is a trade off
between speed and file size.
-l <lang> Treat all files on the command line as if they were of the specified language type. The
complete list of available languages can be seen using the '-help' switch, or consult the
sections below.
-nologo Do not print out the copyright logo message.
-O Optimise the tags output file. This only has meaning when used with the 'crtags' file format
and reduces the size of the tags file at the expense of readability.
-o <tags> Specifies the name of the output file to receive the tags database. The default value is
"tags" in the current directory.
-q Quiet mode. Do not display progress messages as files are parsed.
-sort Turns off the sorting of functions in the tags file.
-regexp <re>
+regexp <re> These two switches allow you to control the tag entries which are placed in the database.
If the -regexp switch is used then all entries which match the expression are not placed in
the file. If you use the +regexp switch then only entries which do match are placed in the
database.
regexp:crtags switches
-text Create an ASCII (old style) index file. The text file is in a human readable file format, but is
not as efficient as the default binary format, and in addition it does not support information
needed for the CRiSP browser.
-u Update mode. Not currently implemented.
-w Enables warnings. Used for compatibility with Unix 'ctags' to show multiple function
definitions. Not particularly useful for larger projects where duplicate static functions may
exist in multiple source files, or where conditional compilation can cause two definitions for
the same function to be recorded.
-x Create cxref style output. Not currently implemented.
Filename filtering
When performing recursive directory scanning, you may want to skip certain files or directories, for example
those used to store source code archives.
-xd <dirname> Specify directories to be skipped.
-xf <filename> Specify filenames to be ignored.
These switches can be specified multiple times as needed. When specifying directory names, only specify
the last component of the directory to be skipped, e.g. -xd SCCS to ignore all SCCS subdirectories.
Filename and directory specifications can include shell wild cards, such as *, [..] and ?. When specifying
these on a command line, you may need to quote the argument to avoid expansion interactions with the
command line shell you are using.
Output file format