[mirror_edk2.git] / BaseTools / Scripts / PackageDocumentTools / plugins / EdkPlugins / basemodel / doxygen.py

## @file\r
#\r
# Copyright (c) 2011 - 2018, Intel Corporation. All rights reserved.<BR>\r
#\r
# This program and the accompanying materials are licensed and made available\r
# under the terms and conditions of the BSD License which accompanies this\r
# distribution. The full text of the license may be found at\r
# http://opensource.org/licenses/bsd-license.php\r
#\r
# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
#\r
\r
from __future__ import print_function\r
from __future__ import absolute_import\r
import os\r
\r
from .message import *\r
\r
class BaseDoxygeItem:\r
    def __init__(self, name, tag=''):\r
        self.mName = name\r
        self.mTag  = tag\r
        self.mDescription = ''\r
        self.mText = []\r
\r
    def AddDescription(self, desc):\r
        self.mDescription = '%s%s' % (self.mDescription, desc)\r
\r
    def __str__(self):\r
        return '\n'.join(self.mText)\r
\r
    def Generate(self):\r
        """This interface need to be override"""\r
\r
class Section(BaseDoxygeItem):\r
    def Generate(self):\r
        """This interface need to be override"""\r
        if len(self.mTag) != 0:\r
            self.mText.append(' \section %s %s' % (self.mName, self.mTag))\r
        else:\r
            self.mText.append(' \section %s' % self.mName)\r
\r
        self.mText.append(self.mDescription)\r
        return self.mText\r
\r
class Page(BaseDoxygeItem):\r
    def __init__(self, name, tag=None, isSort=True):\r
        BaseDoxygeItem.__init__(self, name, tag)\r
        self.mSubPages     = []\r
        self.mIsMainPage   = False\r
        self.mSections     = []\r
        self.mIsSort       = isSort\r
\r
    def GetSubpageCount(self):\r
        return len(self.mSubPages)\r
\r
    def AddPage(self, subpage):\r
        self.mSubPages.append(subpage)\r
        return subpage\r
\r
    def AddPages(self, pageArray):\r
        if pageArray is None:\r
            return\r
        for page in pageArray:\r
            self.AddPage(page)\r
\r
    def AddSection(self, section):\r
        self.mSections.append(section)\r
        self.mSections.sort(cmp=lambda x, y: cmp(x.mName.lower(), y.mName.lower()))\r
\r
    def Generate(self):\r
        if self.mIsMainPage:\r
            self.mText.append('/** \mainpage %s' % self.mName)\r
            self.mIsSort = False\r
        else:\r
            self.mText.append('/** \page %s %s' % (self.mTag, self.mName))\r
\r
        if len(self.mDescription) != 0:\r
            self.mText.append(self.mDescription)\r
        endIndex = len(self.mText)\r
\r
        self.mSections.sort()\r
        for sect in self.mSections:\r
            self.mText += sect.Generate()\r
\r
        endIndex = len(self.mText)\r
\r
        if len(self.mSubPages) != 0:\r
            self.mText.insert(endIndex, "<p> \section content_index INDEX")\r
            endIndex = len(self.mText)\r
            self.mText.insert(endIndex, '<ul>')\r
            endIndex += 1\r
            if self.mIsSort:\r
                self.mSubPages.sort(cmp=lambda x, y: cmp(x.mName.lower(), y.mName.lower()))\r
            for page in self.mSubPages:\r
                self.mText.insert(endIndex, '<li>\subpage %s \"%s\" </li>' % (page.mTag, page.mName))\r
                endIndex += 1\r
                self.mText += page.Generate()\r
            self.mText.insert(endIndex, '</ul>')\r
            endIndex += 1\r
        self.mText.insert(endIndex, ' **/')\r
        return self.mText\r
\r
class DoxygenFile(Page):\r
    def __init__(self, name, file):\r
        Page.__init__(self, name)\r
        self.mFilename  = file\r
        self.mIsMainPage = True\r
\r
    def GetFilename(self):\r
        return self.mFilename.replace('/', '\\')\r
\r
    def Save(self):\r
        str = self.Generate()\r
        try:\r
            f = open(self.mFilename, 'w')\r
            f.write('\n'.join(str))\r
            f.close()\r
        except IOError as e:\r
            ErrorMsg ('Fail to write file %s' % self.mFilename)\r
            return False\r
\r
        return True\r
