Add Doxygen configuration files

Doxygen is a program which generates HTML documentation describing all
the files, functions and classes of a program based on the C++ source.
It uses comments in a particular format in the code. There is a search
box and a tree view for the classes, as well as links to HTML versions
of the source files. An example of the output is at
  http://damiana2.aei.mpg.de/~ianhin/carpet-doc/

To generate the documentation, go into the root Carpet directory and
type "doxygen", assuming that doxygen is installed on the local
system. The documentation will be generated in a new carpet-doc
directory. Open the file carpet-doc/html/index.html to browse the
documentation.

It would be convenient to have the documentation generated in this way
made available on the Carpet web site and updated after each commit to
the repository. This patch provides a doxygen configuration file and a
header file for the main documentation page.

1 files changed, 32 insertions, 0 deletions

diff --git a/Carpet/Carpet/src/Doxygen.hh b/Carpet/Carpet/src/Doxygen.hh
new file mode 100644
index 000000000..edd2ff9a5
--- /dev/null
+++ b/Carpet/Carpet/src/Doxygen.hh
@@ -0,0 +1,32 @@
+/**
+   \file
+
+   \mainpage
+
+   \author Erik Schnetter
+   \date August, 2010
+
+   http://www.carpetcode.org
+
+   %Carpet is a parallel AMR (adaptive mesh refinement) driver with MPI
+   for Cactus.  This documentation is for developers of %Carpet (users
+   of %Carpet should instead see the User Documentation obtained by
+   typing "make Carpet-ThornDoc" in the Cactus directory).
+
+   Important source files:
+
+     Carpet/src/Initialise.cc
+
+     Carpet/src/Evolve.cc
+
+     Carpet/src/Recompose.cc
+
+   Important classes:
+
+     vect
+     bbox
+     bboxset
+     Carpet::bbvect
+     region_t
+
+*/