fr/Exclusion de répertoires et fichiers dans lxr.conf

Répertoires

Certains répertoires de votre arbre peuvent ne pas contenir de données pertinentes pour votre projet. Dans ce cas, il peut être intéressant d'empêcher LXR d'y accéder de façon que l'analyse de votre arbre ne soit pas polluée par des données ancillaires (comme les répertoires auxiliaires des VCS, les objets binaires créées par votre atelier logiciel, etc.)

Vous pouvez le faire très facilement avec le paramètre de configuration 'ignoredirs'.

, 'ignoredirs' => [ repertoires ]

Vous ne listez pas vraiment des répertoires, mais des chemins partiels.

Si un quelconque répertoire (considéré comme entouré de séparateurs, i.e. / sous Linux) correspond à un sous-répertoire du chemin du fichier, le fichier est écarté par LXR.

Example:

, 'ignoredirs' => [ 'CVSROOT', '.git' ]

Version 1.1 et suivantes
Si vous avez besoin d'un contrôle plus précis pour l'exclusion de répertoires, le paramètre 'filterdirs' agit sur le chemin complet LXR (commençant à 'virtroot'):
, 'filterdirs' => [ expressions_regulieres ]
Par convention pour ce test, les chemins de répertoire commencent avec un séparateur (/) mais NE sont PAS terminés par un séparateur.

Les expressions régulières sont prises en compte les unes après les autres dans leur ordre d'apparition jusqu'à une correspondance (auquel cas le répertoire est écarté).

L'emploi de ce paramètre est fortement découragé en raison du temps de traitement nécessaire. Consultez le Manuel de l'utilisateur pour de plus amples explications et des exemples.

Fichiers

De façon analogue, des fichiers mêlés aux véritables fichiers-sources n'apportent rien: fichiers-texte intermédiaires des compliateurs (comme les fichiers .moc), "pense bête" des tâches à faire, modules binaires, etc.

Ces fichiers peuvent être écartés avec le paramètre de configuration 'ignorefiles'.

, 'ignorefiles' => 'regexp'

L'expression régulière est appliquée sur chaque nom de fichier dans le répertoire. Si elle correspond, le fichier est écarté.

Exemple:

LXR utilise le motif suivant pour laisser de côté les fichiers "invisibles" (aussi appelés fichiers "point"), les copies de sauvegarde des éditeurs, les fichiers binaires et les vidages mémoire.

, 'ignorefiles' => '^\\.|~$|\\.(o|a|orig)$|^core$' Faites particulièrement attention à la double barre inverse (\) nécessaire à cause de l'évaluation par Perl.

ATTENTION!
Un usage inconsidéré de ce paramètre peut entraîner une disparition complète de l'arbre!

Notes:

Quand vous oblitérez ce paramètre dans une section d'arbre, n'oubliez pas de reporter la règle globale d'exclusion ci-dessus dans votre règle spécifique.
Dans un développement sous CVS, vous pouvez vous retrouvez avec les fichiers sources et les bases de données de différence CVS dans le même répertoire. Pour protéger votre arbre de "fichiers réels" contre une pollution, vous pouvez exclure les fichiers CVS avec le motif ,v$.
Avec un arbre CVS, la comparaison du nom de fichier ne comprend jamais le suffixe ,v. En conséquence, le motif précédent ,v$ ne peut jamais faire disparaître la totalité de l'arbre.

Version 1.1 et suivantes
Si vous avez besoin d'un contrôle plus précis pour la règle d'exclusion, le paramètre 'filterfiles' agit sur le chemin complet LXR (commençant à 'virtroot'):
, 'filterfiles' => [ expressions_regulieres ]
Par convention pour ce test, les chemins de fichier commencent avec un séparateur (/).

Les expressions régulières sont prises en compte les unes après les autres dans leur ordre d'apparition jusqu'à une correspondance (auquel cas le fichier est écarté).

L'emploi de ce paramètre est fortement découragé en raison du temps de traitement nécessaire. Consultez le manuel utilisateur pour de plus amples explications et des exemples.