Man page - wcd(1)

Packages contains this manual

Available languages:

en fr pt_BR nl sv uk ro sr de

Manual

wcd

NOM
SYNOPSIS
DESCRIPTION
Présentation
Utilisation basique
CaractÚres génériques
Autres utilisations
chemins Windows UNC
Redimensionnement de console sous Windows
Interfaces
OPTIONS
INSTALLATION
Installation pour les interfaces systĂšme de type POSIX
Installation pour les interfaces systĂšme de type C (csh, tcsh)
Version de l’Invite de Commande Windows
Windows VISTA et ultérieur
Version Windows PowerShell
Version OS/2 Command Prompt
LOCALISATION
PAGES DE CODES WINDOWS
UNICODE
FICHIERS
VARIABLES D’ENVIRONNEMENT
VOIR AUSSI
AUTEURS

NOM

wcd - Wherever Change Directory

chdir pour DOS et Unix.

SYNOPSIS

wcd [options] [répertoire]

DESCRIPTION

Présentation

Wcd est un logiciel en ligne de commande permettant de changer de rĂ©pertoire rapidement. Il permet de gagner du temps d’écriture au clavier. Un utilisateur n’a besoin de taper qu’une partie du nom d’un rĂ©pertoire et wcd s’y dĂ©placera. Wcd a une mĂ©thode de sĂ©lection rapide lors de multiples correspondances et permet l’alias et le bannissement de rĂ©pertoires. Wcd inclus Ă©galement un navigateur d’arborescence de fichiers intĂ©ractif en mode plein Ă©cran et avec recherche rapide.

Wcd a été construit sur le modÚle du Norton Change Directory ( NCD ). NCD est apparu pour la premiÚre fois dans The Norton Utilities, Release 4 , pour DOS en 1987 et publié par Peter Norton.

Wcd a Ă©tĂ© adaptĂ© Ă  diffĂ©rentes interfaces systĂšme en ligne de commande : DOS command.com, Windows cmd.exe et PowerShell, OS/2 cmd.exe, et aux interfaces systĂšme Unix telles que Bourne (sh), Bourne Again (bash), Korn (ksh), Z (zsh), et C (csh) ainsi qu’à d’autres fonctionnant sur tout systĂšme d’exploitation.

Wcd prend en charge les ensemble de caractùres 8 bits sur tous les systùmes, et prend en charge l’Unicode de façon optionnelle. Voir la section LOCALISATION.

Voir la section INSTALLATION pour mettre en place wcd dans le cas d’un usage personnel.

Utilisation basique

Par dĂ©faut (si aucun caractĂšre gĂ©nĂ©rique n’est utilisĂ©) wcd cherche un rĂ©pertoire avec un nom commençant par le nom entrĂ©.

Par exemple, cette commande changera vers le rĂ©pertoire de l’utlisateur courant "/home/user/Desktop" :

wcd Desk

Lorsqu’il y a plusieurs correspondances, wcd affichera à l’utilisateur une liste les contenant toutes. L’utilisateur pourra alors faire un choix avec quelques de frappes clavier (une seule la plus part du temps).

CaractÚres génériques

Wcd prend en charge les caractÚres génériques suivant :

* correspond à toute séquence de caractÚres (zéro ou plus)
? correspond Ă  n'importe quel caractĂšre
[ENSEMBLE] correspond à n'importe quel caractÚre dans l'ensemble donné,
[!ENSEMBLE] ou [ˆENSEMBLE] correspond Ă  n'importe quel caractĂšre qui n'est pas dans l'ensemble donnĂ©.

Un ensemble est composĂ© de caractĂšres ou d’intervalles ; un intervalle s’écrit caractĂšre tiret caractĂšre comme dans "0-9" ou "A-Z". "[0-9a-zA-Z_]" est l’ensemble minimal de caractĂšres autorisĂ©s dans la construction du motif "[...]". Les caractĂšres internationaux (Ă  savoir des caractĂšres de 8 bits) sont autorisĂ©s si le systĂšme les prend en charge. Pour supprimer le sens syntaxique spĂ©cial de n’importe quel caractĂšre "[]*?!ˆ-\" Ă  l’intĂ©rieur ou Ă  l’extĂ©rieur d’une construction "[..]" et ainsi indiquer une correspondance envers le caractĂšre lui-mĂȘme, il faut le faire prĂ©cĂ©der d’une barre oblique inversĂ©e ("\").

L’utilisation de caractĂšres gĂ©nĂ©riques rend possible des recherches complexes. Par exemple, ceci correspond Ă  n’importe quel nom de rĂ©pertoire se terminant par « top » :

wcd *eau

Fait correspondre les répertoires qui ont « eau » quelque part dans leur nom :

wcd *eau*

Fait correspondre n’importe quel nom de rĂ©pertoire commençant par « a », « b » ou « c » :

wcd [a-c]*

Il est Ă©galement possible de donner une partie du chemin d’un rĂ©pertoire. Ici Wcd cherche les rĂ©pertoires dont le nom commence par « Bur » et qui dont le chemin correspond Ă  *moi/Bur* .

wcd moi/Bur

Il est possible d’entrer n’importe quel type d’expression avec des barres obliques et des caractĂšres gĂ©nĂ©riques. Par exemple :

