~emersion/gyosu

ref: 3bdbf439b86e2867dbc39f5510c63ceb9a6aa7d1 gyosu/README.md -rw-r--r-- 1.1 KiB
3bdbf439Simon Ser readme: add section about doc comment formatting 2 months ago

#gyosu

builds.sr.ht status

A simple C documentation generator.

#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