[Docs] Make Doxygen functional

This fixes the doxygen configuration to be functional again. I removed
the customer header and footer, as well as the no-longer-existent style
sheet. I also widened the scope of the documentation, from just the
public API to include the private interfaces as well.

llvm-svn: 358773

diff --git a/lldb/docs/doxygen-mainpage.dox b/lldb/docs/doxygen-mainpage.dox
new file mode 100644 (file)
index 0000000..a6e62f9
--- /dev/null
+++ b/lldb/docs/doxygen-mainpage.dox
@@ -0,0 +1,15 @@
+/// @mainpage LLDB
+///
+/// @section main_intro Introduction
+/// Welcome to LLDB.
+///
+/// This documentation describes both the private and public interface of LLDB.
+/// There are no instructions here on how to use LLDB, only the APIs
+/// that make up the software. For usage instructions, please see
+/// the help command.
+///
+/// @section main_caveat Caveat
+/// This documentation is generated directly from the source code with doxygen.
+/// Since LLDB is constantly under active development, what you're about to
+/// read is out of date! However, it may still be useful since certain portions
+/// of LLDB are very stable.

diff --git a/lldb/docs/doxygen.cfg.in b/lldb/docs/doxygen.cfg.in
index 0c206605185370f9458756784362141addaa6ca2..c882b36bb08426156327d7d6a279352d454b5ea1 100644 (file)
--- a/lldb/docs/doxygen.cfg.in
+++ b/lldb/docs/doxygen.cfg.in
@@ -25,7 +25,7 @@ DOXYFILE_ENCODING      = UTF-8
 # The PROJECT_NAME tag is a single word (or a sequence of words surrounded
 # by quotes) that should identify the project.
 
-PROJECT_NAME           = LLVM
+PROJECT_NAME           = LLDB
 
 # The PROJECT_NUMBER tag can be used to enter a project or revision number.
 # This could be handy for archiving the generated documentation or
@@ -581,8 +581,9 @@ WARN_LOGFILE           =
 # directories like "/usr/src/myproject". Separate the files or directories
 # with spaces.
 
-INPUT                  = @abs_top_srcdir@/include/lldb/API \
-                         @abs_top_srcdir@/docs/doxygen.intro
+INPUT                  = @abs_top_srcdir@/include/ \
+                         @abs_top_srcdir@/source/ \
+                         @abs_top_srcdir@/docs/doxygen-mainpage.dox
 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is
@@ -793,13 +794,13 @@ HTML_FILE_EXTENSION    = .html
 # each generated HTML page. If it is left blank doxygen will generate a
 # standard header.
 
-HTML_HEADER            = @abs_top_srcdir@/docs/doxygen.header
+HTML_HEADER            =
 
 # The HTML_FOOTER tag can be used to specify a personal HTML footer for
 # each generated HTML page. If it is left blank doxygen will generate a
 # standard footer.
 
-HTML_FOOTER            = @abs_top_srcdir@/docs/doxygen.footer
+HTML_FOOTER            =
 
 # The HTML_STYLESHEET tag can be used to specify a user-defined cascading
 # style sheet that is used by each HTML page. It can be used to
@@ -808,7 +809,7 @@ HTML_FOOTER            = @abs_top_srcdir@/docs/doxygen.footer
 # the style sheet file to the HTML output directory, so don't put your own
 # stylesheet in the HTML output directory as well, or it will be erased!
 
-HTML_STYLESHEET        = @abs_top_srcdir@/../../docs/doxygen.css
+HTML_STYLESHEET        =
 
 # The HTML_COLORSTYLE_HUE tag controls the color of the HTML output.
 # Doxygen will adjust the colors in the stylesheet and background images

diff --git a/lldb/docs/doxygen.footer b/lldb/docs/doxygen.footer
deleted file mode 100644 (file)
index c14814b..0000000
--- a/lldb/docs/doxygen.footer
+++ /dev/null
@@ -1,13 +0,0 @@
-<hr>
-<p class="footer">
-Generated on $datetime for <a href="http://lldb.llvm.org/">$projectname</a> by
-<a href="http://www.doxygen.org"><img src="doxygen.png" alt="Doxygen"
-align="middle" border="0"/>$doxygenversion</a><br>
-Copyright &copy; 2003-2013 University of Illinois at Urbana-Champaign.
-All Rights Reserved.</p>
-
-<hr>
-<!--#include virtual="/attrib.incl" -->
-
-</body>
-</html>

diff --git a/lldb/docs/doxygen.header b/lldb/docs/doxygen.header
deleted file mode 100644 (file)
index e6e0331..0000000
--- a/lldb/docs/doxygen.header
+++ /dev/null
@@ -1,9 +0,0 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html><head>
-<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"/>
-<meta name="keywords" content="LLDB,C++,doxygen,API,documentation"/>
-<meta name="description" content="C++ source code API documentation for LLDB."/>
-<title>LLVM: $title</title>
-<link href="doxygen.css" rel="stylesheet" type="text/css"/>
-</head><body>
-<p class="title">LLDB API Documentation</p>

diff --git a/lldb/docs/doxygen.intro b/lldb/docs/doxygen.intro
deleted file mode 100644 (file)
index 1e5cd27..0000000
--- a/lldb/docs/doxygen.intro
+++ /dev/null
@@ -1,19 +0,0 @@
-/// @mainpage LLDB
-///
-/// @section main_intro Introduction
-/// Welcome to LLDB.
-///
-/// This documentation describes the @b interface that can drive LLDB.
-/// There are no instructions here on how to use LLDB, only the APIs
-/// that make up the software. For usage instructions, please see
-/// the help command.
-///
-/// @section main_caveat Caveat 
-/// This documentation is generated directly from the source code with doxygen. 
-/// Since LLDB is constantly under active development, what you're about to
-/// read is out of date! However, it may still be useful since certain portions
-/// of LLDB are very stable. 
-///
-/// @section main_changelog Change Log
-/// - Adapted for LLDB 05/25/2013 by Daniel Malea
-/// - Original content written 12/30/2003 by Reid Spencer