bpf.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* Generating libbpf API documentation
@ 2021-03-15 16:50 Grant Seltzer Richman
  2021-03-16  0:47 ` Andrii Nakryiko
  0 siblings, 1 reply; 8+ messages in thread
From: Grant Seltzer Richman @ 2021-03-15 16:50 UTC (permalink / raw)
  To: bpf

Hi all,

I have been experimenting with ways to contribute documentation to
libbpf to make it easier for developers of bpf projects to use it.
With the goal of making a documentation site that is easy to
maintain/generate I found Doxygen (many of you may have experience
with it, I did not). I set up a CI/CD workflow using github actions
that runs doxygen on the libbpf mirror hosted there, and hosts the
produced HTML using netlify. You can find the currently hosted version
of it at https://libbpf-docs.netlify.app (I would gladly donate a real
domain name for this purpose). The docs generation workflow is in my
github repo here: https://github.com/grantseltzer/libbpf-docs

In order to make this work all we would need is to format comments
above functions we want to document. Doxygen requires that the comment
just be in a block that starts with `/**`. I don't think doxygen
specific directives should be committed to code but I think this is a
fine convention to follow. Other doxygen directives (i.e. having
`@file` in every file) can be faked using a step I have in the github

What does everyone think? Can we agree on this convention and start
contributing documentation in this way? Any pitfalls to doxygen I'm
not familiar with?


^ permalink raw reply	[flat|nested] 8+ messages in thread

end of thread, other threads:[~2021-04-22 21:21 UTC | newest]

Thread overview: 8+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-03-15 16:50 Generating libbpf API documentation Grant Seltzer Richman
2021-03-16  0:47 ` Andrii Nakryiko
2021-03-16 20:14   ` Grant Seltzer Richman
2021-04-16 19:38     ` Grant Seltzer Richman
2021-04-20  4:26       ` Andrii Nakryiko
2021-04-21 19:24         ` Grant Seltzer Richman
2021-04-22  3:58           ` Andrii Nakryiko
2021-04-22 21:20             ` Grant Seltzer Richman

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).