~emersion/gyosu

A simple C documentation generator.
15 hours ago

#10 Extract comments for macros

~emersion filed ticket on gyosu todo

7 days ago

#gyosu

builds.sr.ht status

A simple C documentation generator.

Example output: I maintain the documentation for the wlroots API on my website.

#Building

go build .

#Usage

gyosu [options...] <headers...>

Example:

gyosu \
  $(pkg-config --cflags-only-I wlroots) \
  -DWLR_USE_UNSTABLE \
  -ffile-prefix-map=/usr/include/= \
  /usr/include/wlr/types/wlr_output.h

#Comment formatting

All documentation comments must use /** … */.

To reference another declaration from a documentation comment, the following notations are recognized:

  • struct foo
  • enum foo
  • union foo
  • foo()
  • <foo.h>

#Contributing

Send patches on the mailing list, report bugs on the issue tracker, discuss in #emersion on Libera Chat.

#License

AGPLv3, see LICENSE.

Copyright (C) 2021 Simon Ser