Doxygen - Historial de revisiones

Javiermartin jc: Texto reemplazado: «
» por «»

2019-06-20T18:48:14Z

Texto reemplazado: «<div align="justify">» por «»

Rolando GT: /* Enlaces externos */

2015-07-09T15:15:45Z

‎Enlaces externos

Sancristobal2 jc en 17:59 16 oct 2011

2011-10-16T17:59:18Z

Maydelys art.jc en 16:10 23 mar 2011

2011-03-23T16:10:33Z

Maydelys art.jc en 16:03 23 mar 2011

2011-03-23T16:03:49Z

Maydelys art.jc en 16:02 23 mar 2011

2011-03-23T16:02:13Z

Alina ciget.gra en 18:47 16 mar 2011

2011-03-16T18:47:24Z

Alina ciget.gra en 18:45 16 mar 2011

2011-03-16T18:45:31Z

Alina ciget.gra en 18:43 16 mar 2011

2011-03-16T18:43:42Z

Alina ciget.gra en 18:37 16 mar 2011

2011-03-16T18:37:43Z

@@ Línea 26: / Línea 26: @@
 |web=
 }}
-<div align="justify">'''Doxygen'''. Es de uso fácil por lo que es la herramienta ideal para ser usada con principiantes. Es un [[Generador de documentación|generador de documentación]] para [[C++|C++]],[[C|C]], [[Java|Java]], [[Objective-C|Objective-C]], [[Python|Python]], [[IDL|IDL]] (versiones Corba y Microsoft) y en cierta medida para [[PHP|PHP]], C# y D. Dado que es fácilmente adaptable, funciona en la mayoría de Sistemas [[Unix]] así como en [[Windows|Windows]] y [[Mac OS X|Mac OS X]]. La mayor parte del código de Doxygen está escrita por Dimitri van Heesch.</div>
+'''Doxygen'''. Es de uso fácil por lo que es la herramienta ideal para ser usada con principiantes. Es un [[Generador de documentación|generador de documentación]] para [[C++|C++]],[[C|C]], [[Java|Java]], [[Objective-C|Objective-C]], [[Python|Python]], [[IDL|IDL]] (versiones Corba y Microsoft) y en cierta medida para [[PHP|PHP]], C# y D. Dado que es fácilmente adaptable, funciona en la mayoría de Sistemas [[Unix]] así como en [[Windows|Windows]] y [[Mac OS X|Mac OS X]]. La mayor parte del código de Doxygen está escrita por Dimitri van Heesch.</div>
 == El generador de documentación de código fuente Doxygen  ==
 [[Image:Codigo2.jpeg|thumb|left|Codigo2.jpeg]]
-<div align="justify">Es una buena ocasión para presentar muy brevemente un utilitario que no puede faltar en ninguna «caja de herramientas» de un buen programador. Doxygen es un programa que permite documentar fácilmente el código a través de un sistema de «comentarios-tags». Así por ejemplo, los usuarios de [[Javadoc|Javadoc]],&nbsp; encontraran que disponen de un procedimiento de 170 tags por defecto, en un sistema que les permitirá agregar los propios a los efectos de responder a las necesidades de un proyecto.</div> <div align="justify">Aparte de ello, de la documentación de las fuentes (prototipo de funciones, de las clases) podemos obtener las siguientes informaciones:</div>
+Es una buena ocasión para presentar muy brevemente un utilitario que no puede faltar en ninguna «caja de herramientas» de un buen programador. Doxygen es un programa que permite documentar fácilmente el código a través de un sistema de «comentarios-tags». Así por ejemplo, los usuarios de [[Javadoc|Javadoc]],&nbsp; encontraran que disponen de un procedimiento de 170 tags por defecto, en un sistema que les permitirá agregar los propios a los efectos de responder a las necesidades de un proyecto.</div> Aparte de ello, de la documentación de las fuentes (prototipo de funciones, de las clases) podemos obtener las siguientes informaciones:</div>
 *Listado de archivos incluidos
 *Documentación de las estructuras de datos
