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.

Nom

svn list (ls) — Lister le contenu de répertoires dans le dépôt.

Synopsis

svn list [CIBLE[@REV]...]

Description

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.

Options

Exemples

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 ».