wcd src*/*1?/a*2

Autres utilisations

Si aucun caractĂšre gĂ©nĂ©rique n’est utilisĂ© et que wcd trouve une correspondance parfaite, wcd ignorera toutes les correspondances gĂ©nĂ©riques par dĂ©faut. Ce comportement peut ĂȘtre modifiĂ© par l’option -w .

Le navigateur d’arborescence de rĂ©pertoire intĂ©ractif peut ĂȘtre dĂ©marrĂ© en utilisant l’option -g .

wcd -g

Wcd gĂ©nĂšre un fichier d’arborescence Ă  l’emplacement de la recherche du rĂ©pertoire. Sur les systĂšmes Unix et Windows, wcd ajoute des liens symboliques vers le fichier d’arborescence lors de l’examem du disque, mais ne les suit pas. S’il suivait les liens, wcd pourrait en venir Ă  examiner une boucle infinie, ou de trĂšs grandes portions d’un rĂ©seau.

Wcd peut Ă©galement changer vers des rĂ©pertoires qui ne sont pas dans le fichier d’arborescence. Par exemple :

wcd ..

Si wcd trouve une correspondance mais ne peut pas aller au rĂ©pertoire, il tente alors de le supprimer du fichier d’arborescence par dĂ©faut. Pas du fichier d’arborescence supplĂ©mentaire. Voir Ă©galement l’option -k .

Wcd conserve une pile de répertoires stockée sur le disque. La pile à une taille par défaut de 10 et est cyclique. Voir les options -z , - , + et = .

Dans un environnement multi-utilisateurs, l’option -i peut ĂȘtre utilisĂ©e pour se dĂ©placer dans des rĂ©pertoires d’autres utilisateurs.

Sur les systÚmes DOS et Windows, peut importe si vous utilisez la barre oblique « / » ou la barre oblique inversée « \ » comme séparateur de répertoires.

Sur les systĂšmes DOS et Windows, il est possible de changer de lecteur et de rĂ©pertoire d’un seul coup en faisant prĂ©cĂ©der le nom du rĂ©pertoire par le nom du lecteur.

wcd d:jeux

chemins Windows UNC

Les versions Windows (Command Prompt, PowerShell, MSYS, zsh, cygwin) prennent en charge les chemins Windows SMB LAN UNC sans lettre de lecteur tels que "\\servername\sharename". Wcd pour Windows Command Prompt utilise la commande « pushd » pour faire correspondre un chemin UNC Ă  une lettre de lecteur. Dans Windows PowerShell, MSYS, zsh et Cygwin, les chemins UNC sont pris en charge. Le rĂ©pertoire de travail courant peut ĂȘtre un chemin UNC.

Redimensionnement de console sous Windows

Wcd prend en charge le redimensionnement de console dans les consoles Windows 10 et ConEmu (void <https://conemu.github.io/>) depuis la version 6.0.3. La console Windows 10 ne doit pas ĂȘtre dans le mode hĂ©ritĂ© (vĂ©rifier les propriĂ©tĂ©s de la console). L’écran peut ne pas ĂȘtre rafraĂźchi lorsque la Configuration « Renvoyer automatiquemet Ă  la ligne le texte en cas de redimensionnement » de la console est dĂ©sactivĂ©e. L’écran peut ĂȘtre rafraĂźchi manuellement en pressant la touche F5.

Interfaces

Wcd a trois interfaces pour choisir parmi une liste de correspondances. L’interface peut ĂȘtre choisie Ă  la compilation.

La premiĂšre interface utilise simplement stdin/stdout. Une liste numĂ©rotĂ©e est affichĂ©e dans le terminal. L’utilisateur doit choisir parmi cette liste en entrant un nombre suivi de la touche <Entrer>. Cette interface ne fournit pas la fonctionnalitĂ© de dĂ©filement arriĂšre lorsque la liste est longue. La fonctionnalitĂ© de dĂ©filement arriĂšre du terminal ou de la console doit ĂȘtre utilisĂ©e. C’est trĂšs petit et portable.

La seconde interface est basĂ©e sur la bibliothĂšque conio. Elle fournit une capacitĂ© de dĂ©filement arriĂšre intĂ©grĂ©e. L’utilisateur voit affichĂ©e une liste ordonnĂ©e par des lettres. La sĂ©lection dans cette liste peut se faire en pressant une seule lettre. Cette interface est rapide car elle Ă©conomise les frappes. Si possible, l’écran sera restaurĂ© aprĂšs sortie. Utiliser l’option -N si l’utilisation de nombres est prĂ©fĂ©rrĂ©e.

La troisiĂšme interface est construite avec la bibliothĂšque curses. Elle est similaire Ă  l’interface conio. La version curses de wcd a une interface « graphique » supplĂ©mentaire. Elle laisse l’utilisateur choisir un rĂ©pertoire via un navigateur plein Ă©cran et intĂ©ractif d’arbre de rĂ©pertoires. Elle a une navigation et une mĂ©thode de recherche similaire Ă  celle de vim (1). Elle peut ĂȘtre activĂ©e avec l’option -g .

En utilisant l’option -o il est toujours possible de revenir à l’interface stdin/stdout.

OPTIONS

-a

Ajouter le chemin courant au fichier d’arborescence par dĂ©faut.

Utiliser cette option pour ajouter de façon rapide le chemin courant au fichier d’arborescence par dĂ©faut. Le rĂ©examen complet du disque peut parfois pendre beaucoup de temps.

-aa

Ajouter le chemin courant et tous les chemins parents au fichier d’arborescence par dĂ©faut.

-A CHEMIN

Examiner l’arborescence de rĂ©pertoires depuis CHEMIN et l’ajouter au fichier d’arborescence par dĂ©faut. Exemples :

wcd -A .
wcd -A /home -A /etc
wcd -A d: -A e: -A \\serveur\partage

Sur Windows, il est possible d’examiner tous les rĂ©pertoires partagĂ©s d’un serveur LAN Windows en entrant quelque chose comme : <wcd -A \\nomdeserver>

Voir Ă©galement les options -S et -s et -E .

-b

Bannir le chemin courant.

Wcd met le chemin courant dans le fichier de bannissements. Cela signifie que wcd ignore toutes les correspondances de ce répertoire et de ses sous-répertoires.

Le fichier de bannissements peut ĂȘtre modifiĂ© avec un Ă©diteur de texte. L’utilisation de caractĂšres gĂ©nĂ©riques est prise en charge et les noms sont mis en correspondance avec le chemin absolu.

Les chemins bannis ne sont pas exclus de l’examen du disque. Pour cela utiliser l’option -xf .

-c, --direct-cd

Mode CD direct. Par défaut wcd marche de la façon suivante :

1. Essaie de trouver une correspondance dans le(s) fichier(s) d'arborescence
2. S'il n'y a pas de correspondance, essaie d'ouvrir le répertoire que vous avez entré.

En mode CD direct wcd marche en ordre inverse.

1. Essaie d'ouvrir le répertoire que vous avez entré.
2. Sinon, essaie de trouver une correspondance dans le(s) fichier(s) d'arborescence.

-d LECTEUR

Choisir le lecteur pour le fichier de pile et de « go » ( DOS uniquement).

Les fichiers de pile et de script « go » sont stockĂ©s sur le lecteur C: par dĂ©faut si la variable d’environnement HOME n’est pas dĂ©finie. Utiliser cette option si le lecteur C: est un lecteur en lecture seule. Cette option doit ĂȘtre utilisĂ©e devant les options de pile - , + and = .

-e

Ajouter le chemin courant au fichier d’arborescence supplĂ©mentaire.

Utiliser cette option pour ajouter rapidement le chemin courant au fichier d’arborescence supplĂ©mentaire.

-ee

Ajouter le chemin courant et tous les chemins parents au fichier d’arborescence supplĂ©mentaire.

-E CHEMIN

Examiner l’arborescence de rĂ©pertoires depuis CHEMIN et l’ajouter au fichier d’arborescence supplĂ©mentaire. Voir aussi les options -A et -S .

-f FICHIER

Lire le fichier d’arborescence FICHIER . Ne pas lire le fichier d’arborescence par dĂ©faut.

+f FICHIER

Lire le fichier d’arborescence FICHIER en plus du fichier d’arborescence par dĂ©faut.

-g

Interface graphique (uniquement pour les versions avec l’interface curses).

Wcd dĂ©marre une interface « graphique » textuelle basĂ©e sur curses. L’utilisateur peut choisir un rĂ©pertoire via le navigateur d’arbre de rĂ©pertoires intĂ©ractif en plein Ă©cran. Il possĂšde une mĂ©thode de navigation et de recherche similaire Ă  celle de vim (1).

Si aucune chaĂźne de recherche n’est donnĂ©e, wcd affiche l’arbre entier qui se trouve dans le fichier d’arborescence par dĂ©faut ainsi que dans les fichiers d’arborescence supplĂ©mentaires.

Si une chaßne de recherche est donnée, la liste des correspondances est affichée comme un arbre de répertoires.

La disposition par dĂ©faut de l’arbre est similaire Ă  celle du NCD initial sur DOS. La diffĂ©rence de disposition rĂ©side dans le fait que pour NCD, tous les rĂ©pertoires de profondeur identique Ă©taient alignĂ©s verticalement sur toute la hauteur de l’arbre. Cela Ă©tait possible sous NCD parce que la longueur maximale d’un nom de rĂ©pertoire sous DOS Ă©tait de 12 (8.3) caractĂšres. Les noms de rĂ©pertoire pouvant ĂȘtre trĂšs longs sur les systĂšmes d’exploitation modernes, la diffĂ©rence de longeur peut ĂȘtre importante. De fait, les dossiers de mĂȘme profondeur ne sont pas alignĂ©s verticalement sur la totalitĂ© de l’arbre dans wcd, mais seulement dans les sous-branches. Il y a donc des mouvements latĂ©raux lors d’un dĂ©placement direct vers le haut ou vers le bas depuis une sous-branche vers une autre sous-branche.

Le comportement de navigation de Wcd est exactement identique Ă  celui du NCD initial. Par exemple, l’appui sur la touche Bas du clavier amĂšne au rĂ©pertoire suivant avec la mĂȘme profondeur, passant outre les branches. Cela permet une navigation rapide dans l’arbre.

Voir les options -Ta , -TC , et -Tc pour modifier le comportement de la navigation.

-gd

DĂ©charger les fichiers d’arborescence sous forme d’arbre sur la sortie standard.

-G CHEMIN

Ecrire le script « go » dans le répertoire CHEMIN . Par exemple sur Unix, "wcd -G CHEMIN" va écrire un fichier de script « go » CHEMIN/wcd.go .

-GN, --no-go-script

Ne pas crĂ©er un script « go ». Cette option peut ĂȘtre utilisĂ©e en association avec l’option -j si la crĂ©ation d’un script « go » n’est pas dĂ©sirĂ©e.

-h, --help

Afficher l’aide et quitter.

-i, --ignore-case

Ignorer la casse. Les versions Dos et Windows de wcd ignorent la casse par défaut. Les versions Unix/Cygwin respectent la casse par défaut.

+i, --no-ignore-case

Respecter la casse. Voir aussi l’option -i .

-I, --ignore-diacritics

Ignorer les caractÚres diacritiques pour les scripts en Latin. Les lettres avec des symboles diacritiques correspondent à leur lettre de base sans ces symboles diacritiques. Les encodages Latin suivant sont pris en charge : CP437, CP850, CP852, CP1250, CP1252, ISO-8859-1, ISO-8859-2, et Unicode Latin-1, Latin Extended-A, et Latin Extended-B. Voir aussi <http://en.wikipedia.org/wiki/Diacritic>

+I, --no-ignore-diacritics

Prendre en compte les diacritiques (dĂ©faut). Voir aussi l’option -I .

-j, --just-go

Mode Ă  accĂšs direct.

Dans ce mode, wcd ne prĂ©sentera pas de liste lorsqu’il y a plusieurs rĂ©pertoires correspondant au rĂ©pertoire donnĂ©. Wcd changera vers la premiĂšre option. Lorsque wcd est appelĂ© une nouvelle fois avec les mĂȘme arguments, il changera vers l’option suivante et ainsi de suite.

Wcd affichera le rĂ©pertoire vers lequel aller sur la sortie standard. Une mĂ©thode d’installation diffĂ©rente peut ĂȘtre utilisĂ©e. On pourra Ă©crire la fonction suivante pour une interface systĂšme compatible POSIX :

wcd ()
{
cd "$($HOME/bin/wcd.exe -j $@)"
}

Lors de l’utilisation d’une interface systĂšme ancienne ne prenant pas en charge la substitution de commande « $() », il faut recourir Ă  la substitution de commande ancienne utilisant l’accent grave.

wcd ()
{
cd "`$HOME/bin/wcd.exe -j $@`"
}

Sur les systĂšmes Windows, si l’interface systĂšme 4NT est utilisĂ©e, il est alors possible de faire l’alias suivant :

alias wcd `cd %@execstr[wcdwin32.exe -z 0 -j %1]`

Cette mĂ©thode supprime la nĂ©cessitĂ© d’un script « go », et il est donc possible de combiner l’option -GN avec l’option -j .

-k, --keep-paths

Garder les chemins.

Conserver les chemins dans le fichier d’arborescence lorsque wcd ne peut s’y dĂ©placer. Le comportement par dĂ©faut de wcd est d’essayer de supprimer les chemins du fichier d’arborescence lorsque wcd ne peut s’y rendre. Cette option dĂ©sactive ce comportement.

-K, --color

Utiliser les couleurs en mode graphique.

-l ALIAS

Nommer le chemin courant avec ALIAS . Wcd ajoute le chemin courant avec ALIAS pour alias dans le fichier d’alias. Les alias sont sensibles à la casse.

-ls

Afficher le nom du fichier d’alias et lister tous les alias.

-m REP

CrĂ©er un rĂ©pertoire et l’ajouter au fichier d’arborescence.

-L, --license

Afficher la license de distribution.

-M REP

CrĂ©er un rĂ©pertoire et l’ajouter au fichier d’arborescence supplĂ©mentaire.

-n CHEMIN

Lire le fichier d’arborescence relative depuis CHEMIN .

Ne pas lire le fichier d’arborescence par dĂ©faut. Le fichier d’arborescence relative doit avoir Ă©tĂ© crĂ©Ă© en utilisant l’option +S de wcd. CHEMIN peut Ă©galement rĂ©fĂ©rencer directement un fichier.

Un exemple. Supposons qu’un autre systĂšme ait Ă©tĂ© montĂ© au point de montage "/mnt/network" :

wcd -n /mnt/network src

Wcd ouvre le ficher d’arborescence relative dans "/mnt/network/". Le fichier contient les chemins relatifs depuis cet endroit.

+n CHEMIN

Lire le ficher d’arborescence relative en plus du fichier d’arborescence par dĂ©faut. Voir l’option -n .

-N, --numbers

Utiliser des nombres Ă  la place de lettres.

Wcd avec une interface basĂ©e sur conio ou curses (voir la section Interfaces) affiche une liste de correspondances indexĂ©es par des lettres par dĂ©faut. Lorsque l’option -N est utilisĂ©e, la liste de correspondances est indexĂ©e par des nombres. IndĂ©pendamment de l’option -N , il est possible d’entrer une lettre ou un nombre pour effectuer une sĂ©lection dans la liste de correspondances.

-o

Utiliser l’interface stdin/stdout.

Lorsque l’interface conio ou curses de wcd ne fonctionne pas pour quelque raison que ce soit, il est possible de se rabattre sur l’interface stdin/stdout de wcd en utilisant l’option -o .

-od, --to-stdout

DĂ©charger l’ensemble des correspondances dans stdout.

-q, --quiet

Fonctionnement plus silencieux. L’affichage de la derniĂšre correspondance est supprimĂ©.

-r REP

Supprimer un rĂ©pertoire et le supprimer du fichier d’arborescence.

Si le rĂ©pertoire est vide, wcd le supprimera et tentera de le supprimer du fichier d’arborescence.

-rmtree REP

Supprimer un rĂ©pertoire de façon rĂ©cursive et le supprimer du fichier d’arborescence.

Wcd supprimera le rĂ©pertoire ainsi que tous ses sous-rĂ©pertoires et fichiers et supprimera ces rĂ©pertoires du fichier d’arborescence.

-s

(rĂ©)Examiner le disque depuis le rĂ©pertoire "HOME". Si HOME n’est pas dĂ©fini, le disque est examinĂ© depuis le rĂ©pertoire racine /.

Le fichier d’arborescence par dĂ©faut existant est Ă©crasĂ©.

Le rĂ©pertoire d’examen par dĂ©faut peut ĂȘtre renversĂ© par la variable d’enrivonnement "WCDSCAN". Voir la section VARIABLES D ’ ENVIRONNEMENT .

-S CHEMIN

Examiner l’arbre de rĂ©pertoires depuis CHEMIN et Ă©craser le fichier d’arborescence par dĂ©faut. Voir aussi les options -A , -s et -E . Par exemple, avec l’option -A il est possible de crĂ©er un fichier d’arborescence par dĂ©faut de votre choix. Exemples :

Unix :

wcd -S /
wcd -S /home -A /etc -A /usr

DOS / Windows :

wcd -S c:/
wcd -S c: -A d: -A \\serveur\partage

Avec les versions Windows, il est possible d’examiner tous les rĂ©pertoires partagĂ©s d’un serveur LAN Windows en entrant une commande similaire à : "wcd -S \\nomserveur".

+S CHEMIN

Examiner le disque depuis CHEMIN et placer les chemins relatifs dans un fichier d’arborescence relative. Ce fichier est utilisĂ© par les options -n et +n de wcd. Par exemple "wcd -n CHEMIN src".

-t

Ne pas Ă©viter le dossier de montage temporaire "/tmp_mnt" (Unix uniquement).

Par dĂ©faut, wcd retire "/tmp_mnt/" des correpondances. Le rĂ©pertoire "/tmp_mnt" est utilisĂ© par le montage automatique. Ce comportement peut ĂȘtre Ă©vitĂ© avec l’option -t .

-T, --ascii-tree

Dessiner l’arbre avec des caractùres ASCII. Utiliser cette option si les caractùres de dessin de ligne ne s’affichent pas correctement dans le terminal.

-Ta, --alt-tree-nav

Navigation alternative dans l’arbre graphique.

Dans la disposition d’arbre du style par dĂ©faut du NCD, l’option -Ta dĂ©sactive le saut vers des rĂ©pertoires sans liens.

Dans le mode d’arbre compact, le mode alternatif rend la navigation similaire Ă  celle de gestionnaires de fichiers graphiques tels que Windows Explorer ou Linux KDE Konqueror. L’appui sur les touches Haut et Bas dĂ©place le dossier sĂ©lectionnĂ© d’une ligne vers le haut ou le bas. Le premier appui sur la touche Gauche replie les sous-dossiers, le second se dĂ©place rĂ©ellement Ă  gauche.

Il est possible de basculer à la volée entre une navigation par défaut et alternative en pressant <Shift-A>.

Lorsque le mode de navigation alternative est activĂ©, un « A » est visible dans l’angle infĂ©rieur droit.

-TC, --center-tree

Vue centrĂ©e dans l’arbre graphique. Le rĂ©pertoire choisi reste au centre de l’écran. Le mode centrĂ© peut aussi ĂȘtre activĂ©/dĂ©sactivĂ© avec la clef <t> dans l’arbre graphique.

Le comportement non centrĂ© standard, qui minimise le mouvement d’arbre, est identique Ă  celui du NCD original.

-Tc, --compact-tree

Par dĂ©faut l’arbre « graphique » est dessinĂ© de la mĂȘme façon que le faisait le NCD original sur DOS. Sur DOS, un chemin de rĂ©pertoire ne pouvait faire que 66 caractĂšres au total. Avec les structures de rĂ©pertoire profondes comtemporaines, l’arbre peut devenir trĂšs large. Pour surmonter cela, wcd peut dessiner l’arbre d’une façon compacte, de façon similaire Ă  la plus part des gestionnaires de fichier graphiques, avec un seul fichier par ligne. Utiliser l’option -Tc ou basculer Ă  la volĂ©e avec la clef <m>.

-Td, --cjk-width

Les polices CJK d’Asie de l’Est (Chine, Japon et CorĂ©e) possĂšdent certains caractĂšres et symboles de tracĂ© de ligne avec une largeur de colonne de 2, alors que la largeur Unicode normale pour ces caractĂšres est de 1 colonne. Par exemple, la police de trame CP936 chinoise sur Windows et la police Simsun. Utiliser cette option lorsqu’une police de type CJK est utilisĂ©e pour obtenir un contour de l’arbre graphique correct.

Lorsque le mode CJK est actif, un « C » est affiché dans le coin inférieur droit.

-u UTILISATEUR

Examiner le fichier d’arborescence d’un autre utilisateur en se basant sur UTILISATEUR et ne pas examiner votre propre fichier d’arborescence. Voir aussi WCDUSERHOME dans la section VARIABLES D ’ ENVIRONNEMENT.

Sur Unix/Cygwin le rĂ©pertoire racine pour les rĂ©pertoires utilisateur est supposĂ© ĂȘtre "/home". Wcd recherchera "/home/UTILISATEUR/.treedata.wcd" et "/home/UTILISATEUR/.wcd/.treedata.wcd", dans cet ordre, lira le premier fichier existant et lisible. Sur DOS/Windows le rĂ©pertoire racine pour les rĂ©pertoires utilisateur est supposĂ© ĂȘtre "\\users", donc wcd tentera de lire"\\users\UTILISATEUR\treedata.wcd" et "\\users\UTILISATEUR\.wcd\treedata.wcd".

+u UTILISATEUR

Lire le fichier d’arborescence par dĂ©faut de l’ UTILISATEUR en plus de votre fichier d’arborescence.

-v, --verbose

Afficher les messages verbeux. Avec cette option wcd affiche tous les filtres, les bannissements et les exclusions.

-V, --version

Afficher les informations de version et sortir.

-w, --wild-match-only

Correspondance générique seulement. Traiter toutes les correspondances comme des correspondances génériques.

-x CHEMIN

Exclure CHEMIN de l’examen.

Lorsque cette option est utilisĂ©e, wcd exclu le CHEMIN et tous ses sous-rĂ©pertoires lors de l’examen d’un disque. Les caractĂšres gĂ©nĂ©riques sont pris en charge et mis en correspondance avec les chemins absolus. L’option -x peut ĂȘtre utilisĂ©e plusieurs fois.

wcd -x <chemin1> -x <chemin2> -s

L’option -x doit ĂȘtre utilisĂ©e avant toute option d’examen ( -s , -S , +S , -A , -E ).

Sur les systĂšmes DOS/Windows la prĂ©cision de la lettre de lecteur dĂ©pend de l’utilisation ou non des variables d’environnement HOME ou WCDHOME . Si HOME ou WCDHOME sont fixĂ©es alors il faut prĂ©ciser la lettre du lecteur. Par exemple :

wcd -x c:/temp -S c:

Sinon, il n’est pas nĂ©cessaire de prĂ©ciser la lettre de lecteur.

wcd -x /temp -s

-xf FICHIER

Exclure de l’examen tous les chemins listĂ©s dans FICHIER .

Lorsque cette option est utilisĂ©e, wcd excluera tous les chemins listĂ©s dans FICHIER et tous leurs sous-rĂ©pertoires durant l’examen d’un disque. Les caractĂšres gĂ©nĂ©riques sont pris en charge et ils sont mis en correspondance de chemins absolus ; un chemin par ligne. Il faut ĂȘtre attentif au fait que wcd n’ignore pas les espaces commençant et terminant une ligne parce qu’il s’agit de caractĂšres lĂ©gaux pour un nom de rĂ©pertoire. L’option -xf peut ĂȘtre utilisĂ©e plusieurs fois. Lorsque l’exclusion de tous les chemins bannis est souhaitĂ©e, il est possible de faire de la sorte (exemple pour wcd sur unix) :

wcd -xf ˜/.ban.wcd -s

Les caractĂšres gĂ©nĂ©riques sont pris en charge. Par exemple, pour exclure tous les rĂ©pertoires Subversion contenant des fichiers d’administration, ajoutez une ligne avec "*/.svn".

