#996357 RFP: hawkmoth -- minimalistic Sphinx C Domain autodoc directive extension

#996357#5
Date:
2021-10-13 12:21:46 UTC
From:
To:
* Package name    : python3-hawkmoth
  Version         : 0.9.0
  Upstream Author : Jani Nikula
* URL             : https://github.com/jnikula/hawkmoth
* License         : BSD 2 clause
  Programming Lang: Python
  Description     : minimalistic Sphinx C Domain autodoc directive extension

Incorporate formatted C source code comments written in
reStructuredText into Sphinx based documentation.  Hawkmoth focuses on
simplicity of design, implementation and use.

Roughly speaking, it's replacement for Doxygen that integrates nicer with documentation written in Sphinx.
It seems useful in general. We're considering using it in notmuch.
-----BEGIN PGP SIGNATURE-----

iQIzBAEBCAAdFiEEkiyHYXwaY0SiY6fqA0U5G1WqFSEFAmFmz1kACgkQA0U5G1Wq
FSFVkg//Z+n9KDTUvMeZNQBSKWFOmoNYiYy1M6lM0S03Nzj73S9iaW3x5TWN21oo
81LwE3obciclnI49E2arychNYFHbIqL9NfkhxLAB15ngJLdo1/UmICLJqzeHNnhr
1/rEqnXs/kpzqQVh3IfFI9t6NwvmGb1iOgPv8RWzOl4BuytrIjuNBHYj7OYX4JKd
BZHAM7aWY4Becnn4r8rjt+iWiIhbdZbB5ozIFtEXQgcs4kCmJPY6kjsl57eFJQMh
Y+OUInLxB1mLGRcBRRVXHaFPSvkO3fjzl8YQmre5LBzYkFKwykKAL8OMIwMabBor
5/hPUVxHBkbnX4+B54G7J2esISrRCaRRGL9CIHeebmwz+lX0ugK0j4H7HlTqW7Z8
cGM9HW5pGN2CZGUukJNbLS+r6pca2l0cDP3NjFgI6GDdEmq4mWe1PQxmHIqN6XWI
tnH18GoApKayMAhzQaZoxMGsSry15xqowl4mypOvm+z2elcXkJm/afreFv7mCqD0
3PZokDvN5SqsrbDrmkHXr0cqwq5FjeC9HO0HlWAhQ/53i/bp35Yqg/RizcTXwgup
sm7AFMCbp60DxvjGVKUzskdV8GypvO18oMMle+KaQSTDwbJ0oqe8vAECY3Og14/1
WdInOBdRe16Zs/zP+2bWe0jsiVC6EXoutQAoKAeihev5E1c56S0=
=/KZP
-----END PGP SIGNATURE-----

#996357#12
Date:
2024-08-10 09:25:44 UTC
From:
To:
Bump. Looks like this has been pretty much ignored and forgotten.

Hawkmoth would benefit from distro packaging, because it depends on a
native package not available via pip (python3-clang and its
dependencies).

What could I do to move things forward?

BR,
Jani.

#996357#17
Date:
2024-08-14 12:09:11 UTC
From:
To:
Jani Nikula <jani@nikula.org> writes:

Maybe you can do a better job than I did of convincing people that
hawkmoth will useful to a broad enough set of users of Debian to make
the maintenance burden worthwhile. One very common justification is that
it is or will be required to build other packages. A quick search for
"hawkmoth" on codesearch.debian.net suggest that it is at least used
upstream by some other packages. I don't know what those packages are
doing now (not building docs?) but maybe you do, since one of them is
mesa. OTOH network manager references hawkmoth via a vendored library,
which supports the guess of not building docs.