From: Cris Luengo Date: Tue, 7 May 2019 04:20:40 +0000 (-0600) Subject: documentation: fix for empty pages issue. X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~cjwatson/git?a=commitdiff_plain;h=ab911ff765a8af9e3075f5d6a166487f03304fac;p=blog.git documentation: fix for empty pages issue. --- diff --git a/documentation/doxygen.py b/documentation/doxygen.py index f610d196..c12a54fc 100755 --- a/documentation/doxygen.py +++ b/documentation/doxygen.py @@ -2384,9 +2384,9 @@ def extract_metadata(state: State, xml): # This is similar to compound.url_base handling in parse_xml() below. compound.url = 'index.html' if compound.kind == 'page' and compound.id == 'indexpage' else compound.id + '.html' compound.brief = parse_desc(state, compounddef.find('briefdescription')) - # Groups and pages are explicitly created so they *have details*, other + # Groups are explicitly created so they *have details*, other # things need to have at least some documentation - compound.has_details = compound.kind in ['group', 'page'] or compound.brief or compounddef.find('detaileddescription') + compound.has_details = compound.kind == 'group' or compound.brief or compounddef.find('detaileddescription') compound.children = [] # Deprecation status @@ -2684,9 +2684,9 @@ def parse_xml(state: State, xml: str): if state.doxyfile['M_SHOW_UNDOCUMENTED']: _document_all_stuff(compounddef) - # Ignoring compounds w/o any description, except for pages and groups, + # Ignoring compounds w/o any description, except for groups, # which are created explicitly - if not compounddef.find('briefdescription') and not compounddef.find('detaileddescription') and not compounddef.attrib['kind'] in ['page', 'group']: + if not compounddef.find('briefdescription') and not compounddef.find('detaileddescription') and not compounddef.attrib['kind'] == 'group': logging.debug("{}: neither brief nor detailed description present, skipping".format(state.current)) return None