L’option -xf doit ĂȘtre utilisĂ©e avant toute option d’examen ( -s , -S , +S , -A , -E ).

-y, --assume-yes

Supposer Oui pour toutes les requĂȘtes.

Wcd ne posera pas de questions oui/non Ă  l’utilisateur, mais suppose qu’il rĂ©pondra oui Ă  toutes les questions. Cela peut ĂȘtre utilisĂ© en combinaison de l’option -rmtree . Cette option doit ĂȘtre utilisĂ©e avant les options qui peuvent dĂ©boucher Ă  des questions oui/non.

-z NOMBRE

Fixer la taille maximale de la pile Ă  NOMBRE.

La taille par dĂ©faut de la pile est de 10. Les opĂ©rations sur la pile peuvent ĂȘtre dĂ©sactivĂ©es en paramĂštrant la taille Ă  0. Cette option doit ĂȘtre utilisĂ©e avant toute autre option d’opĂ©ration sur la pile ( - , + , = ). Autrement, la taille de la pile sera remise Ă  sa valeur par dĂ©faut, 10.

Une commande correcte est :

wcd -z 50 -

La nouvelle taille de pile sera de 50, wcd ira un répertoire en arriÚre. Un commande erronée est :

wcd - -z 50

Wcd va en arriĂšre d’un rĂ©pertoire, la pile Ă  une valeur par dĂ©faut de 10. Le -z 50 est ignorĂ©.

