--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Orb/Doxygen/doc/installdox_usage.doc	Thu Jan 21 17:29:01 2010 +0000
@@ -0,0 +1,59 @@
+/******************************************************************************
+ *
+ * 
+ *
+ * Copyright (C) 1997-2008 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). 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 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.
+
+*/