FiveTech Support Forums

FiveWin / Harbour / xBase community
Board indexAll discussionsLogin (GitHub)
Board index FiveWin para Harbour/xHarbour Doxygen para PRG
quim
Posts: 56
Joined: Mon Apr 11, 2011 06:22 PM
Doxygen para PRG
Posted: Mon Jan 02, 2017 11:56 AM
Saludos foro y Feliz 2017 !!!

Alguien ha utilizado Doxygen http://www.stack.nl/~dimitri/doxygen/index.html para documentar fuentes en PRG ?

He realizado algunas pruebas, con archivos C o PHP funciona la generaci贸n de documentaci贸n, pero con los PRG no....

Puede ser con s贸lo funcione con los lenguajes que dice soportar ? (C, Objective-C, C#, PHP, Java, Python, IDL)

Saludos
Antonio Linares
Posts: 44158
Joined: Thu Oct 06, 2005 05:47 PM
Re: Doxygen para PRG
Posted: Mon Jan 02, 2017 12:16 PM

viewtopic.php?f=17t=27530start=0

&&

regards, saludos

Antonio Linares
www.fivetechsoft.com
quim
Posts: 56
Joined: Mon Apr 11, 2011 06:22 PM
Re: Doxygen para PRG
Posted: Mon Jan 02, 2017 12:26 PM

Antonio:

La documentaci贸n generada en los enlaces que muestras creo que s贸lo son para fuentes C o CPP

No veo que se pueda generar desde fuentes PRG

Saludos y gracias por la respuesta

Antonio Linares
Posts: 44158
Joined: Thu Oct 06, 2005 05:47 PM
Re: Doxygen para PRG
Posted: Mon Jan 02, 2017 12:33 PM
Esto puede ser 煤til:

https://sourceforge.net/p/scintilla/feature-requests/693/
regards, saludos

Antonio Linares
www.fivetechsoft.com
quim
Posts: 56
Joined: Mon Apr 11, 2011 06:22 PM
Re: Doxygen para PRG
Posted: Mon Jan 02, 2017 03:24 PM
OK reviso Scintilla, parece que es un editor de c贸digo no ?

Estoy utilizando Doxygen GUI frontend, tanto en Ubuntu 16 como en windows 10 con id茅ntico resultado

Ahora ya he podido generar documentaci贸n 'enga帽ando' un poco la configuraci贸n.

Editando a mano el fichero de configuraci贸n del proyecto, en mi caso Doxyfile (una especie de fichero INI), he cambiado las secciones :
Code (fw): Select all Collapse
EXTENSION_MAPPING = prg=c
FILE_PATTERNS  = *.c \
                         *.cc \
                         *.cpp \
                         *.c++ \
                         *.java \
                         *.h \
                         *.php \
                         *.prg


Ahora ya genera documentaci贸n (funciona el parser) ;
El siguiente paso ser谩 averiguar el l茅xico a tratar, ya que de momento s贸lo reconoce las palabras reservadas comunes a ambos lenguajes (function, for, while ... )
Seguiremos investigando, gracias !
Antonio Linares
Posts: 44158
Joined: Thu Oct 06, 2005 05:47 PM
Re: Doxygen para PRG
Posted: Mon Jan 02, 2017 11:55 PM

Te ha llegado a mostrar el gr谩fico ?

Puedes copiar la imagen aqu铆 ? gracias

regards, saludos

Antonio Linares
www.fivetechsoft.com
quim
Posts: 56
Joined: Mon Apr 11, 2011 06:22 PM
Re: Doxygen para PRG
Posted: Wed Jan 04, 2017 12:44 PM
Antonio,

Doxygen no muestra directamente ning煤n gr谩fico... Es necesario instalar graphviz http://www.graphviz.org

Los tests de Doxygen realizados con Windows han sido decepcionantes ... muestra a duras penas el 谩rbol de PRG de la aplicaci贸n y la documentaci贸n generada no supera el reconocer un par de defines

En cambio con Ubuntu, aparece documentaci贸n, de forma algo ca贸tica, pero puede ser un punto de partida.
Graphviz ha generado las dependencias de forma gr谩fica, integrando imagen en el HTML final.
No he conseguido que haga caso a los 'comandos' de Doxygen, como son brief, file, author,... ni que documente una funci贸n
Code (fw): Select all Collapse
/** 
聽 @brief 聽Aplicacion Clase TProgram 聽 聽
聽 @file 聽 PROGRAM.PRG 聽 
聽 @author (C)2.016 JFG 
聽 @date 聽 30/12/2016 
聽*/
/**
聽 @brief 聽funcion para traducir textos

聽 El diccionario se cargar谩 desde una tabla de mensajes -> struct : Message, spanish, english, ...
聽 Id corresponde al idioma por defecto que est谩 en el codigo de Getex...
聽*/


Dejo algunas im谩genes ...


cnavarro
Posts: 6755
Joined: Wed Feb 15, 2012 08:25 PM
Re: Doxygen para PRG
Posted: Wed Jan 04, 2017 02:49 PM

Puedes explicar, brevemente, como usar Doxygen y Graphviz?
Es por linea de comandos?

Cristobal Navarro

Hay dos tipos de personas: las que te hacen perder el tiempo y las que te hacen perder la noci贸n del tiempo

El secreto de la felicidad no est谩 en hacer lo que te gusta, sino en que te guste lo que haces
quim
Posts: 56
Joined: Mon Apr 11, 2011 06:22 PM
Re: Doxygen para PRG
Posted: Wed Jan 04, 2017 04:10 PM
Cristobal,
Doxygen funciona desde la linea de comandos pero tienes una GUI que te facilita el trabajo llamada Doxywizard
Todo es multiplataforma, tienes instaladores para Windows tipo setup.exe o paquetes deb (debian, en mi caso Ubuntu)
La herramienta graphviz es llamada desde esta GUI, te dejo unas im谩genes
Saludos


cnavarro
Posts: 6755
Joined: Wed Feb 15, 2012 08:25 PM
Re: Doxygen para PRG
Posted: Wed Jan 04, 2017 05:00 PM

Gracias
Yo me habia descargado en .ZIP y no lo encontraba

Cristobal Navarro

Hay dos tipos de personas: las que te hacen perder el tiempo y las que te hacen perder la noci贸n del tiempo

El secreto de la felicidad no est谩 en hacer lo que te gusta, sino en que te guste lo que haces

Continue the discussion

Static archive 路 New replies & topics via GitHub Discussions