\r
doxygenConfigTemplate = """\r
DOXYFILE_ENCODING      = UTF-8\r
PROJECT_NAME           = %(ProjectName)s\r
PROJECT_NUMBER         = %(ProjectVersion)s\r
OUTPUT_DIRECTORY       = %(OutputDir)s\r
CREATE_SUBDIRS         = YES\r
OUTPUT_LANGUAGE        = English\r
BRIEF_MEMBER_DESC      = YES\r
REPEAT_BRIEF           = YES\r
ABBREVIATE_BRIEF       = "The $name class           " \\\r
                         "The $name widget           " \\\r
                         "The $name file           " \\\r
                         is \\\r
                         provides \\\r
                         specifies \\\r
                         contains \\\r
                         represents \\\r
                         a \\\r
                         an \\\r
                         the\r
ALWAYS_DETAILED_SEC    = NO\r
INLINE_INHERITED_MEMB  = NO\r
FULL_PATH_NAMES        = YES\r
STRIP_FROM_PATH        = %(StripPath)s\r
STRIP_FROM_INC_PATH    =\r
SHORT_NAMES            = YES\r
JAVADOC_AUTOBRIEF      = NO\r
QT_AUTOBRIEF           = NO\r
MULTILINE_CPP_IS_BRIEF = NO\r
DETAILS_AT_TOP         = YES\r
INHERIT_DOCS           = YES\r
SEPARATE_MEMBER_PAGES  = NO\r
TAB_SIZE               = 1\r
ALIASES                =\r
OPTIMIZE_OUTPUT_FOR_C  = YES\r
OPTIMIZE_OUTPUT_JAVA   = NO\r
BUILTIN_STL_SUPPORT    = NO\r
CPP_CLI_SUPPORT        = NO\r
SIP_SUPPORT            = NO\r
DISTRIBUTE_GROUP_DOC   = YES\r
SUBGROUPING            = YES\r
TYPEDEF_HIDES_STRUCT   = NO\r
\r
EXTRACT_ALL            = YES\r
EXTRACT_PRIVATE        = NO\r
EXTRACT_STATIC         = NO\r
EXTRACT_LOCAL_CLASSES  = NO\r
EXTRACT_LOCAL_METHODS  = NO\r
EXTRACT_ANON_NSPACES   = NO\r
HIDE_UNDOC_MEMBERS     = NO\r
HIDE_UNDOC_CLASSES     = NO\r
HIDE_FRIEND_COMPOUNDS  = NO\r
HIDE_IN_BODY_DOCS      = NO\r
INTERNAL_DOCS          = NO\r
CASE_SENSE_NAMES       = NO\r
HIDE_SCOPE_NAMES       = NO\r
SHOW_INCLUDE_FILES     = NO\r
INLINE_INFO            = YES\r
SORT_MEMBER_DOCS       = YES\r
SORT_BRIEF_DOCS        = NO\r
SORT_BY_SCOPE_NAME     = YES\r
GENERATE_TODOLIST      = YES\r
GENERATE_TESTLIST      = YES\r
GENERATE_BUGLIST       = YES\r
GENERATE_DEPRECATEDLIST= YES\r
ENABLED_SECTIONS       =\r
MAX_INITIALIZER_LINES  = 30\r
SHOW_USED_FILES        = NO\r
SHOW_DIRECTORIES       = NO\r
FILE_VERSION_FILTER    =\r
\r
QUIET                  = NO\r
WARNINGS               = YES\r
WARN_IF_UNDOCUMENTED   = YES\r
WARN_IF_DOC_ERROR      = YES\r
WARN_NO_PARAMDOC       = YES\r
WARN_FORMAT            = "$file:$line: $text           "\r
WARN_LOGFILE           = %(WarningFile)s\r
\r
INPUT                  = %(FileList)s\r
INPUT_ENCODING         = UTF-8\r
FILE_PATTERNS          = %(Pattern)s\r
RECURSIVE              = NO\r
EXCLUDE                = *.svn\r
EXCLUDE_SYMLINKS       = NO\r
EXCLUDE_PATTERNS       = .svn\r
EXCLUDE_SYMBOLS        =\r
EXAMPLE_PATH           = %(ExamplePath)s\r
EXAMPLE_PATTERNS       = *\r
EXAMPLE_RECURSIVE      = NO\r
IMAGE_PATH             =\r
INPUT_FILTER           =\r
FILTER_PATTERNS        =\r
FILTER_SOURCE_FILES    = NO\r
\r
SOURCE_BROWSER         = NO\r
INLINE_SOURCES         = NO\r
STRIP_CODE_COMMENTS    = YES\r
REFERENCED_BY_RELATION = YES\r
REFERENCES_RELATION    = YES\r
REFERENCES_LINK_SOURCE = NO\r
USE_HTAGS              = NO\r
VERBATIM_HEADERS       = NO\r
\r
ALPHABETICAL_INDEX     = NO\r
COLS_IN_ALPHA_INDEX    = 5\r
IGNORE_PREFIX          =\r
\r
GENERATE_HTML          = YES\r
HTML_OUTPUT            = html\r
HTML_FILE_EXTENSION    = .html\r
HTML_HEADER            =\r
HTML_FOOTER            =\r
HTML_STYLESHEET        =\r
HTML_ALIGN_MEMBERS     = YES\r
GENERATE_HTMLHELP      = %(WhetherGenerateHtmlHelp)s\r
HTML_DYNAMIC_SECTIONS  = NO\r
CHM_FILE               = index.chm\r
HHC_LOCATION           =\r
GENERATE_CHI           = NO\r
BINARY_TOC             = NO\r
TOC_EXPAND             = NO\r
DISABLE_INDEX          = NO\r
ENUM_VALUES_PER_LINE   = 4\r
GENERATE_TREEVIEW      = %(WhetherGenerateTreeView)s\r
TREEVIEW_WIDTH         = 250\r
\r
GENERATE_LATEX         = NO\r
LATEX_OUTPUT           = latex\r
LATEX_CMD_NAME         = latex\r
MAKEINDEX_CMD_NAME     = makeindex\r
COMPACT_LATEX          = NO\r
PAPER_TYPE             = a4wide\r
EXTRA_PACKAGES         =\r
LATEX_HEADER           =\r
PDF_HYPERLINKS         = YES\r
USE_PDFLATEX           = YES\r
LATEX_BATCHMODE        = NO\r
LATEX_HIDE_INDICES     = NO\r
\r
GENERATE_RTF           = NO\r
RTF_OUTPUT             = rtf\r
COMPACT_RTF            = NO\r
RTF_HYPERLINKS         = NO\r
RTF_STYLESHEET_FILE    =\r
RTF_EXTENSIONS_FILE    =\r
\r
GENERATE_MAN           = NO\r
MAN_OUTPUT             = man\r
MAN_EXTENSION          = .3\r
MAN_LINKS              = NO\r
\r
GENERATE_XML           = NO\r
XML_OUTPUT             = xml\r
XML_SCHEMA             =\r
XML_DTD                =\r
XML_PROGRAMLISTING     = YES\r
\r
GENERATE_AUTOGEN_DEF   = NO\r
\r
GENERATE_PERLMOD       = NO\r
PERLMOD_LATEX          = NO\r
PERLMOD_PRETTY         = YES\r
PERLMOD_MAKEVAR_PREFIX =\r
\r
ENABLE_PREPROCESSING   = YES\r
MACRO_EXPANSION        = YES\r
EXPAND_ONLY_PREDEF     = YES\r
SEARCH_INCLUDES        = YES\r
INCLUDE_PATH           = %(IncludePath)s\r
INCLUDE_FILE_PATTERNS  = *.h\r
PREDEFINED             = %(PreDefined)s\r
EXPAND_AS_DEFINED      =\r
SKIP_FUNCTION_MACROS   = NO\r
\r
TAGFILES               =\r
GENERATE_TAGFILE       =\r
ALLEXTERNALS           = NO\r
EXTERNAL_GROUPS        = YES\r
PERL_PATH              = /usr/bin/perl\r
\r
CLASS_DIAGRAMS         = NO\r
MSCGEN_PATH            =\r
HIDE_UNDOC_RELATIONS   = YES\r
HAVE_DOT               = NO\r
CLASS_GRAPH            = YES\r
COLLABORATION_GRAPH    = YES\r
GROUP_GRAPHS           = YES\r
UML_LOOK               = NO\r
TEMPLATE_RELATIONS     = NO\r
INCLUDE_GRAPH          = YES\r
INCLUDED_BY_GRAPH      = YES\r
CALL_GRAPH             = NO\r
CALLER_GRAPH           = NO\r
GRAPHICAL_HIERARCHY    = YES\r
DIRECTORY_GRAPH        = YES\r
DOT_IMAGE_FORMAT       = png\r
DOT_PATH               =\r
DOTFILE_DIRS           =\r
DOT_GRAPH_MAX_NODES    = 50\r
MAX_DOT_GRAPH_DEPTH    = 1000\r
DOT_TRANSPARENT        = YES\r
DOT_MULTI_TARGETS      = NO\r
GENERATE_LEGEND        = YES\r
DOT_CLEANUP            = YES\r
\r
SEARCHENGINE           = NO\r
\r
"""\r
class DoxygenConfigFile:\r
    def __init__(self):\r
        self.mProjectName  = ''\r
        self.mOutputDir    = ''\r
        self.mFileList     = []\r
        self.mIncludeList  = []\r
        self.mStripPath    = ''\r
        self.mExamplePath  = ''\r
        self.mPattern      = ['*.c', '*.h',\r
                              '*.asm', '*.s', '.nasm', '*.html', '*.dox']\r
        self.mMode         = 'HTML'\r
        self.mWarningFile  = ''\r
        self.mPreDefined   = []\r
        self.mProjectVersion = 0.1\r
