summaryrefslogtreecommitdiffstats
path: root/doc/doxywizard_usage.doc
diff options
context:
space:
mode:
authordimitri <dimitri@afe2bf4a-e733-0410-8a33-86f594647bc7>2004-07-18 19:47:03 (GMT)
committerdimitri <dimitri@afe2bf4a-e733-0410-8a33-86f594647bc7>2004-07-18 19:47:03 (GMT)
commit46361b7017fbbbc5f560eea54aac2be86abaf90e (patch)
tree6409d19be4f75548825a856ab0a7bd9921ad4996 /doc/doxywizard_usage.doc
parente6e861e83b8a05b894b84775f0fc115614d6f229 (diff)
downloadDoxygen-46361b7017fbbbc5f560eea54aac2be86abaf90e.zip
Doxygen-46361b7017fbbbc5f560eea54aac2be86abaf90e.tar.gz
Doxygen-46361b7017fbbbc5f560eea54aac2be86abaf90e.tar.bz2
Release-1.3.7-20040718
Diffstat (limited to 'doc/doxywizard_usage.doc')
-rw-r--r--doc/doxywizard_usage.doc104
1 files changed, 96 insertions, 8 deletions
diff --git a/doc/doxywizard_usage.doc b/doc/doxywizard_usage.doc
index 468f3fa..a758b4c 100644
--- a/doc/doxywizard_usage.doc
+++ b/doc/doxywizard_usage.doc
@@ -16,13 +16,77 @@
*/
/*! \page doxywizard_usage Doxywizard usage
-Doxywizard is a GUI front-end for creating and editing
-configuration files that are used by doxygen.
+Doxywizard is a GUI front-end for configuring and running doxygen.
-Doxywizard consists of a single executable that, when started,
-pops up a window.
+When you start doxywizard it will display the main window
+(the actual look depends on the OS used).
-The main window has a number of tab field, one
+\image html doxywizard_main.png "Main window"
+
+The windows shows the steps to take to configure and run doxygen.
+The first step is to choose one of the ways to configure doxygen.
+<dl>
+<dt>Wizard<dd>Click this button to quickly configure the most important
+ settings and leave the rest of the options to their defaults.
+<dt>Expert<dd>Click this button to to gain access to the
+ \ref config "full range of configuration options".
+<dt>Load<dd>Click this button to load an existing configuration file
+ from disk.
+</dl>
+Note that you can select multiple buttons in a row, for instance to first
+configure doxygen using the Wizard and then fine tune the settings via
+the Expert.
+
+After doxygen is configured you need to save the configuration as a file
+to disk. This second step allows doxygen to use the configuration
+and has the additional advantage that the configuration can be reused
+to run doxygen with the same settings at a later point in time.
+
+Since some configuration options may use relative paths, the next step is
+to select a directory from which to run doxygen. This is typically the root
+of the source tree and will most of the time already be filled in correctly.
+
+Once the configuration file is saved and the working directory is set, you
+can run doxygen based on the selected settings. Do this by pressing the
+"Start" button. Once doxygen runs you can cancel it by clicking the same
+button again. The output produced by doxygen is captured and shown in a log
+window. Once doxygen finishes, the log can be saved as a text file.
+
+<h3>The Wizard Dialog</h3>
+
+If you select the Wizard button in step 1, then a dialog with
+a number of tabs will appear.
+
+\image html doxywizard_page1.png "Wizard dialog: Project settings"
+
+The fields in the project tab speak for themselves. Once doxygen has finished
+the Destination directory is where to look for the results. Doxygen will
+put each output format in a separate sub-directory.
+
+\image html doxywizard_page2.png "Wizard dialog: Mode of operating"
+
+The mode tab allows you to select how doxygen will look at your sources.
+The default is to only look for things that have been documented.
+
+You can also select how doxygen should present the results.
+The latter does not affect the way doxygen parses your source code.
+
+\image html doxywizard_page3.png "Wizard dialog: Output to produce"
+
+You can select one or more of the output formats that doxygen should
+produce. For HTML and LaTeX there are additional options.
+
+\image html doxywizard_page4.png "Wizard dialog: Diagrams to generate"
+
+Doxygen can produce a number of diagrams. Using the diagrams tab you
+can select which ones to generate. For most diagrams the
+dot tool of the <a href="http://www.graphviz.org">GraphViz</a> package
+is needed (if you use the binary packages for Mac or Windows this
+tool is already included).
+
+<h3>Expert dialog</h3>
+
+The Expert dialog has a number of tab fields, one
for each section in the configuration file. Each tab-field
contains a number of lines, one for each configuration option in
that section.
@@ -38,13 +102,37 @@ The kind of input widget depends on the type of the configuration option.
<li>For options taking a lists of strings, a one line edit field is
available, with a `+' button to add this string to the list and
a `-' button to remove the selected string from the list. There
- is also a button with a circular "refresh" arrow that, when pressed,
+ is also a `*' button that, when pressed,
replaces the selected item in the list with the string entered in the
edit field.
<li>For file and folder entries, there are special buttons
- that start a file dialog.
+ that start a file selection dialog.
</ul>
-\image html doxywizard.gif
+\image html doxywizard_expert.png "Some options from the Expert dialog"
+
+The get additional information about the meaning of an option, click
+on the "Help" button at the bottom right of the dialog and then on the
+item. A tooltip with additional information will appear.
+
+<h3>Menu options</h3>
+
+The GUI front-end has a menu with a couple of useful items
+
+\image html doxywizard_menu.png "File menu"
+
+<dl>
+<dt>Open...<dd>This is the same as the "Load" button in the main window
+ and allows to open a configuration file from disk.
+<dt>Save as..<dd>This is the same as the "Save" button in the main window
+ and can be used to save the current configuration settings to disk.
+<dt>Recent configurations<dd>Allow to quickly load a recently saved
+ configuration.
+<dt>Set as default...<dd>Stores the current configuration settings as the
+ default to use next time the GUI is started. You will be asked to
+ confirm the action.
+<dt>Reset...<dd>Restores the factory defaults as the default settings to use.
+ You will be asked to confirm the action.
+</dl>
*/