Breathe provides a bridge between the Sphinx and Doxygen documentation systems.
It is an easy way to include Doxygen information in a set of documentation
generated by Sphinx. The aim is to produce an autodoc like support for people
who enjoy using Sphinx but work with languages other than Python. The system
relies on the Doxygen's xml output.
NOTE: If this package has multiple flavors (see below), then use one of them instead of the name specified above. NOTE: This is a Python port. Instead of py312-breathe listed in the above command, you can pick from the names under the Packages section.
===> The following configuration options are available for py312-breathe-4.36.0_1:
DOCS=on: Build and/or install documentation
EXAMPLES=on: Build and/or install examples
PDFDOCS=off: Build PDF documentation (implies DOCS)
===> Use 'make config' to modify these settings
devel/py-breathe: fix build against recent Doxygen/Sphinx (+)
Set corresponding SPHINXOPTS for configure/build enviroment to not treat style
warnings as errors
PR: 298454
Reported by: pkg-fallout, mandree
With hat: doxygen
devel/py-breathe: repair havoc wreaked by bc7ed2ccd62e
bc7ed2ccd62 was insufficiently made, so I will credit as:
Broken by: vishwin@
PR: 270510
I herewith have recorded that this was in violation of
long-standing best practice that we give maintainers
ports affected by sweeping changes such as the one in bc7ed...
sufficient heads-up so this can be properly reviewed
before inflicting the damage.
vishwin@ has been around the project for long enough that
he should know this, and I observe that there is a strong
(Only the first 15 lines of the commit message are shown above )
Remove WWW entries moved into port Makefiles
Commit b7f05445c00f has added WWW entries to port Makefiles based on
WWW: lines in pkg-descr files.
This commit removes the WWW: lines of moved-over URLs from these
pkg-descr files.
Approved by: portmgr (tcberner)
Add WWW entries to port Makefiles
It has been common practice to have one or more URLs at the end of the
ports' pkg-descr files, one per line and prefixed with "WWW:". These
URLs should point at a project website or other relevant resources.
Access to these URLs required processing of the pkg-descr files, and
they have often become stale over time. If more than one such URL was
present in a pkg-descr file, only the first one was tarnsfered into
the port INDEX, but for many ports only the last line did contain the
port specific URL to further information.
There have been several proposals to make a project URL available as
a macro in the ports' Makefiles, over time.
(Only the first 15 lines of the commit message are shown above )
devel/py-breathe: fix alternative Python versions
The port used to build only for the default python version,
use BINARY_ALIAS to help the build find the proper Sphinx version.
Switch to autoplist to permit packaging for Python 3.6/3.7, too
(__pycache__ layout differences don't work well with static pkg-plist).
Not bumping PORTREVISION again on the assumption that we would not have
been able to build a package previously on an alternative Python
version, so there is nothing to flush out with a PORTREVISION bump.
devel/py-breathe: RST&Sphinx bridge to Doxygen [NEW PORT]
Breathe provides a bridge between the Sphinx and Doxygen documentation systems.
It is an easy way to include Doxygen information in a set of documentation
generated by Sphinx. The aim is to produce an autodoc like support for people
who enjoy using Sphinx but work with languages other than Python. The system
relies on the Doxygen’s xml output.
WWW: https://github.com/michaeljones/breathe
