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