Updated README to acknowledge magro11

Thank you for contributions towards the Python3 support.
Updated README to acknowledge scopatz

In thanks for contributions towards the auto-directives which allow
on-the-fly generation of the doxygen xml files in a temp folder.
Resolve function overloads for simple parameter types.
Add examples for testing the overloaded function code

With simple and more complex types.
Lightly refactor and improve overloaded function code

We separate out the argument parsing and matching into separate function
for a bit more readability and improve the error messages when things
don't turn out how we want them.

We also have to adjust our matching for the namespace, function and
arguments as arguments can have the "::" that we were looking for to
separate the namespace and the function name. We use regex instead.
Updated README to acknowledge vitaut

Thank you for contributions towards the overloaded function resolution.
Merge branch 'overload'
Fix typo in output
Updated README to acknowledge vonj

Thank you for contribution.
Merge branch 'typoFix'
Scan doxygen xml to determine docnames to rebuild

This means changes to doxygen xml files will caused rst documents that
use those files to be rebuilt
Restructure to abstract app object away from in directive internals

We wrap up all the login in a FileStateCache object so that the internal
code only needs to know about that rather than about the Sphinx app
object itself.

This is because the internal code doesn't need that level of exposure
and if it called from docutils instead of Sphinx then that app object
won't really be available but the FileStateCache is relatively easily
mocked.
Updated README to acknowledge jmnas

Thank you for figuring out the update logic when doxygen xml files
change to get the rst files to re-build.
Merge branch 'outdated'
Move to version v1.0.0

To start semantic versioning.
Show appropriate warning when breathe_default_project isn't set

Only when we need it. We reschuffle the code so that we only look for
the default project if there is no project or path setting on the
directive.

Then we look and if it is empty we throw an exception which we catch and
convert to a warning.
Merge branch 'defaultProject'
Allow use of leading asterisk in rst blocks

Comment styles in doxygen that use a leading asterisk, such as

/*! 
 * Commenting
 * a bit
 */

cause the leading asterisk to be passed in to the verbatim block and pollute the desired rst.  This patch strips such leading asterisks in response to a embed:rat:leading-asterisk tag
Added example of usage of embed:rst:leading-asterisk tag
Tweak the asterisk handling logic and docs

We change the documentation to output a representation of the bad data
rather than feeding it the bad data and letting it give us a warning as
we're keen to keep warnings to a minimum.

The test case in the documentation was failing as the first character of
the line wasn't "*" so we tweak the logic to replace the first occurance
of * instead of assuming it is the first character.