\r
    def SetChmMode(self):\r
        self.mMode = 'CHM'\r
\r
    def SetHtmlMode(self):\r
        self.mMode = 'HTML'\r
\r
    def SetProjectName(self, str):\r
        self.mProjectName = str\r
\r
    def SetProjectVersion(self, str):\r
        self.mProjectVersion = str\r
\r
    def SetOutputDir(self, str):\r
        self.mOutputDir = str\r
\r
    def SetStripPath(self, str):\r
        self.mStripPath = str\r
\r
    def SetExamplePath(self, str):\r
        self.mExamplePath = str\r
\r
    def SetWarningFilePath(self, str):\r
        self.mWarningFile = str.replace('\\', '/')\r
\r
    def FileExists(self, path):\r
        if path is None:\r
            return False\r
        if len(path) == 0:\r
            return False\r
\r
        for p in self.mFileList:\r
            if path.lower() == p.lower():\r
                return True\r
\r
        return False\r
\r
    def AddFile(self, path):\r
        if path is None:\r
            return\r
\r
        if len(path) == 0:\r
            return\r
        path = path.replace('\\', '/')\r
        if not self.FileExists(path):\r
            self.mFileList.append(path)\r
\r
    def AddIncludePath(self, path):\r
        path = path.replace('\\', '/')\r
        if path not in self.mIncludeList:\r
            self.mIncludeList.append(path)\r
