Location: PHPKode > projects > phpDocMaker > Install/tagsList.txt
		Documention : liste des tags

1. Fonctionnement général des tags

Un tag est délimité par un '@<' et un '>'. Entre ces deux balises, on doit définir le nom du tag
puis une liste de paramètre. Les différents champs dans le tag sont séparés par un ':'.
Exemple: @<nom:param1:param2>.
Deux versions d'un tag existent: une d'ouverture et une de fermeture. Le tag de fermeture s'obtient en
ajoutant '/' avant le nom.
Exemple: ouverture=@<nom>, fermeture=@</nom>.
Deux types de tag existent: des tags avec fermeture ou sans fermeture.

2. Tags objet

Ces tags permettent de définir des abjects, ils sont donc avec fermeture, les caractéristiques
de l'objet étant définies entre la balise d'ouverture et la balise de fermeture de l'objet.
Le nom de l'objet peut être fourni en paramètre de la balise, dans une balise @<name> ou implicitement
par rapport au nom du fichier qui contient la définition de l'objet. Certain objet doivent être placé
dans des fichiers à part (projet, module). Ils peuvent être mis dans des fichiers portant l'extension
'.def'

Objets définis:
- project: à placer à la racine du projet, il définit les caractéristique générale du projet
- module: un module est une sous partie du projet, le fichier de définition est à placer dans le répertoire
		contenant le module. Un module est rattaché au premier projet trouvé dans la sous arborescence
- script: la définition d'un scripte est à placer dans le fichier contenant le scripte, un scripte se rattache
		soit au module défini dans son répertoire, soit, si un tel module n'existe pas, au projet
- function: la définition d'une fonction est à placer dans le fichier contenant le scripte, la fonction
		se rattache au scripte défini dans le fichier ou au module de son répertoire
- class: idem que script, un tag particulier est défini pour cet objet: le tag extends qui permet de gérer
		l'héritage
- method: idem que function
- param: paramètre d'une fonction ou d'une méthode, doit être défini dans un objet method ou function
(ie entre une balise d'ouverture et de fermeture de ce type d'objet)
- field: idem que param pour les classes

3. Tags de définition

Ces tags sont utilisés pour caractériser un objet:
- name : si un nom est spécifié ici, il remplace toute autre définition déjà présente
- description (*)
- version
- date
- developer
- bug (*)
- todo (*)
- remark (*)

Les tags avec une * n'ont pas de paramètres, les données sont définies entre un tag d'ouverture et un tag
de fermeture. Les autres ont un paramètre et ne nécessitent pas de tag de fermeture.

Remarque: le tag description est optionel: tout texte écrit dans un objet est consiédéré comme une
descrition (sauf si un tag description est présent)

Exemple pour un scripte:

@< script >
	@< name:affichage >
	@< description  >
		Ce script regroupe toutes les fonctions
		permettant de gérer l'affichage de texte
	@< /description >
	@<version:2.1>
	@<developer:John Doo>
	@<todo>
		- supprimer les espaces successifs
	@< /todo>
	@< date : 22/10/2003 >
@< /script >

4. 
Return current item: phpDocMaker