La Sfinge è già adatta alla documentazione C++?

Question

Voglio provare i generatori di documentazione per un nuovo progetto in C++. Penso che le mie opzioni siano Doxygen o Sfinge. Dato che ho progetti in Python per i quali mi piacerebbe usare Sphinx, mi chiedo se Sphinx sia la scelta giusta anche per C++. Il sito Web Sphinx afferma che C++ è supportato, ma non sono riuscito a trovare un documento per farmi iniziare con la documentazione C++.

Una domanda simile è già stato discussed on Stackoverflow e la risposta principale conclude:

non ancora completamente utilizzabile,
ma continuare a guardare

Dal momento che la discussione è ben più di un anno , Mi chiedo se questa conclusione sia ancora valida. Dovrei scegliere Doxygen over Sphinx per la mia documentazione C++?

Answer 1

Sphinx non può estrarre la documentazione dai sorgenti C++ da sola. Tuttavia, esistono estensioni, in particolare Breathe, che utilizzano Doxygen per estrarre la documentazione da C++. Non ho provato nessuno di questi.

Answer 2

Per C++ Doxygen è molto buono; Il supporto Sphinx di C++ è fatto tramite Doxygen (usando Breathe).

Si desidera avere un solo strumento per le due lingue, per migliorare la manutenibilità. Doxygen can generate a documentation from Python code, quindi ti consiglio di utilizzare Doxygen per entrambe le sorgenti, se possibile. Here is a tutorial for Doxygen and Python.