Ajouter cette option en premiùre option de votre alias ou fonction wcd. Un exemple pour l’interface d’administration compatible POSIX serait :

wcd ()
{
wcd.exe -z 50 "$@"
. ${WCDHOME:-${HOME}}/bin/wcd.go
}

-[ NOMBRE ]

Empiler les répertoires NOMBRE de fois. La valeur par défaut étant de un.

Retourner en arriĂšre d’un rĂ©pertoire. La commande <wcd -> retourne en arriĂšre d’un rĂ©pertoire. Y ajouter un nombre pour retourner en arriĂšre de plusieurs rĂ©pertoires. Exemple : "wcd -3". La pile est cyclique.

+[ NOMBRE ]

Dépiler les répertoires NOMBRE fois. Un par défaut.

Avancer d’un rĂ©pertoire. La commande "wcd +" avance d’un rĂ©pertoire. Y ajouter un nombre pour avancer de plusieurs rĂ©pertoires. Par exemple : "wcd +2". La pile est cyclique.

=

Afficher la pile.

Utiliser cette option si vous ne savez plus de combien de fois empiler ou dépiler. La pile est affichée et il est possible de choisir un nombre. La position courante de la pile est désignée par une astérisque "*".

INSTALLATION

Le rĂ©pertoire de travail courant d’une interface systĂšme Unix ne peut ĂȘtre changĂ© que par la commande intĂ©grĂ©e cd (1). Le programme est donc toujours appelĂ© par une fonction ou un alias. La fonction ou l’alias incluent un script d’interface systĂšme (script « go ») qui est gĂ©nĂ©rĂ© par le programme wcd. Wcd ne peut fonctionner qu’aprĂšs que la fonction ou l’alias aient Ă©tĂ© dĂ©finis.

