manuel d'utilisation de fonction

Bonjour, j'aimerais faire un manuel d'utilisation de fonction assez complet.
Pour l'instant, voici ce qu'il référence :
- Syntaxe de la méthode
- Description
- Valeur de retour
- Exemple d'utilisation

En fait, c'est ce qu'on trouve avec la commande man sous linux mais si vous avez des idées sur ce qui pourrait encore aider un tuilisateur pour l'appel d'une méthode, je suis prenuer...
Merci

Idées en vrac.

Invariants, exceptions possibles et autres domaines de validité.
Eventuels problèmes de portabilités.
Possibles détails internes. Important pour les fonctions qui sont des sources ou des puits à ressources (mémoire ou autre)
Etats modifiés par la fonction (valable pour les variables globales, celles de modules, attributs d'un objet, ...)