# In 1.8.18+, if ///> is accidentally used to mark "a docblock for
# the following symbol", it leads to a <blockquote> contained in
# the brief. Not much to do except for ignoring the whole thing.
- # See the contents_autobrief_blockquote test for details.
+ # See the contents_autobrief_blockquote test for details. Doesn't
+ # happen in 1.12 anymore, not sure if that changed due to
+ # https://github.com/doxygen/doxygen/issues/10902 or something
+ # else in some earlier version.
if has_block_elements or paragraph_count > 1:
logging.warning("{}: ignoring brief description containing multiple paragraphs. Please modify your markup to remove any block elements from the following: {}".format(state.current, out.parsed))
out.parsed = ''
--- /dev/null
+<!DOCTYPE html>
+<html lang="en">
+<head>
+ <meta charset="UTF-8" />
+ <title>File.h file | My Project</title>
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Source+Sans+Pro:400,400i,600,600i%7CSource+Code+Pro:400,400i,600" />
+ <link rel="stylesheet" href="m-dark+documentation.compiled.css" />
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+</head>
+<body>
+<header><nav id="navigation">
+ <div class="m-container">
+ <div class="m-row">
+ <a href="index.html" id="m-navbar-brand" class="m-col-t-8 m-col-m-none m-left-m">My Project</a>
+ </div>
+ </div>
+</nav></header>
+<main><article>
+ <div class="m-container m-container-inflatable">
+ <div class="m-row">
+ <div class="m-col-l-10 m-push-l-1">
+ <h1>
+ File.h <span class="m-thin">file</span>
+ </h1>
+<p>A file</p>
+ <section id="enum-members">
+ <h2><a href="#enum-members">Enums</a></h2>
+ <dl class="m-doc">
+ <dt>
+ <span class="m-doc-wrap-bumper">enum <a href="#a8150b7776c2a1749101acf22e868d091" class="m-doc">Enum</a> { </span><span class="m-doc-wrap"><a href="#a8150b7776c2a1749101acf22e868d091a050889cfb2c606473596b8f70f702769" class="m-doc">Value</a> }</span>
+ </dt>
+ <dd></dd>
+ </dl>
+ </section>
+ <section>
+ <h2>Enum documentation</h2>
+ <section class="m-doc-details" id="a8150b7776c2a1749101acf22e868d091"><div>
+ <h3>
+ enum <a href="#a8150b7776c2a1749101acf22e868d091" class="m-doc-self">Enum</a>
+ </h3>
+ <table class="m-table m-fullwidth m-flat m-doc">
+ <thead><tr><th style="width: 1%">Enumerators</th><th></th></tr></thead>
+ <tbody>
+ <tr>
+ <td><a href="#a8150b7776c2a1749101acf22e868d091a050889cfb2c606473596b8f70f702769" class="m-doc-self" id="a8150b7776c2a1749101acf22e868d091a050889cfb2c606473596b8f70f702769">Value</a></td>
+ <td>
+ <p>A value on the right.</p>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </div></section>
+ </section>
+ </div>
+ </div>
+ </div>
+</article></main>
+</body>
+</html>
<h3>
enum <a href="#a8150b7776c2a1749101acf22e868d091" class="m-doc-self">Enum</a>
</h3>
+<blockquote><p>An enum on the right</p></blockquote>
<table class="m-table m-fullwidth m-flat m-doc">
<thead><tr><th style="width: 1%">Enumerators</th><th></th></tr></thead>
<tbody>
class AutobriefBlockquote(IntegrationTestCase):
def test(self):
- with self.assertLogs() as cm:
+ # ///> in a brief used to cause a multi-line brief in 1.8.18+, which
+ # caused the whole brief to be discarded with a warning. That's no
+ # longer the case in 1.12, there it's put into the detailed description
+ # instead. Not sure if that changed due to
+ # https://github.com/doxygen/doxygen/issues/10902 or something else in
+ # some earlier version.
+ if parse_version(doxygen_version()) >= (1, 12):
self.run_doxygen(wildcard='File_8h.xml')
+ self.assertEqual(*self.actual_expected_contents('File_8h.html'))
+ else:
+ with self.assertLogs() as cm:
+ self.run_doxygen(wildcard='File_8h.xml')
- self.assertEqual(*self.actual_expected_contents('File_8h.html'))
- self.assertEqual(cm.output, [
- "WARNING:root:File_8h.xml: ignoring brief description containing multiple paragraphs. Please modify your markup to remove any block elements from the following: <blockquote><p>An enum on the right</p></blockquote>"
- ])
+ self.assertEqual(*self.actual_expected_contents('File_8h.html', 'File_8h-111.html'))
+ self.assertEqual(cm.output, [
+
"WARNING:root:File_8h.xml: ignoring brief description containing multiple paragraphs. Please modify your markup to remove any block elements from the following: <blockquote><p>An enum on the right</p></blockquote>"
+ ])
# JAVADOC_AUTOBRIEF should be nuked from orbit. Or implemented from scratch,
# properly.
~cjwatson / blog.git / commitdiff