@@ Línea 37: / Línea 37: @@
 *Un index de todos los identificadores
 *Los archivos fuente anotados
-<div align="justify">Toda la documentación producida generalmente es en formato [[HTML|HTML]], a causa de su facilidad de utilización, sin embargo también es posible obtener archivos de formato LATEX, [[PostScript|PostScript]], [[PDF|PDF]], [[XML|XML]], man e incluso [[Word|Word]] y [[CHM|CHM]]. Una gran parte de Doxygen ha sido escrita por Dimitri van Heesch, quien en su época encontraba a la documentación generada por Qt como muy bonita y doc++ como demasiado limitada para un trabajo similar. Hoy, Doxygen soporta [[C/C++|C/C++]], [[Java|Java]] ([[Corba|Corba]] y [[Microsoft|Microsoft]]) [[Java|Java]], [[Python|Python]], [[IDL|IDL]], C#, Objetive-C y en parte D y&nbsp;&lt;span style="text-decoration: underline;" /&gt;PHP. Doxygen esta distribuido bajo licencia [[GNU|GNU ]][[GPL|GPL]], esta disponible un binario para [[Windows 95|Windows 95]] / XP y para [[Mac OS X|Mac OS X]], pero necesita la librería libqt.</div>
+Toda la documentación producida generalmente es en formato [[HTML|HTML]], a causa de su facilidad de utilización, sin embargo también es posible obtener archivos de formato LATEX, [[PostScript|PostScript]], [[PDF|PDF]], [[XML|XML]], man e incluso [[Word|Word]] y [[CHM|CHM]]. Una gran parte de Doxygen ha sido escrita por Dimitri van Heesch, quien en su época encontraba a la documentación generada por Qt como muy bonita y doc++ como demasiado limitada para un trabajo similar. Hoy, Doxygen soporta [[C/C++|C/C++]], [[Java|Java]] ([[Corba|Corba]] y [[Microsoft|Microsoft]]) [[Java|Java]], [[Python|Python]], [[IDL|IDL]], C#, Objetive-C y en parte D y&nbsp;&lt;span style="text-decoration: underline;" /&gt;PHP. Doxygen esta distribuido bajo licencia [[GNU|GNU ]][[GPL|GPL]], esta disponible un binario para [[Windows 95|Windows 95]] / XP y para [[Mac OS X|Mac OS X]], pero necesita la librería libqt.</div>
 == Soporte comercial  ==
@@ Línea 48: / Línea 48: @@
 [[Image:Resumen.jpeg|thumb|left|Resumen.jpeg]]
-<div align="justify">Para la mayor parte de los programadores la codificación de algoritmos es la parte más interesante de la construcción de programas; los mismos trabajan creando mundos virtuales, en donde todas las variables coexisten bajo un perfecto control: esta es la parte más creativa del trabajo del programador. Para construir programas se desde las&nbsp; estructuras de datos y algoritmos avanzados, hasta la aplicación de convenciones como las descritas en [[DiM-1988|DiM-1988]], que facilitan la labor y mantenimiento del programa.</div> <div align="justify">El camino más sencillo es que al escribir su implementación, se debe&nbsp; cumplir siempre con estas 3 políticas de programación.</div><div align="justify"></div><div align="justify"></div>
+Para la mayor parte de los programadores la codificación de algoritmos es la parte más interesante de la construcción de programas; los mismos trabajan creando mundos virtuales, en donde todas las variables coexisten bajo un perfecto control: esta es la parte más creativa del trabajo del programador. Para construir programas se desde las&nbsp; estructuras de datos y algoritmos avanzados, hasta la aplicación de convenciones como las descritas en [[DiM-1988|DiM-1988]], que facilitan la labor y mantenimiento del programa.</div> El camino más sencillo es que al escribir su implementación, se debe&nbsp; cumplir siempre con estas 3 políticas de programación.</div></div></div>
 <br>
