To cover, explain & test the alternative approach that has been
introduced.

As that style of comment is not necessary unique to cpp and is a bit
awkward to force users of o...

Ideally we should probably split out html and latex builds but I'm not
sufficiently experienced ...

Unfortunately I do not know how to fix it so it is easiest just to
remove it for the moment.

As latex has a limit on the depth of nesting sections, though I'm not
sure why, so we can't demo...

In an attempt to keep things moving forward.

So that we have something more specific to style with on the html side
if we're keen to.

Replace section with container and title with rubric. According to
docutils. This preserves the ...

This is an attempt to provide a setup that does not indent the contents
of the 'Public Functions...

Thanks for fixing the support for array parameters.

Seems to work excellently.

Instead of performing the switch in the template if-statement where we
reset the 'signode' value...

The comment needs to be expanded a little given the context.

For the odd occasion where we want to run it again without generating
the html again.

We need to render templates on two lines but desc_signature doesn't
permit multiple lines. So ad...

Empty desc nodes break LaTeX markup and are not permitted according to
the Sphinx documentation
...

We need to render templates on two lines but desc_signature doesn't
permit multiple lines. So ad...

Rather than changing the system path to look at the local code, we
install that and rely on it b...

For python-2.6 compatibility.

We make it overridable and override it for the travis builds to an
empty string.

As it doesn't support u'' prefix I think most projects have stopped
bothering to be compatible w...

We'd like to take advantage of travis.

Previously not showing up in the output.

A standard 'missing' node situation.

As they don't seem to be showing up in the Breathe output at the moment.

As we have fixed the source of the problem by not doing any linking in
the text rendering for th...

The render helper on the BaseDirective previously just used
'self.options' directly. Here we cha...

Use the cleaner dict.get(key, default) rather than the somewhat ugly try
and except blocks.

And fix any issues.

For some reason this single argument overloaded function reveals a bug
that the more complex exa...

And reformat a little.

When looking for the project name we were only looking for the :project:
option on the directive...

The paths use '/' even on Windows so we just check for both backslash
and forward slash.

Thanks to rweickelt for this.

As people who want to use it will have to specify the future breathe
3.1.0. If we leave it as a ...

I'm not sure exactly how best to handle these but it seems like a good
step forward to have them...

In the refactor I must have lost it somehow.

To highlight differences between the Breathe output and the Doxygen &
Autodoc outputs which peop...

To take into accout multiple children of varying types. We probably
should allow loads of differ...

It has been extended in include a <b> tag within one of the headings as
doxygen seems to allow t...

Headlines are rendered as emphasized text as it has been done for
doxygen sections. Section leve...

Sphinx still keeps compatibility with 2.6.5 so should we.

The defname is the definition name, whereas we'd prefer the declaration
name which is from the h...

This addresses github issue #118 (KeyError: 'display_name'), which was
causing breathe (and Sphi...

It isn't exactly a test, really, but it does fail without the fix in the
previous commit.

Thanks for catching and fixing the bug in the warning generation.

We have to treat slots like functions so when we come across one we use
the specialisated FuncMe...

To remove the awful repetition. I'm not well versed in Make so this is
my best effort. I think t...

Thanks to rweickelt for the example contributed in the original github
issue.

Also started to f...

To ignore some of the files/folders that have been floating around.

As we're mimicing the rst directive options dictionary at that point. I
previously mistyped it a...

Creating sets in the form ``{'v1', 'v2'}`` is not supported before
Python 2.7. This is the only ...

Example: The class

```
template <typename T>
class Specialization<T*> {};
```

can be accessed ...

And use double underscore anonymous rst links to squash warnings.