This text is a work in progress—highly subject to change—and may not accurately describe any released version of the Apache™ Subversion® software. Bookmarking or otherwise referring others to this page is probably not such a smart idea. Please visit http://www.svnbook.com/ for stable versions of this book.
svn list (ls) — Lister le contenu de répertoires dans le dépôt.
svn list [CIBLE[@REV]...]
Lister chaque fichier CIBLE
et le
contenu de chaque répertoire CIBLE
comme
ils existent dans le dépôt. Si CIBLE
est
un chemin de la copie de travail, alors l'URL correspondante sur le
dépôt est utilisée.
Par défaut, la CIBLE
est
« .
», c'est-à-dire l'URL du dépôt
pour le répertoire courant de la copie de travail.
Avec l'option --verbose
, svn
list affiche les champs suivants pour chaque
élément :
le numéro de révision de la dernière propagation ;
l'auteur de la dernière propagation ;
Si l'élément est verrouillé, la lettre « O » (lisez la section svn info pour plus de détails) ;
la taille (en octets) ;
la date et l'heure de la dernière propagation.
Avec l'option --xml
, l'affichage est au format
XML format (avec une entête et un élément document qui encadre le
tout à moins que l'option --incremental
soit aussi
spécifiée). Toute l'information disponible est affichée, l'option
--verbose
n'est pas acceptée.
svn list est particulièrement utile quand vous voulez visualiser des fichiers dans le dépôt sans les télécharger dans votre copie de travail :
$ svn list http://svn.red-bean.com/repos/test/support LISEZMOI.txt INSTALL exemples/ …
Vous pouvez passer l'option --verbose
pour
obtenir des informations complémentaires, un peu comme la commande
Unix ls -l :
$ svn list -v file:///var/svn/depot 16 sally 28361 Jan 16 23:18 LISEZMOI.txt 27 sally 0 Jan 18 15:27 INSTALL 24 harry Jan 18 11:27 exemples/
Vous pouvez obtenir un affichage au format XML avec la commande
svn list en spécifiant l'option
--xml
:
$ svn list --xml http://svn.red-bean.com/repos/test <?xml version="1.0"?> <lists> <list path="http://svn.red-bean.com/repos/test"> <entry kind="dir"> <name>exemples</name> <size>0</size> <commit revision="24"> <author>harry</author> <date>2008-01-18T06:35:53.048870Z</date> </commit> </entry> … </list> </lists>
Pour plus de détails, lisez la section précédente la section intitulée « Contenu des dossiers suivis en versions ».