Doxytag usage

Doxytag is a small command line based utility. It has two functions: In both cases the input of doxytag consists of a set of HTML files.
If you use tag files or use a search engine, the links that are generated by doxygen will contain dummy links. You have to run the installdox script to change these dummy links into real links. See Installdox usage for more information. The use of dummy links may seem redundant, but it is really useful, if you want to move the external documentation to another location. Then the documentation does not need to be regenerated by doxygen, only installdox has to be run.
Because the HTML files are expected to have a certain structure, only HTML files generated with doxygen or with Qt's class browser generator can be used. Doxytag only reads the HTML files, they are not altered in any way.

Doxytag expects a list of all HTML files that form the documentation or a directory that contains all HTML files. If neither is present doxytag will read all files with a .html extension from the current directory. If doxytag is used with the -t flag it generates a tag file.
Example 1:
Suppose the file example.cpp from the examples directory that is listed below is included in some package for which you do not have the sources. Fortunately, the distributor of the packages included the HTML documentation that was generated by doxygen in the package.
/** A Test class.
 *  More details about this class.

class Test
    /** An example member function.
     *  More details about this function.
    void example();

void Test::example() {}

/** \example example_test.cpp
 * This is an example of how to use the Test class.
 * More details about this example.
Now you can create a tag file from the HTML files in the package by typing:
doxytag -t example.tag example/html
from the examples directory. Finally you can use this tag file with your own piece of code, such as done in the following example:
/*! A class that is inherited from the external class Test.

class Tag : public Test
    /*! an overloaded member. */
    void example();
Doxygen will now include links to the external package in your own documentation. Because the tag file does not specify where the documentation is located, you will have to specify that by running the installdox script that doxygen generates (See section Installdox usage for more information).

Note that this is actually a feature because if you (or someone else) moves the external documentation to a different directory or URL you can simply run the script again and all links in the HTML files will be updated.

Click here for the corresponding HTML documentation that is generated by Doxygen using only the tag file and second piece of code.

Example 2:
To generate a tag file of the Qt documentation you can do the following:
doxytag -t qt.tag $QTDIR/html

A typical example to use doxytag to generate a search index is:
doxytag -s search.idx 
In the current version of doxygen, the search index must be called search.idx.

Generated at Fri Mar 23 20:22:18 2001 by doxygen1.2.6-20010319 written by Dimitri van Heesch, © 1997-2001