Использование Sphinx apidoc для создания документации из кода C++

В прошлом было несколько тем на эту тему, в которых утверждалось, что Sphinx вообще не поддерживает это. У меня были сомнения, но либо он был обновлен с тех пор, либо документация для него была довольно хорошо скрыта, потому что вот ссылка на веб-сайте, утверждающая обратное: http://sphinx.pocoo.org/latest/domains.html#array:T:::subscript-operatorC

Так или иначе, я новичок в Sphinx, но пытаюсь использовать его для (в конечном счете )автоматизации документирования, используя некоторый текст из некоторого исходного кода C++. До сих пор я не мог ничего добиться при использовании команды sphinx -apidoc -o....... Создается почти пустой документ. Вероятно, я использую неправильные директивы, так как не знаю, как -вспомогательная документация не смогла мне помочь.

Может ли кто-нибудь помочь с основными шагами, необходимыми для его работы? Если невозможно -автоматически генерировать документацию из C++, для чего нужны домены C++ и как их использовать?

22
задан mzjn 29 June 2012 в 16:53
поделиться