Finding your way around in the Cactus structure can be pretty difficult to handle. To make life easier there is support for tags, which lets you browse the code easily from within Emacs/XEmacs or vi. A tags database can be generated with gmake:
The command gmake TAGS will create a database for a routine reference table to be used within Emacs. This
database can be accessed within Emacs if you add either of the following lines to your .emacs
file:
(setq tags-file-name "CACTUS_HOME/TAGS") XOR
(setq tag-table-alist ’(("CACTUS_HOME" . "CACTUS_HOME/TAGS")))
where CACTUS_HOME is your Cactus directory.
You can now easily navigate your Cactus flesh and Toolkits by searching for functions or “tags”:
If you add the following lines to your .emacs file, the files found with tags will opened in read-only mode:
The key strokes to use when you want to browse in read-only mode are:
The commands available are highly dependent upon the version of vi, but the following is a selection of commands which may work.
Note: Currently some of the CCTK_FILEVERSION() macros at the top of every source file don’t have a trailing semicolon, which confuses the etags and ctags programs, so tags does not find the first subroutine in any file with this problem.