@@ Línea 66: / Línea 66: @@
 [[Image:Configuración.jpeg|thumb|right]] Doxygen es un sistema de documentación para [[C++|C++]], C, [[Java|Java]], Objective-C, Python, IDL (Corba y los sabores
-<div align="justify">[[Microsoft|Microsoft]]) y, hasta cierto punto, para [[PHP|PHP]], C# y D. La ventaja principal de usar Doxygen en los cursos universitarios es que le permite al estudiante obtener entrenamiento en el uso herramientas que ayudan a generar documentación con la ventaja adicional de que Doxygen es aplicable a un rango muy amplio de lenguajes, lo que no ocurre con herramientas de aplicación específica como [[Javadoc|Javadoc]] [[KNDK-1997|NDK-1997]]. Cuando el estudiante termina sus estudios universitarios y pase a su carrera profesional, su entrenamiento Doxygen le permitirá usar con comodidad cualquier otra herramienta de documentación, inclusive Javadoc, cuyo formato es compatible con Doxygen.</div>
+[[Microsoft|Microsoft]]) y, hasta cierto punto, para [[PHP|PHP]], C# y D. La ventaja principal de usar Doxygen en los cursos universitarios es que le permite al estudiante obtener entrenamiento en el uso herramientas que ayudan a generar documentación con la ventaja adicional de que Doxygen es aplicable a un rango muy amplio de lenguajes, lo que no ocurre con herramientas de aplicación específica como [[Javadoc|Javadoc]] [[KNDK-1997|NDK-1997]]. Cuando el estudiante termina sus estudios universitarios y pase a su carrera profesional, su entrenamiento Doxygen le permitirá usar con comodidad cualquier otra herramienta de documentación, inclusive Javadoc, cuyo formato es compatible con Doxygen.</div>
 == Ejemplo 1  ==
 PROJECT_NAME = "Prueba de la clase rational:"<br> OUTPUT_LANGUAGE = Spanish<br> OUTPUT_DIRECTORY = .<br> GENERATE_LATEX = NO<br> GENERATE_MAN = NO<br> GENERATE_RTF = NO<br> CASE_SENSE_NAMES = YES<br> INPUT_ENCODING = ISO-8859-1<br> INPUT = rational.h rational.cpp rat-calc.cpp \rat-tst.cpp ADH_port.h<br> RECURSIVE = NO<br> QUIET = YES<br> JAVADOC_AUTOBRIEF = YES<br> EXTRACT_ALL = YES<br> EXTRACT_PRIVATE = YES<br> EXTRACT_STATIC = YES<br> EXTRACT_LOCAL_CLASSES = YES<br> INLINE_INHERITED_MEMB = YES<br> SOURCE_BROWSER = YES<br> INLINE_SOURCES = NO<br> STRIP_CODE_COMMENTS = NO<br> REFERENCED_BY_RELATION= NO<br> REFERENCES_RELATION = NO<br> FULL_PATH_NAMES = NO<br> SORT_MEMBER_DOCS = NO<br> SORT_BRIEF_DOCS = NO<br> CLASS_DIAGRAMS = YES<br> ENABLE_PREPROCESSING = YES<br> MACRO_EXPANSION = YES<br> EXPAND_ONLY_PREDEF = YES<br> PREDEFINED = "DOXYGEN_COMMENT" \<br> &nbsp;"Spanish_dox" \<br> "__cplusplus" \<br> "_MSC_VER=1300" \<br> "OPEN_namespace(N)=namespace N {" \<br> "CLOSE_namespace(N)=}" \<br> "USIGN_namespace(N)=using namespace N"<br>
-<div align="justify">El ejemplo 1 muestra el archivo "rat-tst.dxg" que se puede usar de plantilla para obtener el archivo de configuración para que Doxygen genere la documentación de uno o más módulos. Para esto, basta modificar únicamente el renglón "INPUT" que contiene la lista de archivos de donde Doxygen extraerá la documentación. En este ejemplo, Doxygen generó documentación usando como entrada los siguientes archivos: "rational.h", "rational.cpp", "rat-calc.cpp", "rat-tst.cpp" y "ADH_port.</div>
+El ejemplo 1 muestra el archivo "rat-tst.dxg" que se puede usar de plantilla para obtener el archivo de configuración para que Doxygen genere la documentación de uno o más módulos. Para esto, basta modificar únicamente el renglón "INPUT" que contiene la lista de archivos de donde Doxygen extraerá la documentación. En este ejemplo, Doxygen generó documentación usando como entrada los siguientes archivos: "rational.h", "rational.cpp", "rat-calc.cpp", "rat-tst.cpp" y "ADH_port.</div>
 == Ejemplo 2  ==
