doxygen

Una de las nuevas características de Xcode 5 es la capacidad de documentar su propio código con una sintaxis de comentario e ... un subconjunto de esas características. ¿Qué comandos son compatibles y cuáles no? ¿Alguno de sus usos difiere de Doxygen?

El sentido común dice que los bloques de comentarios Doxygen tienen que ser puestos en los archivos de cabecera donde están l ... entarios no están en los archivos de cabecera donde están las declaraciones. Entonces, ¿qué piensas y posiblemente sugieres?

Soy nuevo en la programación en general, así que decidí que comenzaría haciendo una clase vectorial simple en C++. Sin embar ... ento por tantas preguntas, pero no he encontrado un libro sobre C++ que responda satisfactoriamente a este tipo de preguntas.

Me gusta que doxygen cree documentación de código C o PHP. Tengo un próximo proyecto de Python y creo recordar que Python no ... o con doxygen, ¿cómo puedo usarlo para producir mi documentación de Python? ¿Hay algo en particular que deba tener en cuenta?

Hice documentación para mi SDK, usando Doxygen. Contiene la lista de archivos, espacios de nombres, clases, tipos, etc. - tod ... ngún elemento de código. Quiero colocar esta introducción en la página de inicio de la documentación. ¿Cómo puedo hacer esto?

He estado buscando algún material que describa cómo generar diagramas de clases simples con doxygen, pero no pude encontrar u ... a partir de un conjunto de archivos C++. Si hay mejores herramientas para lograr esto más fácil, por favor hágamelo saber.

Acabo de darme cuenta de un artículo en CACM que Doxygen funciona con Java (y varios otros lenguajes) también. Pero Java ya t ... son los pros y los contras de cualquiera de los dos enfoques? Son mutuamente excluyentes? ¿Hay un plugin Maven para Doxygen?

Estoy trabajando en un proyecto donde una biblioteca de c++/cli se está utilizando principalmente desde una aplicación de c#. ... c# (y dentro de c++/cli, por supuesto)? ¿Cuál es su opinión sobre los comentarios XML vs doxygen vs otras herramientas (que)?

¿Hay alguna guía sobre cómo las plantillas de C++ y las meta-funciones de plantilla deben documentarse con Doxygen? Por eje ... a la metafunción? Hace ¿alguien tiene buenas sugerencias o preferencias personales para usar Doxygen con plantillas de C++?

Me gustaría agregar archivos personalizados (no del proyecto) para generar algunas páginas adicionales con Doxygen. Estoy (no estaba) seguro de cómo deben nombrarse estos archivos y cómo debe formatearse su contenido.

Cuando genero la documentación de Doxygen en formato PDF, obtengo muchos archivos diferentes con un solo diagrama en cada uno ... mo la versión HTML? ¿Es posible obtenerlo automáticamente, es decir, sin tratar manualmente los archivos latex? Gracias!

Estoy tratando de averiguar si hay una manera de crear una etiqueta personalizada usando Doxygen. Encontré la opción de archi ... o lo hace para los comandos \bug y \todo para las líneas que tienen esta etiqueta personalizada. Es esto posible con Doxygen?

La documentación de Doxygen indica que puedo usar PHP Markdown Extra title labelling en un archivo markdown, pero tampoco # ... arte de un lenguaje específico? EDIT: he habilitado el soporte markdown, y el archivo aparece en las páginas referenciadas.

Quiero que Doxygen ignore, bypass, no busque en los siguientes directorios de mi proyecto: */.svn/* */docs/* */Properties/* ... te algo que funcione)? Estoy usando el Asistente Doxygen en Windows 7 en la plataforma de CPU de 64 bits, y Doxygen 1.7.3.

Quiero probar generadores de documentación para un nuevo proyecto en C++. Creo que mis opciones son Doxygen o Sphinx. Dado qu ... e un año, me pregunto si esta conclusión sigue siendo válida. ¿Debo elegir Doxygen sobre Sphinx para mi documentación de C++?

¿Cómo puedes ignorar archivos de Doxygen de forma similar a los de Git .git/info/exclude? Doxygen genera documentos para mí ... terceros como el componente de correo electrónico y de mi Git-repo, que no quiero. Necesito guardar los archivos donde están.

Estamos compilando documentos Doxygen en el servidor travis-ci y queremos enviarlos a nuestra rama gh-pages. ¿Cómo manejo l ... guien tiene un ejemplo para usar variables cifradas en travis-ci? ¿Debo optar por una autorización https o por una clave SSH?

Estoy buscando un complemento de eclipse para la documentación del código doxygen. He encontrado el eclox-plugIn ( http://hom ... , debería generar: /*! \brief ... \param p1 ... .. */ PS Estoy usando principalmente para los lenguajes c / c++

He documentado todas mis clases y ahora quiero integrar un ejemplo de cómo usar estas clases. ¿Cómo hago eso?

¿Cuál es la diferencia entre \param[out] y \return en Doxygen? Ambos parecen documentar la salida / retorno de una función. ¿La diferencia se debe a las funciones void que no tienen un valor de retorno y solo param[out] sería válida?