\r
    def AddPattern(self, pattern):\r
        self.mPattern.append(pattern)\r
\r
    def AddPreDefined(self, macro):\r
        self.mPreDefined.append(macro)\r
\r
    def Generate(self, path):\r
        files    = ' \\\n'.join(self.mFileList)\r
        includes = ' \\\n'.join(self.mIncludeList)\r
        patterns = ' \\\n'.join(self.mPattern)\r
        if self.mMode.lower() == 'html':\r
            sHtmlHelp = 'NO'\r
            sTreeView = 'YES'\r
        else:\r
            sHtmlHelp = 'YES'\r
            sTreeView = 'NO'\r
\r
        text = doxygenConfigTemplate % {'ProjectName':self.mProjectName,\r
                                        'OutputDir':self.mOutputDir,\r
                                        'StripPath':self.mStripPath,\r
                                        'ExamplePath':self.mExamplePath,\r
                                        'FileList':files,\r
                                        'Pattern':patterns,\r
                                        'WhetherGenerateHtmlHelp':sHtmlHelp,\r
                                        'WhetherGenerateTreeView':sTreeView,\r
                                        'IncludePath':includes,\r
                                        'WarningFile':self.mWarningFile,\r
                                        'PreDefined':' '.join(self.mPreDefined),\r
                                        'ProjectVersion':self.mProjectVersion}\r
        try:\r
            f = open(path, 'w')\r
            f.write(text)\r
            f.close()\r
        except IOError as e:\r
            ErrorMsg ('Fail to generate doxygen config file %s' % path)\r
            return False\r
\r
        return True\r
\r
########################################################################\r
#                  TEST                   CODE\r
########################################################################\r
if __name__== '__main__':\r
    df = DoxygenFile('Platform Document', 'm:\tree')\r
    df.AddPage(Page('Module', 'module'))\r
    p = df.AddPage(Page('Library', 'library'))\r
    p.AddDescription(desc)\r
    p.AddPage(Page('PCD', 'pcds'))\r
\r
    df.Generate()\r
    print(df)\r
Commit	Line	Data
7ccc9c95 YZ	1	## @file\r
	2	#\r
	3	# Copyright (c) 2011 - 2018, Intel Corporation. All rights reserved.<BR>\r
	4	#\r
	5	# This program and the accompanying materials are licensed and made available\r
	6	# under the terms and conditions of the BSD License which accompanies this\r
	7	# distribution. The full text of the license may be found at\r
	8	# http://opensource.org/licenses/bsd-license.php\r
	9	#\r
	10	# THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
	11	# WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
	12	#\r
	13	\r
