¿Qué alternativa a Doxygen usaría Dave DeLong?

Question

Aquí hay una manera segura de recibir una votación negativa, patear y reír, pero voy a intentarlo de todos modos.

Ayer Dave DeLong respondió a question of mine. No era la respuesta que estaba buscando, pero en la pregunta mencionó una forma alternativa de generar documentación al estilo de Doxygen para Objective-C.

Antes de que pudiera verlo, alguien (quizás el mismo Dave) notó que la respuesta no encajaba bien con la pregunta y la eliminó. * poof * ido fue el enlace a esa herramienta de documentación.

No recuerdo el nombre, pero estoy bastante seguro de que no es ni HeaderDoc ni Doxygen en sí.

Dave, ¿estás por ahí? ¿Cuál fue ese enlace otra vez?

Que los dioses de la venganza sean amables conmigo. Saludos a todos,
EP

P.S. ¿Dónde está de nuevo el botón "enviar un mensaje a este usuario" en stackoverflow? : S

Answer 1

Claramente no soy Dave DeLong, pero usaría appledoc, ¡es bastante impresionante!

Page del Desarrollador cita:

appledoc es la herramienta de línea de comandos que ayuda a los desarrolladores de Objective-C generan Apple-como en la documentación del código fuente de un formato especial código fuente comentarios. Está diseñado para tener como comentarios legibles código fuente como posible para la entrada y usar comentarios, así como los alrededores código fuente para generar visualmente atractivo documentación en forma de HTML como así como todo el contenido indexado y navegable conjunto de documentación Xcode . Aunque hay varias herramientas que pueden crear documentación HTML para Objective-C, todas las que conozco no cumplen con los objetivos mínimos que se describen a continuación.

Humano fuente legible código appledoc está diseñado para mantener la fuente comentarios de código tan legible como sea posible incluso dentro de su editor de código fuente.

referencias cruzadas a los objetos y miembros Creación de referencias cruzadas a clases, categorías o protocolos es sencillo y automatizado tanto como sea posible.

de Apple como el código fuente HTML de la documentación Generar apelando documentación HTML con el mismo estilo que las de Apple .

Xcode conjunto de documentación creación Generar e instalar completamente indexados y conjuntos de documentación de Xcode navegables. El conjunto de documentación también puede ser instalado automáticamente en Xcode.

Una única herramienta de código sorce a doc establece Una única herramienta para impulsar la generación de desde el código fuente de análisis de la instalación conjunto documentación

fácilmente personalizable salida appledoc le da una gran cantidad de comandos línea de interruptores para que puede parametrizar la salida . Si esto no es suficiente, puede cambiar cualquiera o todos los archivos de plantilla para satisfacer sus necesidades.

100% ejecución de Objective-C Todo el appledoc está escrito en Objective-C, por lo que puede cambiar fácilmente que el uso del lenguaje y las herramientas familiar. Esto también hace que la depuración sea mucho más simple y efectiva.