Définition d'une macro :

• dans une section <Macro> au style homogène à la syntaxe des fichiers de configuration Apache.
• l'utilisateur choisit le nom de la macro et de ses paramètres.
• les noms de macro sont insensibles à la casse, comme les directives Apache.
• les noms de paramètres sont par contre sensibles à la casse.
• les paramètres d'une macro doivent avoir des noms distincts.
• il y a une erreur si un paramètre a un nom vide.
• la redéfinition d'une macro génère un avertissement.
• des définitions de macros peuvent être nichées les unes dans les autres...
• les paramètres inutilisés génèrent un avertissement.
• les noms de paramètre en préfixe les uns des autres génèrent un avertissement.
• les noms de paramètre non préfixés par '$%@' génèrent un avertissement pour encourager cette bonne pratique.
• les différents préfixes proposés permettent de gérer les interactions avec d'autres directives comme Define.
• un conseil : il peut être utile d'ajouter des accolades autour du nom d'un paramètre, par exemple ${foo}, de manière à ce que le paramètre puisse être utilisée avec des caractères collés autour, par exemple bla${foo}bla.
• génère un avertissement si le contenu de la macro est vide.
• génère un avertissement si le système détecte que les sections à l'intérieur d'une macro ne sont pas correctement nichées.
• la portée lexicale des paramètres d'une macro est restreinte au texte de la macro elle-même... en particulier elle n'est pas propagée aux inclusions.
• il n'y a pas de contrainte sur le contenu d'une macro.

  Cela signifie que vous pouvez mettre une section perl ou n'importe quoi d'autre dans une macro. Il n'y a pas d'autre hypothèse sur la structure lexicale et syntaxique de la macro (guillemets, espaces...) que d'attendre une séquence de ligne avec éventuellement des continuations.

Utilisation d'une macro:

• le nombre d'argument doit être cohérent avec la définition.
• toutes les occurences des paramètres sont substitués par leur valeur.
• en cas de conflit, le nom le plus long est choisit.
• une récursion dans l'expansion d'une macro est détectée et arrêtée avec une erreur.
• les arguments vides génèrent un avertissement si ils sont utilisés.
• le système génère une description très précise de la localisation des erreurs.
• les valeurs des paramètres préfixés par $ et % ne sont pas protégés.
• les valeurs des paramètres préfixés par @ sont protégés par des guillemets.

Effacement de la définition d'une macro :

• la macro effacée doit avoir été définie auparavant.