installdox_usage.doc 2.41 KB
Newer Older
Dimitri van Heesch's avatar
Dimitri van Heesch committed
1 2
/******************************************************************************
 *
3
 * 
Dimitri van Heesch's avatar
Dimitri van Heesch committed
4
 *
Dimitri van Heesch's avatar
Dimitri van Heesch committed
5
 * Copyright (C) 1997-2000 by Dimitri van Heesch.
Dimitri van Heesch's avatar
Dimitri van Heesch committed
6 7 8 9 10 11 12
 *
 * Permission to use, copy, modify, and distribute this software and its
 * documentation under the terms of the GNU General Public License is hereby 
 * granted. No representations are made about the suitability of this software 
 * for any purpose. It is provided "as is" without express or implied warranty.
 * See the GNU General Public License for more details.
 *
Dimitri van Heesch's avatar
Dimitri van Heesch committed
13 14
 * Documents produced by Doxygen are derivative works derived from the
 * input used in their production; they are not affected by this license.
Dimitri van Heesch's avatar
Dimitri van Heesch committed
15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43
 *
 */
/*! \page installdox_usage Installdox usage

Installdox is a perl script that is generated by doxygen whenever
tag files are used (See \c TAGFILES
in section \ref config_extref)
or the search engine is enabled (See \c SEARCHENGINE
in section \ref config_search). The script is 
located in the same directory where the HTML files are located. 

Its purpose is to set the location of the external documentation 
for each tag file and to set the correct links to the search engine 
at install time.

Calling \c installdox with option <b>-h</b> at the command line 
will give you a brief description of the usage of the program.

The following options are available:
<dl>
<dt><b>-l <tt>\<tagfile\>\@\<location\></tt></b><dd> 
   Each tag file contains information about the files, classes and members
   documented in a set of HTML files. A user can install these
   HTML files anywhere on his/her hard disk or web site. 
   Therefore installdox \e requires the location of the
   documentation for each tag file <tt>\<tagfile\></tt> 
   that is used by doxygen. The location <tt>\<location\></tt> can be 
   an absolute path or a URL.

44
   \par Note:
Dimitri van Heesch's avatar
Dimitri van Heesch committed
45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62
     Each <tagfile> must be unique and should only be the name of the
     file, not including the path. 

<dt><b>-q</b><dd>
   When this option is specified, installdox will generate no output other
   than fatal errors.
</dl>
Optionally a list of HTML files may be given. 
These files are scanned and modified if needed.
If this list is omitted all files in the current directory 
that end with \c .html are used.

The \c installdox script is unique for each generated class browser
in the sense that it `knows' what tag files are used. It will generate an error if 
the <b>-l</b> option is missing for a tag file or if an invalid tag file 
is given.

*/