Un autre impact important de votre installation est la dĂ©finition des variables d’environnement HOME and WCDHOME . Voir la section VARIABLES D ’ ENVIRONNEMENT.

Installation pour les interfaces systĂšme de type POSIX

Pour les interfaces systĂšme POSIX (ksh, bash, zsh, etc.) sur Unix, Linux, Cygwin ou MSYS natif, ajouter la fonction suivante au fichier de dĂ©marrage de l’interface systĂšme (Bash utilise par exemple "$HOME/.bashrc") :

wcd ()
{
CHEMIN/wcd.exe "$@"
. ${WCDHOME:-${HOME}}/bin/wcd.go
}

Remplacer CHEMIN par l’emplacement oĂč l’exĂ©cutable de wcd a Ă©tĂ© installĂ©. Recharger le fichier d’initialisation de l’interface systĂšme ou dĂ©marrer une nouvelle interface systĂšme.

L’emplacement du script « go » "wcd.go" diffĂšre par interface systĂšme.

Wcd pour les interfaces systĂšme DOS DJGPP et OS/2 exige une fonction diffĂ©rente. Le script « go » n’est pas Ă©crit dans un rĂ©pertoire "bin", et si WCDHOME et HOME sont toutes deux non dĂ©finies, le script « go » est Ă©crit sur c:/.

bash DOS :

wcd ()
{
CHEMIN/wcdbash.exe "$@"
. ${WCDHOME:-${HOME:-"c:"}}/wcd.go
}

bash OS/2 :

wcd ()
{
CHEMIN/wcdos2bash.exe "$@"
. ${WCDHOME:-${HOME:-"c:"}}/wcd.go
}

La version WinZsh de wcd exige une fonction légÚrement différente. Le script « go » ne sera jamais écrit dans c:/.

wcd ()
{
CHEMIN/wcdwin32zsh.exe "$@"
. ${WCDHOME:-${HOME}}/wcd.go
}

Voir la section FICHIERS pour plus d’informations.

Installation pour les interfaces systĂšme de type C (csh, tcsh)

Ajouter les alias suivants au fichier de dĂ©marrage de l’interface systĂšme "$HOME/.cshrc" ou "$HOME/.tcshrc" :

if ( ${?WCDHOME} ) then
alias wcd "PATH/wcd.exe \!* ; source $WCDHOME/bin/wcd.go"
else
alias wcd "CHEMIN/wcd.exe \!* ; source $HOME/bin/wcd.go"
endif

Remplacer CHEMIN par l’emplacement oĂč l’exĂ©cutable de wcd a Ă©tĂ© installĂ©. Recharger le fichier d’initialisation de l’interface systĂšme ou dĂ©marrer une nouvelle interface systĂšme.

Version de l’Invite de Commande Windows

DĂ©paqueter le fichier zip et ajouter le rĂ©pertoire "bin" Ă  votre variable d’environnement PATH .

Dans Windows Command Prompt, un programme Windows ne peut pas changer de répertoire de travail courant, mais un fichier .bat le peut. Le script de commande "wcd.bat" exécute le programme wcd qui génÚre un nouveau fichier de commande "wcdgo.bat". "wcd.bat" et exécute ensuite "wcdgo.bat" qui change effectivement de répertoire.

Windows VISTA et ultérieur

Dans un Commande Prompt Windows Vista ou de niveau plus haut, l’accĂšs aux rĂ©pertoires peut ĂȘtre limitĂ©. Pour avoir accĂšs Ă  plus de rĂ©pertoires des droits administrateurs sont requis. Il est possible d’obtenir un Commande Prompt avec des droits administrateurs en cliquant avec le bouton droit sur l’icĂŽne du Commande Prompt puis en choisissant ExĂ©cuter en tant qu’administrateur .

Version Windows PowerShell

Ajouter la fonction suivante Ă  votre profil utilisateur PowerShell. L’emplacement de ce profil est stockĂ© dans la variable $profile. Il est requis que l’une des deux variables d’environnement HOME et WCDHOME soit dĂ©finie.

function wcd
{
CHEMIN\wcdwin32psh.exe $args
& $env:HOME\wcdgo.ps1
}

Remplacer CHEMIN avec l’emplacement oĂč l’exĂ©cutable de wcd a Ă©tĂ© installĂ©. DĂ©marrer un nouveau PowerShell. Wcd pour PowerShell prend uniquement en charge le fournisseur de systĂšme de fichier. Pas d’autres fournisseurs.

Version OS/2 Command Prompt

Dans un OS/2 Command Prompt (cmd.exe) un programme OS/2 ne peut pas changer de rĂ©pertoire de travail courant. C’est pourquoi wcd gĂ©nĂšre un script de commande "wcdgo.cmd" qui doit ĂȘtre exĂ©cutĂ© dans l’interface systĂšme actuelle. Le script "wcd.cmd" exĂ©cute dans un premier temps "wcdos2.exe" qui crĂ©e le script "wcdgo.cmd". Ensuite "wcd.cmd" exĂ©cute le script "wcdgo.cmd".

LOCALISATION

LANG

Le langage principal est sĂ©lectionnĂ© avec la variable d’environnement LANG . Cette variable est composĂ©e de plusieurs parties. La premiĂšre partie, en lettres minuscules, est le code de la langue. La seconde, optionnelle et en lettres majuscules, est le code du pays prĂ©cĂ©dĂ© d’un tiret bas. Il y a Ă©galement une troisiĂšme partie optionnelle : l’encodage des caractĂšres, prĂ©cĂ©dĂ© par un point. Quelques exemples pour les interfaces systĂšme conforme au standard POSIX :

export LANG=fr Français
export LANG=fr_FR Français, France
export LANG=fr_BE Français, Belgique
export LANG=es_ES Espagnol, Espagne
export LANG=es_MX Espagnol, Mexique
export LANG=en_US.iso88591 Anglais, USA, encodage Latin-1

Pour une liste complĂšte des codes de langue et de pays voir le manuel de gettext (1) : <http://www.gnu.org/software/gettext/manual/gettext.html#Language-Codes> Sur les systĂšmes Unix, la commande locale (1) peut ĂȘtre utilisĂ©e pour voir les informations prĂ©cises de localisation.

LANGAGE

Avec la variable d’environnement LANG , il est possible de spĂ©cifier une liste de prioritĂ© de langues sĂ©parĂ©es par des virgules. Wcd donne une prĂ©fĂ©rence Ă  LANGUAGE sur LANG . Par exemple, d’abord nĂ©erlandais puis allemand : "LANGUAGE=nl:de". Il faut d’abord activer la localisation en fixant LANG ou LC_ALL Ă  une valeur autre que C avant de pouvoir utiliser un liste de prioritĂ©s de langue avec la variable LANGUAGE . Voir aussi le manuel de gettext (1) : <http://www.gnu.org/software/gettext/manual/gettext.html#The-LANGUAGE-variable>

Si vous sĂ©lectionnez un langage qui n’est pas disponible, les messages seront affichĂ©s en anglais standard.

WCDLOCALEDIR

La variable d’environnement WCDLOCALEDIR prĂ©vaut sur la variable LOCALEDIR utilisĂ©e pendant la compilation et l’installation de wcd. LOCALEDIR est utilisĂ©e par wcd avec prise en chage de langage natif pour trouver les fichiers de langue. La valeur par dĂ©faut pour GNU est "/usr/local/share/locale". En tapant "wcd -V", wcd affichera la variable LOCALEDIR utilisĂ©e.

