|
|
|
|
|
- Présentation
- Documentation automatique
- Paramétrage
- Que contiennent les commentaires ?
- Remarque : suppression de paramètres
- Saisie assistée
- Saisie assistée sur les procédures et méthodes de classe
Documentation automatique des procédures et méthodes
Pour simplifier les phases de maintenance ou la reprise par d'autres développeurs de code existant, WINDEV, WEBDEV et WINDEV Mobile proposent une documentation automatique des procédures (ou méthodes de classes). Cette documentation automatique correspond à un ensemble de commentaires. Ces commentaires sont générés : - Soit à la création d'une nouvelle procédure ou méthode.
Vous pouvez choisir si vous voulez générer les commentaires dans la fenêtre qui s'affiche lors de la création d'une procédure ou méthode (option "Générer un commentaire d'en-tête"). Les commentaires générés respecteront le paramétrage de la documentation automatique. - Soit grâce à l'icône
(présente dans le coin haut droit de la fenêtre de code d'une procédure). Cette icône permet de générer ou de supprimer un ensemble de commentaires pour la procédure en cours.
Il est également possible de : - Synchroniser automatiquement les commentaires générés en fonction de la syntaxe des procédures. Une modification de la syntaxe entraîne la mise à jour des commentaires associés (lors de la sauvegarde).
- Utiliser la saisie assistée lors de l'écriture de l'appel aux procédures ou méthodes documentées. Pour plus de détails, consultez le paragraphe Saisie assistée.
Par défaut, les commentaires générés utilisent le format historique, précédés par les caractères '//'. Il est possible de générer les commentaires au format Doxygen (précédés par des tags spécifiques). Le choix du format de génération des commentaires est effectué dans l'onglet "Options" de la description du projet : - Sous le volet 'Projet", dans le groupe "Projet", cliquez sur "Description".
- Dans la fenêtre qui s'affiche, cliquez sur l'onglet "Options".
- L'option "Format des commentaires automatiques" permet de choisir le format utilisé par la génération automatiques des commentaires de procédures. Deux formats sont disponibles :
- format historique.
- format Doxygen.
- Validez.
Documentation automatique Paramétrage Pour paramétrer la documentation automatique : - Sous le volet "Accueil", dans le groupe "Environnement", déroulez "Options" et sélectionnez "Options de l'éditeur de code".
- Affichez l'onglet "Doc.".
Important : Chaque bloc de commentaires doit respecter le format détaillé ci-dessous. En particulier, la description de chaque paramètre ainsi que la description de la valeur de retour doivent être effectuées sur une seule ligne. Dans le cas contraire, des décalages pourront être observés. Que contiennent les commentaires ? Le commentaire d'une fonction ou d'une procédure peut contenir les éléments suivants : - Résumé : le commentaire correspondant est le suivant : ou
- Entête de description de la procédure : le commentaire correspondant est le suivant :
- Syntaxe d'appel : le commentaire correspondant est le suivant :
- Détail des paramètres : le commentaire correspondant est le suivant : ou
- Timer automatique : le commentaire correspondant permet de décrire le timer automatique défini pour la fonction ou la procédure :
- Gestion automatique des erreurs et des exceptions : le commentaire correspondant permet de décrire le mode de gestion des erreurs et des exceptions (défini via le lien "Si Erreur" dans le bandeau d'entête de la procédure). Par exemple :
- Note : le commentaire correspondant est le suivant : ou
- Exemple : le commentaire correspondant est le suivant :
- Marque indiquant que la procédure doit être documentée : le commentaire correspondant est le suivant :
Remarque : suppression de paramètres Si un paramètre est spécifié dans la syntaxe de la procédure, puis supprimé, la référence au paramètre est toujours visible dans la section "Détail des paramètres" des commentaires. Le texte saisi par le développeur concernant le paramètre doit être supprimé par le développeur (limite les risques de suppression par "inadvertance"). L'option "Synchroniser les commentaires avec les syntaxes des procédures" permet de conserver des commentaires à jour quelques soient les modifications effectuées. Saisie assistée sur les procédures et méthodes de classe Si les paramètres d'une procédure ont été documentés, et si la saisie assistée est disponible dans l'éditeur de code, lors de la saisie de l'appel à la procédure, la syntaxe et la description des paramètres apparaissent dans une bulle d'aide. Par exemple : - Documentation de la procédure :
- Saisie assistée sur la procédure :
Le mécanisme de saisie assistée sur les procédures et les méthodes est identique à celui utilisé pour les fonctions WLangage. Pour plus de détails sur le paramétrage de la saisie assistée dans WINDEV, WEBDEV ou WINDEV Mobile, consultez Saisie assistée sur les fonctions WLangage.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|