# -*- coding: utf-8 mode: markdown -*- vim:sw=4:sts=4:et:ai:si:sta:fenc=utf-8
##@creator: jclain
##@created: 15/03/2012 22:20
##@modifier: jclain
##@changecount: 1
##@tags: 
##@title: uinc.sh

{{{
uinc.py: Plier/déplier des inclusions dans un fichier
 
USAGE
    uinc.py [[options] dest...]

OPTIONS
    -f  Plier les inclusions
    -u  Déplier les inclusions (par défaut)
    -@  Forcer le caractère '@' pour le pliage/dépliage
    -*  Forcer le caractère '*' pour le pliage/dépliage
    --auto
        Activer la recherche automatique de paramètres (par défaut)
    --noauto
        Désactiver la recherche automatique de paramètres
    -I SPEC
        Spécifier des fichiers à inclure dans les répertoires spécifiés
    -X SPEC
        Spécifier des fichiers à exclure dans les répertoires spécifiés
    --refdir REFDIR
        Spécifier le répertoire de référence. Soit un répertoire DEST spécifié
        dans les arguments. Si un fichier à inclure *n'est pas* un fils du
        répertoire DEST, l'emplacement effectif du fichier est calculé en
        faisant comme si DEST==REFDIR.
        Par exemple, soit DEST=/dest/path et REFDIR=/refdir/path. Si le fichier
        /dest/path/file inclue le fichier ../inc, alors c'est le fichier
        /refdir/inc qui est considéré.
        Ceci permet de traiter les inclusions dans une copie temporaire d'un
        répertoire, dans le cas où les fichier font référence à d'autres
        fichiers situés relativement à l'emplacement original.

Les spécifications de fichiers sont de types glob: ils peuvent contenir les
wildcards * et ?. Ils supportent en plus la chaine '**' qui signifie n'importe
quelle profondeur de répertoire. 'dir/' est équivalent à 'dir/**' et signifie
tous les fichiers situés dans l'arborescence à partir de dir.

La variable UINCPATH contient une liste de répertoires qui sont consultés pour
trouver les fichiers à inclure.
}}}