Si vous avez installĂ© wcd dans un rĂ©pertoire diffĂ©rent du rĂ©pertoire par dĂ©faut, il vous faut peut ĂȘtre dĂ©finir la variable d’environnement WCDLOCALEDIR pour pointer vers le rĂ©pertoire de locales.

Un exemple pour le cmd Windows :

set WCDLOCALEDIR=c:/my_prefix/share/locale

Un example pour une interface systÚme POSIX :

export WCDLOCALEDIR=$HOME/share/locale

LC_COLLATE

Lorsque plusieurs rĂ©pertoires correspondent, wcd affiche une liste triĂ©e. L’ordre dĂ©pend des paramĂštres de locale. Si la variable d’environnement LANG a Ă©tĂ© dĂ©finie, les correspondances sont triĂ©es comme les sont les dictionnaires ou les annuaires tĂ©lĂ©phonique dans cette langue. Par exemple, les points et les tirets sont ignorĂ©s, ou bien les lettres e avec ou sans accent sont identiques, ou bien la casse est ignorĂ©e.

Le tri donne prĂ©fĂ©rence Ă  la variable d’environnement LC_COLLATE devant LANG . Si vous rendez LC_COLLATE Ă©gal Ă  "C" ou "POSIX", le tri selon la locale est dĂ©sactivĂ©. Par exemple, si vous voulez du nĂ©erlandais mais un tri que n’est pas nĂ©erlandais, vous pouvez faire de la sorte :

export LANG=fr_FR
export LC_COLLATE=C

LC_CTYPE

En ce qui concerne l’encodage de caractĂšres, wcd donnera une prĂ©fĂ©rence Ă  la variable LC_CTYPE sur la variable LANG . Par exemple, pour fixer l’encodage de caractĂšres en UTF-8, le paramĂštrage de l’environnement suivant peut ĂȘtre appliquĂ©.

export LC_CTYPE=fr_FR.UTF-8

LC_ALL

La variable d’environnement LC_ALL si elle est dĂ©finie, prĂ©vaut sur toutes les variables d’environnement de locales qui commencent par LC_ . Wcd donnera une prĂ©fĂ©rence Ă  LC_ALL sur LC_COLLATE et LC_CTYPE .

PAGES DE CODES WINDOWS

Il y a deux groupes de page de code : les pages de code DOS ( OEM ) et les pages de code Windows ( ANSI ). L’encodage par dĂ©faut de Windows, lorsqu’il est configurĂ© avec les paramĂštres de rĂ©gions occidentales, est ANSI CP1252. Les programmes Windows, par exemple le bloc-notes, utilisent cette page de code ANSI par dĂ©faut. La console Windows utilise par dĂ©faut une page de code OEM ( CP437 ou CP850 ) pour compatibilitĂ© avec les programmes DOS. Si vous utilisez une version DOS de wcd dans une console Windows, cela marchera grĂące Ă  la page de code DOS. Cependant la version DOS de wcd ne prend pas en charge de longs noms de rĂ©pertoire et de lecteur rĂ©seau sur Windows.

La version Windows de wcd est un programme Windows natif et utilise la page de code ANSI du systĂšme Windows. Donc sur un Windows configurĂ© pour une rĂ©gion occidentale la page de code CP1252 est utilisĂ©e pour les noms de rĂ©pertoire et les messages. Dans le but d’obtenir des sorties uniformes, indĂ©pendantes des pages de code actives, toutes les versions de Wcd pour Windows traduisent les sorties ANSI en sorties Unicode dans le Command Prompt et le PowerShell.

La police de trame de la console ne prend en charge que la page de code OEM installée avec Windows, et il faut donc changer la page de code de la console à Lucidia Console correctement typé pour faire apparaßtre les lettres Unicode (et ANSI ) correctement.

Les versions non-Unicode de Wcd avant la version 5.2.0 utilisent une sortie entiĂšrement ANSI. Pour ces anciennes versions, la page de code de la console a Ă©tĂ© faite pour ĂȘtre identique Ă  la page de code du systĂšme (changĂ© Ă  1252) dans le but de faire fonctionner wcd pour Windows correctement avec des caractĂšres spĂ©ciaux tels que les caractĂšres avec accent ou le symbole de l’Euro.

La page de code Windows peut ĂȘtre changĂ©e via les options de rĂ©gion du Panneau de ContrĂŽle. La page de code de la console Windows est changĂ©e avec la commande "chcp".

Lorsque vous tapez "wcd -V", l’encodage de caractĂšres effectif utilisĂ© par wcd est affichĂ©. Tapez la commande "chcp" pour afficher la page de codes active de la console Windows.

UNICODE

Wcd a une prise en charge optionnelle de l’Unicode. Pour voir si wcd a Ă©tĂ© empaquetĂ© avec la prise en charge de l’Unicode, tapez "wcd -V". Si votre terminal/console et la police le prend en charge, vous devriez voir le symbole de l’Euro ainsi que des caractĂšres chinois (voulant dire : « chinois »).

Wcd a Ă©tĂ© converti de façon logicielle Ă  l’Unicode. En son coeur, Wcd traite toutes les donnĂ©es comme un flux d’octets. Seules les lignes affichĂ©es Ă  l’écran sont converties Ă  la volĂ©e en caractĂšres Unicode larges. Wcd s’appuie entiĂšrement sur des fonctions de la libc et n’a pas de code UTF-8 spĂ©cifique. Voir aussi <http://www.cl.cam.ac.uk/˜mgk25/unicode.html>.

Wcd a une prise en charge optionnelle de mise en correspondance avec de l’Unicode normalisĂ©. Pour dĂ©terminer si Wcd prend en charge la normalisation, tapez "wcd -V". Wcd avec une prise en charge de la normalisation Unicode fera correspondre les noms Unicode en se basant sur une Ă©quivalence compatible . Sans prise en charge de la normalisation Unicode, les noms sont mis en correspondance lorsque leur binaires sont Ă©quivalents. Voir aussi <http://en.wikipedia.org/wiki/Unicode_normalization>

UTF-8 sur Unix/Linux

Pour voir les caractĂšres UTF-8, votre console/terminal doit Ă©galement prendre en charge l’ UTF-8. La version xterm empaquetĂ©e avec XFree86 4.0 ou supĂ©rieur inclue une prise en charge de l’ UTF-8. Pour l’activer, dĂ©marez xterm (1) dans une locale UTF-8 et utilisez une police avec un encodage iso10646-1, par exemple avec

LC_CTYPE=en_GB.UTF-8 xterm -u8 -fn '-Misc-Fixed-Medium-R-SemiCondensed--13-120-75-75-C-60-ISO10646-1'

Les distributions modernes de GNU/Linux prennent en charge l’ UTF-8 par dĂ©faut. D’autres encodages de caractĂšres sur plusieurs octets devraient Ă©galement fonctionner, mais cela n’a pas Ă©tĂ© testĂ©.

Wcd suppose que les fichiers d’arborescence sont encodĂ©s dans l’encodage de caractĂšres local. Il n’y a pas d’Indicateur d’Ordre des Octets Ă©crit dans les fichiers d’arborescence.

UTF-16 sur Windows

Sur Windows, l’Unicode est pris en charge pour toutes les versions de PowerShell, et dans le Windows Command Prompt sur Windows 7 (ou ultĂ©rieur). Unicode fonctionne Ă©galement dans Take Command ou TCC/LE Ă©ditĂ©s par JP Software, et pouvant ĂȘtre utilisĂ©s sur des version de Windows plus anciennes (XP/Vista).

Sur Windows, tous les noms de rĂ©pertoire sur le disque sont encodĂ©s en Unicode UTF-16. Pour des programmes Windows non Unicode, les caractĂšres Unicode sont traduits vers la page de code ANSI par dĂ©faut. Cette traduction de caractĂšres ne faisant pas partis du paramĂštrage rĂ©gional n’est pas possible et les programmes non Unicode affichent un point d’intĂ©rogation ou bien un mauvais caractĂšres.