@@ Línea 92: / Línea 92: @@
 } // mcd()
-<div align="justify">El estilo Doxygen de documentación es bastante simple e intuitivo, como se muestra en el ejemplo 2. Para usar&nbsp; la&nbsp; herramienta se tendra en cuenta lo siguiente:<br>
+El estilo Doxygen de documentación es bastante simple e intuitivo, como se muestra en el ejemplo 2. Para usar&nbsp; la&nbsp; herramienta se tendra en cuenta lo siguiente:<br>
 *La documentación Doxygen comienza con el marcador de principio de comentario "/**" y termina en "*/". Esto permite mezclar la documentación con el código fuente lo que ayuda mucho a que la documentación quede actualizada cuando se le da mantenimiento a un módulo.

← Revisión anterior		Revisión del 15:15 9 jul 2015
Línea 112:		Línea 112:
	*http://www.doxygen.org/manual.html		*http://www.doxygen.org/manual.html

−	~~[[Category:Ciencias_Aplicadas_y_Tecnologías]]~~ [[Category:Ciencias_informáticas_y_Telecomunicaciones]] [[Category:Ciencias_informáticas]] [[Category:Software]]	+	[[Category:Ciencias_informáticas_y_Telecomunicaciones]] [[Category:Ciencias_informáticas]] [[Category:Software]]

@@ Línea 26: / Línea 26: @@
 |web=
 }}
-<div align="justify">'''Doxygen'''. Es de uso fácil por lo que es la herramienta ideal para ser usada con principiantes. Es un [[Generador de documentación|generador de documentación]] para [[C++|C++]],[[C|C]], [[Java|Java]], [[Objective-C|Objective-C]], [[Python|Python]], [[IDL|IDL]] (versiones Corba y Microsoft) y en cierta medida para [[PHP|PHP]], C# y D. Dado que es fácilmente adaptable, funciona en la mayoría de [[Sistemas Unix|sistemas Unix]] así como en [[Windows|Windows]] y [[Mac OS X|Mac OS X]]. La mayor parte del código de Doxygen está escrita por Dimitri van Heesch.</div>
+<div align="justify">'''Doxygen'''. Es de uso fácil por lo que es la herramienta ideal para ser usada con principiantes. Es un [[Generador de documentación|generador de documentación]] para [[C++|C++]],[[C|C]], [[Java|Java]], [[Objective-C|Objective-C]], [[Python|Python]], [[IDL|IDL]] (versiones Corba y Microsoft) y en cierta medida para [[PHP|PHP]], C# y D. Dado que es fácilmente adaptable, funciona en la mayoría de Sistemas [[Unix]] así como en [[Windows|Windows]] y [[Mac OS X|Mac OS X]]. La mayor parte del código de Doxygen está escrita por Dimitri van Heesch.</div>
 == El generador de documentación de código fuente Doxygen  ==

@@ Línea 49: / Línea 49: @@
 [[Image:Resumen.jpeg|thumb|left|Resumen.jpeg]]
 <div align="justify">Para la mayor parte de los programadores la codificación de algoritmos es la parte más interesante de la construcción de programas; los mismos trabajan creando mundos virtuales, en donde todas las variables coexisten bajo un perfecto control: esta es la parte más creativa del trabajo del programador. Para construir programas se desde las&nbsp; estructuras de datos y algoritmos avanzados, hasta la aplicación de convenciones como las descritas en [[DiM-1988|DiM-1988]], que facilitan la labor y mantenimiento del programa.</div> <div align="justify">El camino más sencillo es que al escribir su implementación, se debe&nbsp; cumplir siempre con estas 3 políticas de programación.</div><div align="justify"></div><div align="justify"></div>
 #El programa debe estar correctamente identificado y&nbsp; las instrucciones&nbsp; debidamente espaciadas.
 #Todo el programa debe tener una buena documentación interna.

