From: Sergey Matveev Date: Sun, 27 Sep 2020 09:39:38 +0000 (+0300) Subject: Выложил docstringer.pl X-Git-Url: http://www.git.stargrave.org/?a=commitdiff_plain;h=de290eaa23dc9d16296162f0ff52ed00f506e786;p=stargrave-blog.git Выложил docstringer.pl http://git.stargrave.org/cgit.cgi/dotfiles.git/tree/bin/bin/docstringer.pl Для доки C проектов я хочу использовать Texinfo (как и для всего). Но штатной какой-то интеграции, как у Sphinx с Python, нету. А хочется чтобы в C коде тоже была документация рядом с нужными функциями, переменными и типами, в виде docstring-ов. Не проблема, уже давно написал, но только сейчас закоммитил, утилиту для этого самопальную. В .[ch] файлах если встречается комментарий с TEXINFO: FooBar, то до его конца он будет считаться текстом FooBar. В .texi файле если будет встречен @DOCSTRING FooBar@, то это будет заменено на содержимое FooBar текста. Просто и эффективно. В Sphinx используются :py:... конструкции, а тут просто DOCSTRING. Утилита сканирует предоставленный C код, выпирсивает из него текст, а дальше парсит .texi, сохраняя его отренедеренное представление в отдельной директории из которой уже и будет делаться дока. Полгода это работает всё на ура. ---