Wcd avec prise en charge de l’Unicode lit les noms de rĂ©pertoire encodĂ© en UTF-16 et les convertis de façon interne en UTF-8. Tous les fichiers d’arborescence sont encodĂ©s en UTF-8 et ne sont pas compatibles avec la version non Unicode de Wcd. Wcd crĂ©era un script « go » en UTF-8.

Toutes les versions de Windows PowerShell sont capable d’exĂ©cuter des scripts encodĂ©s en UTF-8 s’il y a un BOM UTF-8 dans le script.

Depuis Windows 7 il est possible de changer de rĂ©pertoire avec un script batch dans Windows Command Prompt vers un rĂ©pertoire avec une lettre Unicode dans le nom. Le nom du rĂ©pertoire doit ĂȘtre encodĂ© en UTF-8, et le script batch ne doit pas avoir de BOM. La page de code active du Command Prompt doit ĂȘtre fixĂ©e Ă  65001 ( UTF-8 ) avant la commande cd. Wcd pour Command Prompt crĂ©era un script « go » "wcdgo.bat". Dans un premier temps, il change la page de code Ă  65001 puis change de rĂ©pertoire et enfin fixe la page de code Ă  sa valeur initiale.

Vous devez fixer la police à True Type Lucida Console (et non une police de trame) lorsque les lettres n’apparaüssent pas correctement.