@@ Línea 48: / Línea 48: @@
 [[Image:Resumen.jpeg|thumb|left|Resumen.jpeg]]
-<div align="justify">Para la mayor parte de los programadores la codificación de algoritmos es la parte más interesante de la construcción de programas; los mismos trabajan creando mundos virtuales, en donde todas las variables coexisten bajo un perfecto control: esta es la parte más creativa del trabajo del programador. Para construir programas se desde las&nbsp; estructuras de datos y algoritmos avanzados, hasta la aplicación de convenciones como las descritas en [[DiM-1988|DiM-1988]], que facilitan la labor y mantenimiento del programa.</div> <div align="justify">El camino más sencillo es que al escribir su implementación, se debe&nbsp; cumplir siempre con estas 3 políticas de programación.</div><div align="justify"></div>
+<div align="justify">Para la mayor parte de los programadores la codificación de algoritmos es la parte más interesante de la construcción de programas; los mismos trabajan creando mundos virtuales, en donde todas las variables coexisten bajo un perfecto control: esta es la parte más creativa del trabajo del programador. Para construir programas se desde las&nbsp; estructuras de datos y algoritmos avanzados, hasta la aplicación de convenciones como las descritas en [[DiM-1988|DiM-1988]], que facilitan la labor y mantenimiento del programa.</div> <div align="justify">El camino más sencillo es que al escribir su implementación, se debe&nbsp; cumplir siempre con estas 3 políticas de programación.</div><div align="justify"></div><div align="justify"></div>
 #El programa debe estar correctamente identificado y&nbsp; las instrucciones&nbsp; debidamente espaciadas.
 #Todo el programa debe tener una buena documentación interna.

@@ Línea 59: / Línea 59: @@
 == Configuración Doxygen  ==
-[[Image:Configuración.jpeg|thumb|right|Configuración.jpeg]] Doxygen es un sistema de documentación para [[C++|C++]], C, [[Java|Java]], Objective-C, Python, IDL (Corba y los sabores
+[[Image:Configuración.jpeg|thumb|right]] Doxygen es un sistema de documentación para [[C++|C++]], C, [[Java|Java]], Objective-C, Python, IDL (Corba y los sabores
-<div align="justify">[[Microsoft|Microsoft]]) y, hasta cierto punto, para [[PHP|PHP]], C# y D. La ventaja principal de usar Doxygen en los cursos universitarios es que le permite al estudiante obtener entrenamiento en el uso herramientas que ayudan a generar documentación con la ventaja adicional de que Doxygen es aplicable a un rango muy amplio de lenguajes, lo que no ocurre con herramientas de aplicación específica como [[Javadoc|Javadoc]] [[[[[[[KNDK-1997|KNDK-1997]]|[[KNDK-1997|KNDK-1997]]]]|[[KNDK-1997|KNDK-1997]]]]]. Cuando el estudiante termina sus estudios universitarios y pase a su carrera profesional, su entrenamiento Doxygen le permitirá usar con comodidad cualquier otra herramienta de documentación, inclusive Javadoc, cuyo formato es compatible con Doxygen.</div>
+<div align="justify">[[Microsoft|Microsoft]]) y, hasta cierto punto, para [[PHP|PHP]], C# y D. La ventaja principal de usar Doxygen en los cursos universitarios es que le permite al estudiante obtener entrenamiento en el uso herramientas que ayudan a generar documentación con la ventaja adicional de que Doxygen es aplicable a un rango muy amplio de lenguajes, lo que no ocurre con herramientas de aplicación específica como [[Javadoc|Javadoc]] [[KNDK-1997|NDK-1997]]. Cuando el estudiante termina sus estudios universitarios y pase a su carrera profesional, su entrenamiento Doxygen le permitirá usar con comodidad cualquier otra herramienta de documentación, inclusive Javadoc, cuyo formato es compatible con Doxygen.</div>
 == Ejemplo 1  ==