1ccc4d89 LG	14	from __future__ import print_function\r
1ccc4d89 LG	15	from __future__ import absolute_import\r
7ccc9c95 YZ	16	import os\r
7ccc9c95 YZ	17	\r
2add3cff	18	from .message import *\r
7ccc9c95 YZ	19	\r
	20	class BaseDoxygeItem:\r
	21	def __init__(self, name, tag=''):\r
	22	self.mName = name\r
	23	self.mTag = tag\r
	24	self.mDescription = ''\r
	25	self.mText = []\r
	26	\r
	27	def AddDescription(self, desc):\r
	28	self.mDescription = '%s%s' % (self.mDescription, desc)\r
	29	\r
	30	def __str__(self):\r
	31	return '\n'.join(self.mText)\r
	32	\r
	33	def Generate(self):\r
	34	"""This interface need to be override"""\r
	35	\r
	36	class Section(BaseDoxygeItem):\r
	37	def Generate(self):\r
	38	"""This interface need to be override"""\r
	39	if len(self.mTag) != 0:\r
	40	self.mText.append(' \section %s %s' % (self.mName, self.mTag))\r
	41	else:\r
	42	self.mText.append(' \section %s' % self.mName)\r
	43	\r
	44	self.mText.append(self.mDescription)\r
	45	return self.mText\r
	46	\r
	47	class Page(BaseDoxygeItem):\r
	48	def __init__(self, name, tag=None, isSort=True):\r
	49	BaseDoxygeItem.__init__(self, name, tag)\r
	50	self.mSubPages = []\r
	51	self.mIsMainPage = False\r
	52	self.mSections = []\r
	53	self.mIsSort = isSort\r
	54	\r
	55	def GetSubpageCount(self):\r
	56	return len(self.mSubPages)\r
	57	\r
	58	def AddPage(self, subpage):\r
	59	self.mSubPages.append(subpage)\r
	60	return subpage\r
	61	\r
	62	def AddPages(self, pageArray):\r
4231a819	63	if pageArray is None:\r
7ccc9c95 YZ	64	return\r
	65	for page in pageArray:\r
	66	self.AddPage(page)\r
	67	\r
	68	def AddSection(self, section):\r
	69	self.mSections.append(section)\r
1ccc4d89	70	self.mSections.sort(cmp=lambda x, y: cmp(x.mName.lower(), y.mName.lower()))\r
7ccc9c95 YZ	71	\r
	72	def Generate(self):\r
	73	if self.mIsMainPage:\r
	74	self.mText.append('/** \mainpage %s' % self.mName)\r
	75	self.mIsSort = False\r
	76	else:\r
	77	self.mText.append('/** \page %s %s' % (self.mTag, self.mName))\r
	78	\r
	79	if len(self.mDescription) != 0:\r
	80	self.mText.append(self.mDescription)\r
	81	endIndex = len(self.mText)\r
	82	\r
1ccc4d89	83	self.mSections.sort()\r
7ccc9c95 YZ	84	for sect in self.mSections:\r
	85	self.mText += sect.Generate()\r
	86	\r
	87	endIndex = len(self.mText)\r
	88	\r
	89	if len(self.mSubPages) != 0:\r
	90	self.mText.insert(endIndex, "<p> \section content_index INDEX")\r
	91	endIndex = len(self.mText)\r
	92	self.mText.insert(endIndex, '<ul>')\r
	93	endIndex += 1\r
	94	if self.mIsSort:\r
1ccc4d89	95	self.mSubPages.sort(cmp=lambda x, y: cmp(x.mName.lower(), y.mName.lower()))\r
7ccc9c95 YZ	96	for page in self.mSubPages:\r
	97	self.mText.insert(endIndex, '<li>\subpage %s \"%s\" </li>' % (page.mTag, page.mName))\r
	98	endIndex += 1\r
	99	self.mText += page.Generate()\r
	100	self.mText.insert(endIndex, '</ul>')\r
	101	endIndex += 1\r
	102	self.mText.insert(endIndex, ' **/')\r
	103	return self.mText\r
	104	\r
	105	class DoxygenFile(Page):\r
	106	def __init__(self, name, file):\r
	107	Page.__init__(self, name)\r
	108	self.mFilename = file\r
	109	self.mIsMainPage = True\r
	110	\r
	111	def GetFilename(self):\r
	112	return self.mFilename.replace('/', '\\')\r
	113	\r
	114	def Save(self):\r
	115	str = self.Generate()\r
	116	try:\r
	117	f = open(self.mFilename, 'w')\r
	118	f.write('\n'.join(str))\r
	119	f.close()\r