La version pour Windows non Unicode de Wcd peut lire des fichiers d’arborescence Unicode depuis la version 5.2.0 s’il y a un Indicateur d’Ordre des Octets ( BOM ) dans le fichier (voir <https://fr.wikipedia.org/wiki/Indicateur_d%27ordre_des_octets>), mais il ne peut se dĂ©placer vers des rĂ©pertoires dont le nom contient des lettres Unicodes et qui ne font pas parties de la page de code ANSI par dĂ©faut du systĂšme. La version pour Windows non Unicode Ă©crit un BOM dans les fichiers d’arborescence encodĂ©s en UTF-8 depuis la version 5.2.0, ce qui les rend Ă©galement lisible par le bloc-notes.

UTF-8 sur Cygwin

Cygwin prend en charge l’Unicode depuis la version 1.7. La couche Cygwin s’occupe de la conversion des noms Unicode UTF-16 Windows en UTF-8. Donc des programmes tels que Wcd n’ont pas besoin de savoir cela et peuvent fonctionner en utilisant l’encodage UTF-8 sur Unix/Linux. Fixez l’encodage de caractĂšres Ă  UTF-8 avec les variables d’environnement LANG ou LC_CTYPE . Il peut ĂȘtre nĂ©cessaire de rĂ©examiner les disques. Il faut fixer la police Ă  True Type Lucida Console (et non Ă  une police de trame) si vous utilisez la console Cygwin par dĂ©faut.

La version Cygwin se comporte de la mĂȘme façon que la version Unix de wcd. Il n’y a pas de BOM Ă©crit dans les fichiers d’arborescence, et il est supposĂ© qu’ils sont encodĂ©s dans l’encodage de caractĂšres de la locale Cygwin .

FICHIERS

Si la variable d’environnement WCDHOME est dĂ©finie, wcd utilisera WCDHOME au lieu de HOME . Tous les fichiers "*.wcd" sont des fichiers texte. Ils peuvent ĂȘtre modifiĂ©s avec un Ă©diteur de texte. La version Windows Command Prompt de wcd se comporte comme la version DOS. La version Cygwin de wcd se comporte comme la version Unix.
wcd.exe

Le programme. Dans les interfaces systĂšme Unix, le programme est toujours appelĂ© par une fonction ou un alias parce que le rĂ©pertoire courant de travail d’une interface systĂšme Unix ne peut ĂȘtre changĂ© que par la commande cd intĂ©grĂ©e. Voir Ă©galement la section INSTALLATION.

fichier d’arborescence par dĂ©faut

C’est le fichier d’arborescence par dĂ©faut oĂč wcd cherche les correspondances. S’il n’est pas lisible, wcd en crĂ©era un nouveau.

S<DOS :> \treedata.wcd ou %HOME%\treedata.wcd
S<Unix :> $HOME/.treedata.wcd

fichier d’arborescence supplĂ©mentaire

Un fichier d’arborescence supplĂ©mentaire optionel. S’il existe et est lisible, wcd tentera de trouver des correspondances depuis ce fichier Ă©galement.

S<DOS :> \extra.wcd ou %HOME%\extra.wcd
S<Unix :> $HOME/.extra.wcd

fichier de bannissement

Wcd place dans ce fichier optionnel les chemins bannis. Voir l’option -b . Les caractĂšres gĂ©nĂ©riques sont pris en charge.

S<DOS :> \ban.wcd ou %HOME%\ban.wcd
S<Unix :> $HOME/.ban.wcd

fichier d’alias

Fichier optionnel avec les alias wcd. Voir l’option -l .

S<DOS :> \alias.wcd ou %HOME%\alias.wcd
S<Unix :> $HOME/.alias.wcd

fichier de pile

Wcd stocke sa pile dans ce fichier. La lettre de lecteur peut ĂȘtre changĂ©e avec l’option -d .

S<DOS :> c:\stack.wcd ou %HOME%\stack.wcd
S<Unix :> $HOME/.stack.wcd

Le nom du fichier de pile peut ĂȘtre changĂ© avec la variable d’environnement WCDSTACKFILE . Voir la section VARIABLES D ’ ENVIRONNEMENT.

script « go »

C’est le script d’interface systĂšme que wcd.exe crĂ©e Ă  chaque fois. Il est inclus par une function ou un alias. La lettre de lecteur peut ĂȘtre changĂ©e avec l’option -d . Pour des raisons historiques, il est placĂ© dans "$HOME/bin" par dĂ©faut sur les systĂšmes Unix. Le rĂ©pertoire de ce fichier peut ĂȘtre changĂ© avec l’option -G .

interface systĂšme S<DOS :> c:/wcd.go or $HOME/wcd.go
Windows Command S<Prompt :> c:\wcdgo.bat or %HOME%\wcdgo.bat
Windows S<PowerShell :> $env:HOME\wcdgo.ps1
S<WinZsh :> $HOME/wcd.go
S<Cygwin/MSYS :> $HOME/bin/wcd.go
OS/2 Command S<Prompt :> c:\wcdgo.cmd or %HOME%\wcdgo.cmd
interface systĂšme S<OS/2 :> c:/wcd.go or $HOME/wcd.go
S<Unix :> $HOME/bin/wcd.go

fichier d’arborescence relative

Fichier texte avec les chemins relatifs Ă  REP . Voir les options +S , -n et +n .

S<DOS :> CHEMIN\rtdata.wcd
S<Unix :> CHEMIN/.rtdata.wcd

VARIABLES D’ENVIRONNEMENT

HOME

Wcd utilise par dĂ©faut la variable d’environnement HOME pour dĂ©terminer oĂč stocker ses fichiers. Voir Ă©galement la section FICHIERS. Cela peut ĂȘtre modifiĂ© avec la variable d’environnement WCDHOME .

HOME dĂ©finit Ă©galement oĂč commencer l’examen du disque lorsque l’option -s est utilisĂ©e. Ceci peut ĂȘtre modifiĂ© avec la variable d’environnement WCDSCAN .

Pour la version Unix, Cygwin, Windows PowerShell, WinZsh et MSYS, il est nĂ©cessaire que HOME ou WCDHOME soient dĂ©finies. L’utilisation de ces variables est optionnelle pour les autres versions de wcd.

Si HOME est dĂ©fini sur DOS/Windows, wcd placera tous ses fichiers (treedata.wcd, extra.wcd, alias.wcd, ban.wcd, wcd.go) dans le rĂ©pertoire HOME . Le comportement de wcd est alors identique Ă  celui de la version Unix de wcd. Wcd examinera le disque depuis HOME par dĂ©faut. Les lecteurs ne seront pas automatiquement examinĂ©s lors d’un basculement. Vous devez explicitement le demander Ă  wcd. Par exemple :

wcd -S c: -A d: -A e:

La correspondance des répertoires est maintenant globale à tous les lecteurs examinés.

WCDHOME

La variable d’environnement WCDHOME peut ĂȘtre utilisĂ©e pour changer l’emplacement des fichiers de wcd. Si HOME et WCDHOME sont toutes deux dĂ©finies, WCDHOME sera utilisĂ©e Ă  la place de HOME .

Dans les versions antĂ©rieures Ă  la version 5.1.5, WCDHOME changeait Ă©galement le rĂ©pertoire d’examen par dĂ©faut. Cela a Ă©tĂ© modifiĂ©. Depuis la version 5.1.5, WCDHOME ne modifie pas le rĂ©pertoire d’examen par dĂ©faut. Voir l’option -s . Depuis la version 5.1.5, la variable d’environnement WCDSCAN peut ĂȘtre utilisĂ©e pour modifier le rĂ©pertoire d’examen par dĂ©faut.

Exemple pour DOS, Windows, OS/2 Command Prompt :

set WCDHOME=C:\Utilisateurs\erwin\wcd

Un exemple pour les interfaces systÚme POSIX :

export WCDHOME="$HOME/.wcd"

Un exemple pour les interfaces systÚme Csh :

setenv WCDHOME "$HOME/.wcd"

WCDSCAN

Utilisez la variable d’environnement WCDSCAN pour modifier le rĂ©pertoire d’examen par dĂ©faut HOME . Une liste sĂ©parĂ©e par des virgules (Unix) peut ĂȘtre utilisĂ©e pour spĂ©cifier plusieurs rĂ©pertoires. Sur DOS/Windows, la liste doit ĂȘtre sĂ©parĂ©e par des point-virgules.

Exemples pour DOS, Windows, OS/2 Commande Prompt :

set WCDSCAN=C:\Utilisateurs\erwin;D:\donnees
set WCDSCAN=%HOMELECTEUR%%HOMECHEMIN%;\\lecteurprojet\projetX

Un exemple pour les interfaces systÚme POSIX :

export WCDSCAN="$HOME:/disqueprojet/projetX"

Un exemple pour les interfaces systÚme Csh :

setenv WCDSCAN "$HOME:/disqueprojet/projetX"

WCDFILTER

SpĂ©cifiez des filtres avec la variable d’environnment WCDFILTER . Tous les rĂ©pertoires qui ne correspondent pas au(x) filtre(s) sont ignorĂ©s. Une liste peut ĂȘtre donnĂ©es en sĂ©parant les filtres avec le sĂ©parateur de chemin de l’interface systĂšme, de façon similaire Ă  la dĂ©finition de la variable PATH . La sensibilitĂ© Ă  la casse est dictĂ©e par le systĂšme d’exploitation.

Un exemple pour DOS, Windows, OS/2 Commande Prompt :

set WCDFILTER=projets;doc

Un exemple pour les interfaces systÚme POSIX :

export WCDFILTER="projets:doc"

Un exemple pour les interfaces systÚme Csh :

setenv WCDFILTER "projets:doc"

WCDBAN

Les chemins spĂ©cifiĂ©s par la variable d’environnement WCDBAN seront bannis par wcd. Voir aussi l’option -b . Donnez une liste de chemins sĂ©parĂ©s par le sĂ©parateur de l’interface systĂšme utilisĂ© pour PATH .

WCDEXCLUDE

Les chemins spĂ©cifiĂ©s par la variables d’environnement WCDEXCLUDE seront exlus par wcd. Voir aussi les options -x et -xf . Donnez une liste de chemins sĂ©parĂ©s par le sĂ©parateur de l’interface systĂšme utilisĂ© pour PATH .

Un exemple pour DOS, Windows, OS/2 Commande Prompt :

set WCDEXCLUDE=*/windows;*/temp;*CVS

Un exemple pour les interfaces systÚme POSIX :

export WCDEXCLUDE="/dev:/tmp:*CVS"

Un exemple pour les interfaces systÚme Csh :

setenv WCDEXCLUDE "/dev:/tmp:*CVS"

WCDUSERSHOME

DĂ©fini la racine des rĂ©pertoires d’utilisateur. Sur DOS/Windows, la valeur par dĂ©faut est "\\users". Sur Unix/Cygwin, la valeur par dĂ©faut est "/home". Cette variable est utilisĂ©e pour examiner les fichiers d’arborescence d’autres utilisateurs. Voir les options -u et +u . En mode verbeux, wcd imprimera tous les filtres, bannissements et exclusions. Voir l’option -v .

WCDSTACKFILE

Wcd donne une préférence à WCDSTACKFILE sur le nom du fichier de pile par défaut (voir la section FICHIERS ). Avec cette variable, chaque interface systÚme (ou émulateur de terminal) peut avoir sa pile privée de répertoires utilisés.

Pour utiliser un fichier YYYYMMDD-HHMMSS unique basé sur le temps pour chaque interface systÚme intéractive ouverte.

export WCDSTACKFILE=$HOME/.wcd/stack.$(date +%Y%m%d-%H%M%S)

Pour une pile par xterm (1), utiliser la variable d’environnement xterm WINDOWID :

export WCDSTACKFILE=$HOME/.wcd/stack.$WINDOWID

Pour GNU screen (1), pour utiliser une pile par écran :

export WCDSTACKFILE=$HOME/.wcd/stack.$WINDOW

TERMINFO

Si la variable d’environnement TERMINFO est dĂ©finie, wcd avec l’interface ncurses recherche une dĂ©finition de terminal localement avant de le faire Ă  l’emplacement standard. Cela est utile si les dĂ©finitions du terminal ne sont pas dans un emplacement standard. Les emplacements couramment utilisĂ©s sont "/usr/lib/terminfo" et "/usr/share/terminfo".

PDC_RESTORE_SCREEN

Wcd avec l’interface PDCurses reconnaĂźt la variable d’environnement PDC_RESTORE_SCREEN . Si cette variable d’environnement est dĂ©finie, PDCurses fera une copie du contenu de l’écran au moment au wcd est dĂ©marré ; lorsque wcd quitte, l’écran sera restaurĂ©. Un exemple pour Windows Command Prompt :

set PDC_RESTORE_SCREEN=1

Windows n’autorise la sauvegarde que d’un petit tampon. Il n’est donc pas toujours possible de tout restaurer. Des donnĂ©es inutiles peuvent ĂȘtre affichĂ©es dans la console aprĂšs que wcd ait terminĂ© si vous avez dĂ©fini une largeur de tampon importante.

SHELL

L’impression de "#!$SHELL" sur la premiĂšre ligne du script « go » est nĂ©cessaire pour une interface systĂšme de type POSIX pour les caractĂšres de 8 bits. Certaines interfaces systĂšme considĂšrent autrement que le script « go » est un fichier binaire et ne l’incluerons pas. Dans Cygwin bash, la variable SHELL doit ĂȘtre dĂ©finie dans l’environnement en utilisant la commande "export", sinon wcd ne peut pas lire cette variable.

BASH

Wcd pour l’interface systĂšme DOS utilise $BASH Ă  la place de $SHELL parce que $SHELL pointe vers l’interface de commandes systĂšme. Il est potentiellement requis de dĂ©finir $BASH avec une commande "export", autrement wcd ne peut pas lire la variable.

VOIR AUSSI

sh (1), bash (1), csh (1), ksh (1), zsh (1), locale (1), ncurses (1),

AUTEURS

Wcd a été écrit par Erwin Waterlander <waterlan@xs4all.nl>

Project homepage : <http://waterlan.home.xs4all.nl/>

SourceForge : <http://sourceforge.net/projects/wcd/>

La mise en page du manuel a été faite par Jari Aalto <jari.aalto@cante.net>.

NCD fut initialement écrit par Brad Kingsbury pour « Norton Utilities » de Peter Norton aux environs de 1987. Voir aussi <http://www.softpanorama.org/OFM/norton_change_directory_clones.shtml>