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.

Guide de référence de svnlook : outil d'exploration du contenu d'un dépôt Subversion


svnlook est un utilitaire en ligne de commande pour examiner le contenu d'un dépôt Subversion. Il n'effectue aucune modification sur le dépôt, se contentant juste de « jeter des coups d'œil ». svnlook est utilisé typiquement par les procédures automatiques, mais un administrateur de dépôt peut aussi y trouver un intérêt à des fins de diagnostic.

Comme svnlook fonctionne par un accès direct au dépôt (et ne peut ainsi être utilisé que sur la machine qui héberge le dépôt), il fait référence au dépôt par un chemin et non par une URL.

Si aucune révision ou transaction n'est spécifiée, svnlook utilise par défaut la révision la plus jeune (c'est-à-dire récente) du dépôt.

Les options de svnlook sont globales, de la même manière que pour svn et svnadmin ; Cependant, la plupart des options ne s'appliquent qu'à une seule sous-commande puisque le périmètre des fonctionnalités de svnlook est (intentionnellement) limité :

Options de svnlook

--copy-info

Détailler les informations relatives aux sources de copies.

--diff-cmd CMD

Utiliser un programme externe pour montrer les différences entre fichiers. Quand svnlook diff est appelé sans cette option, il utilise le moteur de calcul de différences interne à Subversion, qui produit des diffs unifiés par défaut. Si vous voulez utiliser un programme externe pour ce calcul, utilisez l'option --diff-cmd. Vous pouvez alors passer des options complémentaires à ce programme externe en utilisant l'option --extensions (-x).

--diff-copy-from

Afficher les différences par rapport à la source de la copie.

--extensions (-x) ARG

Spécifie les personnalisations que Subversion doit apporter lors du calcul des différences. Les extensions possibles sont :

--ignore-space-change (-b)

Ignorer les modifications relatives au nombre d'espaces.

--ignore-all-space (-w)

Ignorer toutes les espaces.

--ignore-eol-style

Ignorer les modifications relatives aux caractères de fins de lignes.

--show-c-function (-p)

Afficher le nom des fonctions C dans la sortie du diff.

--unified (-u)

Afficher trois lignes de contexte, conformément au standard diff unifié.

La valeur par défaut est -u.

Notez que quand Subversion est configuré pour faire appel à un programme diff externe, la valeur de l'option --extensions (-x) n'est pas restreinte aux options citées supra, mais peut comprendre n'importe quelle argument que Subversion doit passer au programme externe. Si vous souhaitez passer plusieurs arguments, vous devez les mettre tous à l'intérieur de guillemets.

--full-paths

Afficher les chemins complets plutôt qu'une représentation hiérarchique indentée des composantes des chemins.

--ignore-properties

Ignorer les modifications de propriétés.

--limit (-l) ARG

Limiter l'affichage à ARG éléments maximum ARG.

--no-diff-deleted

Ne pas afficher les différences relatives aux fichiers supprimés. Le comportement par défaut quand un fichier est supprimé dans une révision consiste à afficher les mêmes différences que si le fichier était toujours présent mais que son contenu ait été complètement enlevé.

--no-diff-added

Ne pas afficher les différences relatives aux fichiers ajoutés. Le comportement par défaut quand un fichier est ajouté dans une révision consiste à afficher les mêmes différences que si vous aviez ajouté tout le contenu du fichier dans un fichier existant et vide.

--non-recursive (-N)

Ne travailler que sur ce seul répertoire.

--properties-only

N'afficher que les modifications de propriétés.

--revision (-r) REV

Travailler sur la révision passée en paramètre.

--revprop

Travailler sur les propriétés de révision au lieu des propriétés de fichiers ou répertoires. Cette option requiert de passer aussi l'option --revision (-r) pour spécifier la révision sur laquelle travailler.

--show-inherited-props

Avec svnlook propgetet svnlook proplist, afficher aussi les propriétés héritées par un chemin.

--transaction (-t) ID

Travailler sur la transaction ID passée en paramètre.

--show-ids

Afficher l'identifiant du nœud de révision pour chaque objet dans l'arborescence.

--verbose (-v)

Être bavard. Par exemple, lorsqu'elle est utilisée avec svnlook proplist, Subversion affiche non seulement la liste des propriétés mais également leurs valeurs.

--xml

Afficher au format XML.