summaryrefslogtreecommitdiffstats
path: root/doc/installdox_usage.doc
blob: a3794e15cba3ca605cafb9a23372eaee388d81e1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
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
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
/******************************************************************************
 *
 * 
 *
 * Copyright (C) 1997-2003 by Dimitri van Heesch.
 *
 * 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.
 *
 * Documents produced by Doxygen are derivative works derived from the
 * input used in their production; they are not affected by this license.
 *
 */
/*! \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.

   \par Note:
     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.

*/