@doxygen doxygen.conf
doxygen.conf: doxygen.conf.in
- @regex_cmd@ -e "s,\@VERSION\@,$(VERSION)," \
+ @regex_cmd@ -e "s,\@version\@,$(VERSION)," \
-e "s,\@basedir\@,`cd $(top_builddir) && pwd`," \
doxygen.conf.in > doxygen.conf
--- /dev/null
+// Further comments for doxygen on the src/ directory
+
+/*! @namespace ob
+ @brief The namespace containing the %Openbox window manager application
+*/
+
+/*! @namespace otk
+ @brief The namespace containing the Openbox toolkit
+*/
+/*! @namespace otk
+ The namespace containing a toolkit used by the Openbox window manager,
+ and also for use by external applications that wish to present a similar
+ visual appearance to Openbox.
+*/
# General configuration options
#---------------------------------------------------------------------------
PROJECT_NAME = Openbox
-PROJECT_NUMBER = @VERSION@
+PROJECT_NUMBER = @version@
OUTPUT_DIRECTORY =
OUTPUT_LANGUAGE = English
EXTRACT_ALL = YES
VERBATIM_HEADERS = YES
SHOW_INCLUDE_FILES = YES
JAVADOC_AUTOBRIEF = NO
-MULTILINE_CPP_IS_BRIEF = NO
+MULTILINE_CPP_IS_BRIEF = YES
DETAILS_AT_TOP = YES
INHERIT_DOCS = YES
INLINE_INFO = YES
#---------------------------------------------------------------------------
# configuration options related to the input files
#---------------------------------------------------------------------------
-INPUT = ../../src ../../otk
+INPUT = ../../src ../../otk comments
FILE_PATTERNS = *.hh *.cc
RECURSIVE = NO
EXCLUDE =
#---------------------------------------------------------------------------
ALPHABETICAL_INDEX = NO
COLS_IN_ALPHA_INDEX = 5
-IGNORE_PREFIX =
+IGNORE_PREFIX = OB OTK _
#---------------------------------------------------------------------------
# configuration options related to the HTML output
#---------------------------------------------------------------------------
DISABLE_INDEX = NO
ENUM_VALUES_PER_LINE = 4
GENERATE_TREEVIEW = NO
-TREEVIEW_WIDTH = 250
+TREEVIEW_WIDTH = 200
#---------------------------------------------------------------------------
# configuration options related to the LaTeX output
#---------------------------------------------------------------------------
LATEX_CMD_NAME = latex
MAKEINDEX_CMD_NAME = makeindex
COMPACT_LATEX = NO
-PAPER_TYPE = a4wide
+PAPER_TYPE = letter
EXTRA_PACKAGES =
LATEX_HEADER =
PDF_HYPERLINKS = NO
TEMPLATE_RELATIONS = YES
INCLUDE_GRAPH = YES
INCLUDED_BY_GRAPH = YES
-GRAPHICAL_HIERARCHY = YES
+GRAPHICAL_HIERARCHY = NO
DOT_IMAGE_FORMAT = png
DOT_PATH =
DOTFILE_DIRS =
#ifndef __Configuration_hh
#define __Configuration_hh
+/*! @file configuration.hh
+ @brief Loads, saves, and provides configuration options for the window
+ manager
+*/
+
+extern "C" {
#include <X11/Xlib.h>
#include <X11/Xresource.h>
+}
+
#include <string>
namespace ob {
// -*- mode: C++; indent-tabs-mode: nil; -*-
+/*! @file main.cc
+ @brief Main entry point for the application
+*/
+
#ifdef HAVE_CONFIG_H
# include "../config.h"
#endif // HAVE_CONFIG_H
#ifndef __openbox_hh
#define __openbox_hh
+/*! @file openbox.hh
+ @brief The main class for the Openbox window manager
+*/
+
extern "C" {
#include <X11/Xlib.h>
}
//! The posible running states of the window manager
enum RunState {
- //! The window manager is starting up (being created)
- State_Starting,
- //! The window manager is running in its normal state
- State_Normal,
- //! The window manager is exiting (being destroyed)
- State_Exiting
+ State_Starting, //!< The window manager is starting up (being created)
+ State_Normal, //!< The window manager is running in its normal state
+ State_Exiting //!< The window manager is exiting (being destroyed)
};
private:
#ifndef __XAtom_h
#define __XAtom_h
+/*! @file xatom.hh
+ @brief Provides access to atoms on the display
+*/
+
extern "C" {
#include <X11/Xlib.h>
#include <X11/Xatom.h>
#ifndef __xeventhandler_hh
#define __xeventhandler_hh
+/*! @file xeventhandler.hh
+ @brief The class which handles raw XEvents, turning them into high-level
+ user interaction sequences, or processing them as appropriate
+*/
+
extern "C" {
#include <X11/Xlib.h>
}