Discussion :

[knopix77]

Bonjour a tous,

J'aimerai savoir si QtCreator intègre un plugin pour mettre automatiquement les commentaires Doxygen dans le code à la manière de Eclipse pour la javadoc ??

Parce que c'est long de ce taper toutes la doc à la main

Sinon est ce que vous connaissez un outils pour le faire indépendamment de Qtcreator



Pour être plus explicite, je voudrais un truc comme ca :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

int foo( double value);

ca devient

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
/**
  * @fn foo fonction test
  * @param value valeur de test
  * @return un int
  */
int foo( double value);

à l'aide d'un raccourci clavier

[sardik]

Je ne pense pas que cela existe, tu dois te "taper" la documentation à la main.

[knopix77]

Bon tant pis je continue a chercher si je trouve quelque chose je le posterai.

[Gulish]

Voila une bonne idée de plug-in à développer .

Si tu trouves en effet quelquechose, merci de le partager !

G.

[knopix77]

Bon alors j'ai trouvé un petit plugin pour gVim :
http://www.vim.org/scripts/script.php?script_id=674

Il suffit de sélectionner la ligne de la fonction à commenter et de taper ox



Pour les fainéants (comme moi ) une petite commande à taper dans gVim :
":map <F2> ox<CR><Esc>"

Comme ça juste a ouvrir le source avec gVim a cliquer sur les lignes voulu et d'appuyer sur F2 ça génère bien le squelette doxygen.


Je continue à chercher on sait jamais ^^

[kofee]

Bonsoir,

J'étais dans le même cas et à force de ne pas trouver j'ai fini par mettre les mains dans le cambouis ce matin.

Attention le code est vraiment dégueulasse pour l'instant mais ça fait le job dans la plupart des cas je pense (je n'ai pas tout tout testé encore).

http://dev.kofee.org/QtCreator-Doxygen/

Voila, si ça intéresse

[yan]

Bonsoir,

J'étais dans le même cas et à force de ne pas trouver j'ai fini par mettre les mains dans le cambouis ce matin.

Attention le code est vraiment dégueulasse pour l'instant mais ça fait le job dans la plupart des cas je pense (je n'ai pas tout tout testé encore).

http://dev.kofee.org/QtCreator-Doxygen/

Voila, si ça intéresse

très très interessant. Justement, si y as bien un truc qui manque c'est cela!!!!
Par contre j'ai découvert (tous à l'heure) qu'il y as déjà l'auto complétion doxygen. Mais rien d'automatique

Peut tu expliquer un peu plus ce que fait ton plugin et comment l'ajouter à QtCreator?
C'est compliqué de créer un plugin pour QtCreator?

[kofee]

Oui justement en codant ça je suis tombé sur des gros fichiers de définition pour Doxygen qui annoncent un support digne de ce nom (mais quand :-?)

Alors pour ce que fait le plugin, bon, déjà il s'instancie et c'est déjà pas mal, mais après il installe une action avec un raccourci clavier et une entrée dans le menu contextuel de l'éditeur C++. Après ça la méthode de génération de doc est appelée à la demande, elle obtient la postion du curseur et à partir de la on peut retrouver le texte et analyser tout ça. (voir le site et le code pour le reste pour l'instant vu que je commence juste :p)

C'est pas facile facile de faire un plugin tierce partie pour l'instant puisque le plus gros de leur API n'est pas exposée directement et clairement (ou de manière pratique et documentée... mais ça va venir je leur fais confiance). Donc on se retrouve avec des tonnes d'inclusions et de paramètres à passer au linker. Sans compter l'exploration des namespace qui foisonnent... bien codé leur truc

D'où mon approche dégueulasse actuelle avant de trouver exactement sur quels boutons appuyer pour que ce soit propre. Puisque je suis sûr que la plupart des fonctions demandées pour réaliser cette tâche sont déjà codées dedans mais pas relièes. Mais ça fait du bien de plus taper tout le squelette à la main :-D

Pour les gens sous Linux ça va être facile à installer, mais pour Windows le linker gueule pour l'instant chez moi... je vais voir si je peux faire des binaires win32, mais 64bits je pourrais pas...


Edit2: bibliothèque binaire pour qtcreator-1.3.0-rc1 win32 disponible http://dev.kofee.org/QtCreator-Doxyg...2.0.0.1-r8.zip

[kofee]

Il ne manque plus que des testeurs et des suggestions (seulement sur les fonctionnalités, pour la propreté du code c'est déjà commencé mais pas commit )

[Luc Hermitte]

Bon alors j'ai trouvé un petit plugin pour gVim :
http://www.vim.org/scripts/script.php?script_id=674

A ce compte là, le mien détecte le sens des paramètres, la présence de spécifications d'exception (des fois des gens on de drôles d'idées...), s'il y a un type de retour ou non, et le style est configurable.

[gbdivers]

Bonjour Kofee

Quelques petites modifications que j'ai du faire pour compiler avec la version 1.3.80 de Qt Creator (version de développement).

Dans src/shared/cplusplus/CppDocument.h :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

Document::Ptr CPlusPlus::Snapshot::value(const QString &fileName) const;

n'existe plus et devient:

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

Document::Ptr CPlusPlus::Snapshot::document(const QString &fileName) const;

Dans src/shared/cplusplus/Symbol.h :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

Name* CPlusPlus::Symbol::name() const;

devient :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

const Name* CPlusPlus::Symbol::name() const;

il faut donc changer le fichier doxygen.cpp :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
ligne 86  : Name *name = owner->name();
ligne 106 : Document::Ptr doc = snapshot.value(editor->file()->fileName());
ligne 170 : Name *name = lastSymbol->name();

en :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
ligne 86  : const Name *name = owner->name();
ligne 106 : Document::Ptr doc = snapshot.document(editor->file()->fileName());
ligne 170 : const Name *name = lastSymbol->name();

Peut être à ajouter :
* visualiser les pages html dans Qt Creator (mise à jour automatiquement de la page consultée) pour permettre de passer directement entre le code et la documentation générée.
* ajouter une barre de progression semblable à celle qui apparait lorsque l'on compile en bas à gauche (utiliser la classe ProgressManager)

EDIT : et pourquoi pas un éditeur graphique de doc doxygen ? tu génères la doc en html à partir des fichiers sources et tu ajoutes de boutons d'édition dans le code html et tu affiches tout ça dans Qt creator. Ca serait pas mal

Un plugin vraiment intéressant.

[mak972]

Bonjour,

J'ai essayer de compiler ton plugin pour Mac mais il manque des headers.
Tous les headers :
- coreplugin
- plugins
- libs

Je pense qu'il me manque des librairies pour compiler pour des plugins pour ce dernier ou bien elle sont placer a un autre endroit.

[yan]

Salut

Bonjour,

J'ai essayer de compiler ton plugin pour Mac mais il manque des headers.
Tous les headers :
- coreplugin
- plugins
- libs

Je pense qu'il me manque des librairies pour compiler pour des plugins pour ce dernier ou bien elle sont placer a un autre endroit.

A mon avis, il faut que tu parte des source de QtCreator pour faire un plugin. A moins que tous sois fournie dans les repertoir de QtCreator.