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.

À l'aide !
Précédent  Chapitre 2. Utilisation de base  Suivant

À l'aide !

Il va de soi que ce livre existe dans le but d'informer et d'assister les utilisateurs de Subversion, qu'ils soient débutants ou chevronnés. Cependant, pour plus de confort, le client texte interactif de Subversion inclut sa propre documentation, réduisant le besoin d'aller chercher un livre dans les rayonnages (qu'ils soient en bois, virtuels ou quoi que soit d'autre). La commande svn help est la porte d'entrée vers cette documentation.

$ svn help 
Client texte interactif de Subversion, version 1.8.13.
Entrer 'svn help <sous-commande>' pour l'aide sur une sous-commande.
Entrer 'svn --version' pour avoir la version et les modules d'accès (RA)
    ou 'svn --version --quiet' pour la version seule.

La plupart des sous-commandes prennent en argument des dossiers et/ou
des fichiers, et s'appliquent récursivement sur les dossiers.
Si aucun argument n'est précisé à une telle sous-commande, elle s'applique
par défaut récursivement sur le dossier courant, qui est inclus.

Sous-commandes disponibles :
…

Comme indiqué dans la sortie d'écran précédente, vous pouvez demande de l'aide sur une sous-commande particulière en lançant svn help SOUS_COMMANDE. Subversion affiche le message complet d'utilisation de cette sous-commande, ce qui inclut la syntaxe, les options et le comportement :

$ svn help help 
help (?, h): Décrit l'usage de ce programme ou de ses sous-commandes.
usage : help [SOUS_COMMANDE...]

Options globales :
  --username ARG           : précise le nom d'utilisateur ARG
  --password ARG           : précise le mot de passe ARG
…

Options, sélecteurs, drapeaux… Doux Jésus !

Le client texte interactif de Subversion possède de nombreux modificateurs de commandes, que nous appelons « options ». Vous trouverez la liste des options disponibles pour une sous-commande svn donnée, ainsi qu'un ensemble d'options disponibles globalement pour toutes les sous-commandes, à la fin du message d'utilisation de la sous-commande.

il existe deux types d'options distincts : les options courtes sont constituées d'un unique tiret suivi d'une unique lettre, tandis que les options longues sont formées de deux tirets suivis d'un certain nombre de lettres (c'est-à-dire respectivement -s et --ceci-est-une-option-longue). Chaque option possède une option longue, mais seules certaines options ont aussi un format court (ce sont généralement des options qui sont utilisées très souvent). Par souci de clarté, nous utilisons généralement la forme longue dans les exemples de code, mais lorsque nous décrivons les options, s'il existe une forme courte, nous donnons à la fois la forme longue (pour plus de clarté) et la forme courte (car plus facile à retenir). En ce qui vous concerne, utilisez la forme qui vous convient le mieux.

Beaucoup de distributions de Subversion sur des plateformes de type Unix incluent des pages de manuel qui peuvent être affichées en utilisant la commande man, mais ces pages ne recèlent généralement que des pointeurs vers d'autres sources d'aide réelle, telles que le site Internet du projet et le site qui héberge ce livre. Par ailleurs, plusieurs entreprises proposent de l'assistance et de l'aide pour Subversion, habituellement par l'intermédiaire de forums de discussion en ligne et de prestations de conseil. Et bien sûr, Internet regorge de discussions relatives à Subversion, prêtes à être mises au jour à l'aide de votre moteur de recherche favori. L'aide de Subversion ne se trouve jamais bien loin.

Précédent  Niveau supérieur  Suivant
Chapitre 2. Utilisation de base  Sommaire  Enregistrement de données dans le dépôt