Articles of commentaires

balise android XML appelée eat-comment, quelle est son utilisation?

Remarqué en parcourant le sdk Android d’un tag comme celui-ci: A quoi cela sert? Une référence à elle par exemple est ici: https://github.com/android/platform_frameworks_base/blob/master/core/res/AndroidManifest.xml

Geany éditeur de texte commentant

Existe-t-il un moyen de mettre en évidence une section de code à commenter en un seul coup en utilisant un éditeur de texte?

Commentez une instruction include dans un fichier HTML en utilisant Jekyll

Existe-t-il un moyen de commenter une instruction include dans un fichier HTML utilisant Jekyll? Par exemple, je l’ai dans l’un de mes fichiers HTML que je voudrais commenter temporairement. Le commentaire HTML standard ne semble pas fonctionner. {% include navbar.html %}

Comment commenter dans XSLT et non HTML

J’écris XSL et je veux faire des commentaires tout au long du code qui sera supprimé lors du traitement, comme PHP, mais je ne sais pas trop comment. Je suis conscient de l’object de commentaire, mais il affiche un commentaire HTML lorsqu’il est traité. : \ comment

Où documenter les fonctions en C?

J’ai un programme C avec plusieurs fichiers, donc j’ai, par exemple, stuff.c qui implémente quelques fonctions, et stuff.h avec les prototypes de fonctions. Comment dois-je procéder pour documenter les fonctions dans les commentaires? Dois-je avoir tous les documents dans le fichier d’en-tête, tous les documents dans le fichier .c , ou dupliquer les documents pour […]

Quelle est la méthode préférée pour commenter les objects et méthodes javascript

J’ai l’habitude d’atlas où la méthode préférée (d’après ce que je sais) est d’utiliser des commentaires XML tels que: /// /// Method to calculate distance between two points /// /// /// First point /// Second point /// function calculatePointDistance(pointA, pointB) { … } Récemment, j’ai examiné d’autres bibliothèques javascript tierces et j’ai vu une syntaxe […]

Comment puis-je modifier la configuration des balises @author dans eclipse de manière à prendre le nom que j’ai spécifié?

J’utilise Eclipse Indigo pour Java. J’avais l’habitude d’écrire des commentaires sur les méthodes. En cela, chaque fois que @author tag @author , il prend automatiquement le nom d’utilisateur du système actuellement connecté. Ma question est la suivante: comment puis-je modifier la configuration de cette balise @author manière à prendre le nom que j’ai spécifié? Je […]

Comment append des commentaires au niveau du package dans Javadoc?

J’utilise Check-Style, FindBugs et PMD pour valider mon code Java. J’ai corrigé presque tous les bugs détectés par ces outils. Je ne suis pas capable de comprendre comment écrire “commentaire de paquet” qui est un bug pris par checkstyle. J’ai parcouru la documentation de Check-Style, mais je ne le comprends pas. Quelqu’un pourrait-il m’aider à […]

Comment citer “* /” dans JavaDocs

J’ai besoin d’inclure */ dans mon commentaire JavaDoc. Le problème est que c’est aussi la même séquence pour fermer un commentaire. Quelle est la bonne façon de citer / échapper à cela? Exemple: /** * Returns true if the specified ssortingng contains “*/”. */ public boolean containsSpecialSequence(Ssortingng str) Suivi : Il semble que je puisse […]

Commentaires dans les modèles T4

Cela semble être une question de base, mais je n’ai pas été en mesure de trouver un article MSDN ou une question StackOverflow qui y répond: est-il possible de faire des commentaires sur les lignes ou de bloquer les commentaires dans les modèles T4? Je ne cherche pas à générer du code avec des commentaires […]