5b0671c1	120	except IOError as e:\r
7ccc9c95 YZ	121	ErrorMsg ('Fail to write file %s' % self.mFilename)\r
	122	return False\r
	123	\r
	124	return True\r
	125	\r
	126	doxygenConfigTemplate = """\r
	127	DOXYFILE_ENCODING = UTF-8\r
	128	PROJECT_NAME = %(ProjectName)s\r
	129	PROJECT_NUMBER = %(ProjectVersion)s\r
	130	OUTPUT_DIRECTORY = %(OutputDir)s\r
	131	CREATE_SUBDIRS = YES\r
	132	OUTPUT_LANGUAGE = English\r
	133	BRIEF_MEMBER_DESC = YES\r
	134	REPEAT_BRIEF = YES\r
	135	ABBREVIATE_BRIEF = "The $name class " \\\r
	136	"The $name widget " \\\r
	137	"The $name file " \\\r
	138	is \\\r
	139	provides \\\r
	140	specifies \\\r
	141	contains \\\r
	142	represents \\\r
	143	a \\\r
	144	an \\\r
	145	the\r
	146	ALWAYS_DETAILED_SEC = NO\r
	147	INLINE_INHERITED_MEMB = NO\r
	148	FULL_PATH_NAMES = YES\r
	149	STRIP_FROM_PATH = %(StripPath)s\r
	150	STRIP_FROM_INC_PATH =\r
	151	SHORT_NAMES = YES\r
	152	JAVADOC_AUTOBRIEF = NO\r
	153	QT_AUTOBRIEF = NO\r
	154	MULTILINE_CPP_IS_BRIEF = NO\r
	155	DETAILS_AT_TOP = YES\r
	156	INHERIT_DOCS = YES\r
	157	SEPARATE_MEMBER_PAGES = NO\r
	158	TAB_SIZE = 1\r
	159	ALIASES =\r
	160	OPTIMIZE_OUTPUT_FOR_C = YES\r
	161	OPTIMIZE_OUTPUT_JAVA = NO\r
	162	BUILTIN_STL_SUPPORT = NO\r
	163	CPP_CLI_SUPPORT = NO\r
	164	SIP_SUPPORT = NO\r
	165	DISTRIBUTE_GROUP_DOC = YES\r
	166	SUBGROUPING = YES\r
	167	TYPEDEF_HIDES_STRUCT = NO\r
	168	\r
	169	EXTRACT_ALL = YES\r
	170	EXTRACT_PRIVATE = NO\r
	171	EXTRACT_STATIC = NO\r
	172	EXTRACT_LOCAL_CLASSES = NO\r
	173	EXTRACT_LOCAL_METHODS = NO\r
	174	EXTRACT_ANON_NSPACES = NO\r
	175	HIDE_UNDOC_MEMBERS = NO\r
	176	HIDE_UNDOC_CLASSES = NO\r
	177	HIDE_FRIEND_COMPOUNDS = NO\r
	178	HIDE_IN_BODY_DOCS = NO\r
	179	INTERNAL_DOCS = NO\r
	180	CASE_SENSE_NAMES = NO\r
	181	HIDE_SCOPE_NAMES = NO\r
	182	SHOW_INCLUDE_FILES = NO\r
	183	INLINE_INFO = YES\r
	184	SORT_MEMBER_DOCS = YES\r
185	SORT_BRIEF_DOCS = NO\r
186	SORT_BY_SCOPE_NAME = YES\r
187	GENERATE_TODOLIST = YES\r
188	GENERATE_TESTLIST = YES\r
189	GENERATE_BUGLIST = YES\r
190	GENERATE_DEPRECATEDLIST= YES\r
191	ENABLED_SECTIONS =\r
192	MAX_INITIALIZER_LINES = 30\r
193	SHOW_USED_FILES = NO\r
194	SHOW_DIRECTORIES = NO\r
195	FILE_VERSION_FILTER =\r
196	\r
197	QUIET = NO\r
198	WARNINGS = YES\r
199	WARN_IF_UNDOCUMENTED = YES\r
200	WARN_IF_DOC_ERROR = YES\r
201	WARN_NO_PARAMDOC = YES\r
202	WARN_FORMAT = "$file:$line: $text "\r
203	WARN_LOGFILE = %(WarningFile)s\r
204	\r
205	INPUT = %(FileList)s\r
206	INPUT_ENCODING = UTF-8\r
207	FILE_PATTERNS = %(Pattern)s\r
208	RECURSIVE = NO\r
209	EXCLUDE = *.svn\r
210	EXCLUDE_SYMLINKS = NO\r
211	EXCLUDE_PATTERNS = .svn\r
212	EXCLUDE_SYMBOLS =\r
213	EXAMPLE_PATH = %(ExamplePath)s\r
214	EXAMPLE_PATTERNS = *\r
215	EXAMPLE_RECURSIVE = NO\r
216	IMAGE_PATH =\r
217	INPUT_FILTER =\r
218	FILTER_PATTERNS =\r
219	FILTER_SOURCE_FILES = NO\r
220	\r
221	SOURCE_BROWSER = NO\r
222	INLINE_SOURCES = NO\r
223	STRIP_CODE_COMMENTS = YES\r
224	REFERENCED_BY_RELATION = YES\r
225	REFERENCES_RELATION = YES\r
226	REFERENCES_LINK_SOURCE = NO\r
227	USE_HTAGS = NO\r
228	VERBATIM_HEADERS = NO\r
229	\r
230	ALPHABETICAL_INDEX = NO\r
231	COLS_IN_ALPHA_INDEX = 5\r
232	IGNORE_PREFIX =\r
233	\r
234	GENERATE_HTML = YES\r
235	HTML_OUTPUT = html\r
236	HTML_FILE_EXTENSION = .html\r
237	HTML_HEADER =\r
238	HTML_FOOTER =\r
239	HTML_STYLESHEET =\r
240	HTML_ALIGN_MEMBERS = YES\r
241	GENERATE_HTMLHELP = %(WhetherGenerateHtmlHelp)s\r
242	HTML_DYNAMIC_SECTIONS = NO\r
243	CHM_FILE = index.chm\r
244	HHC_LOCATION =\r
245	GENERATE_CHI = NO\r
246	BINARY_TOC = NO\r
247	TOC_EXPAND = NO\r
248	DISABLE_INDEX = NO\r
249	ENUM_VALUES_PER_LINE = 4\r
250	GENERATE_TREEVIEW = %(WhetherGenerateTreeView)s\r
251	TREEVIEW_WIDTH = 250\r
252	\r
253	GENERATE_LATEX = NO\r
254	LATEX_OUTPUT = latex\r
255	LATEX_CMD_NAME = latex\r
256	MAKEINDEX_CMD_NAME = makeindex\r
257	COMPACT_LATEX = NO\r
258	PAPER_TYPE = a4wide\r
259	EXTRA_PACKAGES =\r
260	LATEX_HEADER =\r
261	PDF_HYPERLINKS = YES\r
262	USE_PDFLATEX = YES\r
263	LATEX_BATCHMODE = NO\r
264	LATEX_HIDE_INDICES = NO\r
265	\r
266	GENERATE_RTF = NO\r
267	RTF_OUTPUT = rtf\r
268	COMPACT_RTF = NO\r
269	RTF_HYPERLINKS = NO\r
270	RTF_STYLESHEET_FILE =\r
271	RTF_EXTENSIONS_FILE =\r
272	\r
273	GENERATE_MAN = NO\r
274	MAN_OUTPUT = man\r
275	MAN_EXTENSION = .3\r
276	MAN_LINKS = NO\r
277	\r
278	GENERATE_XML = NO\r
279	XML_OUTPUT = xml\r
280	XML_SCHEMA =\r
281	XML_DTD =\r
282	XML_PROGRAMLISTING = YES\r
283	\r
284	GENERATE_AUTOGEN_DEF = NO\r
285	\r
286	GENERATE_PERLMOD = NO\r
287	PERLMOD_LATEX = NO\r
288	PERLMOD_PRETTY = YES\r
289	PERLMOD_MAKEVAR_PREFIX =\r
290	\r
291	ENABLE_PREPROCESSING = YES\r
292	MACRO_EXPANSION = YES\r
293	EXPAND_ONLY_PREDEF = YES\r
294	SEARCH_INCLUDES = YES\r
295	INCLUDE_PATH = %(IncludePath)s\r
296	INCLUDE_FILE_PATTERNS = *.h\r
297	PREDEFINED = %(PreDefined)s\r
298	EXPAND_AS_DEFINED =\r
299	SKIP_FUNCTION_MACROS = NO\r
300	\r
301	TAGFILES =\r
302	GENERATE_TAGFILE =\r
303	ALLEXTERNALS = NO\r
304	EXTERNAL_GROUPS = YES\r
305	PERL_PATH = /usr/bin/perl\r
306	\r
307	CLASS_DIAGRAMS = NO\r
308	MSCGEN_PATH =\r
309	HIDE_UNDOC_RELATIONS = YES\r
310	HAVE_DOT = NO\r
311	CLASS_GRAPH = YES\r
312	COLLABORATION_GRAPH = YES\r
313	GROUP_GRAPHS = YES\r
314	UML_LOOK = NO\r
315	TEMPLATE_RELATIONS = NO\r
316	INCLUDE_GRAPH = YES\r
317	INCLUDED_BY_GRAPH = YES\r
318	CALL_GRAPH = NO\r
319	CALLER_GRAPH = NO\r
320	GRAPHICAL_HIERARCHY = YES\r
321	DIRECTORY_GRAPH = YES\r
322	DOT_IMAGE_FORMAT = png\r
323	DOT_PATH =\r
324	DOTFILE_DIRS =\r
325	DOT_GRAPH_MAX_NODES = 50\r
326	MAX_DOT_GRAPH_DEPTH = 1000\r
327	DOT_TRANSPARENT = YES\r
328	DOT_MULTI_TARGETS = NO\r
329	GENERATE_LEGEND = YES\r
330	DOT_CLEANUP = YES\r
331	\r
332	SEARCHENGINE = NO\r
333	\r
334	"""\r
335	class DoxygenConfigFile:\r
336	def __init__(self):\r
337	self.mProjectName = ''\r
338	self.mOutputDir = ''\r
339	self.mFileList = []\r
340	self.mIncludeList = []\r
341	self.mStripPath = ''\r
342	self.mExamplePath = ''\r
343	self.mPattern = ['.c', '.h',\r
344	'.asm', '.s', '.nasm', '.html', '.dox']\r
345	self.mMode = 'HTML'\r
346	self.mWarningFile = ''\r
347	self.mPreDefined = []\r
348	self.mProjectVersion = 0.1\r
349	\r
350	def SetChmMode(self):\r
351	self.mMode = 'CHM'\r
352	\r
353	def SetHtmlMode(self):\r
354	self.mMode = 'HTML'\r
355	\r
356	def SetProjectName(self, str):\r
357	self.mProjectName = str\r
358	\r
359	def SetProjectVersion(self, str):\r
360	self.mProjectVersion = str\r
361	\r
362	def SetOutputDir(self, str):\r
363	self.mOutputDir = str\r
364	\r
365	def SetStripPath(self, str):\r
366	self.mStripPath = str\r
367	\r
368	def SetExamplePath(self, str):\r
369	self.mExamplePath = str\r
370	\r
371	def SetWarningFilePath(self, str):\r
372	self.mWarningFile = str.replace('\\', '/')\r
373	\r
374	def FileExists(self, path):\r
4231a819	375	if path is None:\r
7ccc9c95 YZ	376	return False\r
	377	if len(path) == 0:\r
	378	return False\r
	379	\r
	380	for p in self.mFileList:\r
	381	if path.lower() == p.lower():\r
	382	return True\r
	383	\r
	384	return False\r
	385	\r
	386	def AddFile(self, path):\r
