--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/doxygen.rst Wed Aug 17 21:14:54 2011 +0300
@@ -0,0 +1,51 @@
+.. -*- coding: utf-8 -*-
+
+==========
+ Doxygen.
+==========
+.. contents::
+
+Installing.
+===========
+::
+
+ $ sudo apt-get install doxygen
+ $ sudo apt-get install doxygen-gui
+
+Graphical wizard called as::
+
+ $ doxywizard
+
+Doxygen simple workflow.
+========================
+::
+
+ $ cd $proj
+ $ doxygen -g $proj.cfg # generate basic config file
+
+Edit $proj.cfg. Some essential settings::
+
+ PROJECT_NAME = my-proj
+ OUTPUT_DIRECTORY = my
+ OUTPUT_LANGUAGE = English
+ INPUT = my.h my.hpp dir/
+ INPUT_ENCODING = UTF-8
+ FILE_PATTERNS =
+ RECURSIVE = NO
+ GENERATE_HTML = YES
+
+Generate .chm from doxygen.
+===========================
+
+Check doxygen config file for::
+
+ GENERATE_HTMLHELP = YES
+ CHM_FILE = my.chm
+ CHM_INDEX_ENCODING = Windows-1251
+
+Run 'doxygen' and 'hhc.exe' on generated 'index.hhp'::
+
+ $ doxygen $proj.cfg
+ $ cd $proj/html # here gone doxygen html output
+ $ hhc.exe index.hhp
+