4231a819	387	if path is None:\r
7ccc9c95 YZ	388	return\r
	389	\r
	390	if len(path) == 0:\r
	391	return\r
	392	path = path.replace('\\', '/')\r
	393	if not self.FileExists(path):\r
	394	self.mFileList.append(path)\r
	395	\r
	396	def AddIncludePath(self, path):\r
	397	path = path.replace('\\', '/')\r
	398	if path not in self.mIncludeList:\r
	399	self.mIncludeList.append(path)\r
	400	\r
	401	def AddPattern(self, pattern):\r
	402	self.mPattern.append(pattern)\r
	403	\r
	404	def AddPreDefined(self, macro):\r
	405	self.mPreDefined.append(macro)\r
	406	\r
	407	def Generate(self, path):\r
	408	files = ' \\\n'.join(self.mFileList)\r
	409	includes = ' \\\n'.join(self.mIncludeList)\r
	410	patterns = ' \\\n'.join(self.mPattern)\r
	411	if self.mMode.lower() == 'html':\r
	412	sHtmlHelp = 'NO'\r
	413	sTreeView = 'YES'\r
	414	else:\r
	415	sHtmlHelp = 'YES'\r
	416	sTreeView = 'NO'\r
	417	\r
	418	text = doxygenConfigTemplate % {'ProjectName':self.mProjectName,\r
	419	'OutputDir':self.mOutputDir,\r
	420	'StripPath':self.mStripPath,\r
	421	'ExamplePath':self.mExamplePath,\r
	422	'FileList':files,\r
	423	'Pattern':patterns,\r
	424	'WhetherGenerateHtmlHelp':sHtmlHelp,\r
	425	'WhetherGenerateTreeView':sTreeView,\r
	426	'IncludePath':includes,\r
	427	'WarningFile':self.mWarningFile,\r
	428	'PreDefined':' '.join(self.mPreDefined),\r
	429	'ProjectVersion':self.mProjectVersion}\r
	430	try:\r
	431	f = open(path, 'w')\r
	432	f.write(text)\r
	433	f.close()\r
5b0671c1	434	except IOError as e:\r
7ccc9c95 YZ	435	ErrorMsg ('Fail to generate doxygen config file %s' % path)\r
	436	return False\r
	437	\r
	438	return True\r
	439	\r
	440	########################################################################\r
	441	# TEST CODE\r
	442	########################################################################\r
	443	if __name__== '__main__':\r
	444	df = DoxygenFile('Platform Document', 'm:\tree')\r
	445	df.AddPage(Page('Module', 'module'))\r
	446	p = df.AddPage(Page('Library', 'library'))\r
	447	p.AddDescription(desc)\r
	448	p.AddPage(Page('PCD', 'pcds'))\r
	449	\r
	450	df.Generate()\r
72443dd2	451	print(df)\r