CVS2SVN(1) Commandes Utilisateur CVS2SVN(1) NOM cvs2svn - convertit un référentiel cvs en référentiel subversion SYNTAXE cvs2svn [OPTION]... OUTPUT-OPTION CVS-REPOS-PATH cvs2svn [OPTION]... --options=PATH DESCRIPTION Créer un nouveau référentiel Subversion basée sur l'historique des versions stockées dans un référentiel CVS. Chaque CVS sera reflété dans le dépôt Subversion, y compris des informations comme la date du commit et de l'id de celui qui l'a fait. CVS-REPOS-PATH est l'adressage système de fichier (filesystem path) de la partie du référentiel CVS que vous voulez convertir. Il n'est pas possible de convertir un référentiel CVS à laquelle vous avez seulement un accès à distance, voir la FAQ pour plus d'informations. Ce chemin n'a pas à être le répertoire du plus haut niveau d'un dépôt CVS; il peut pointer un projet à l'interieur d'un référentiel, c'est dans ce cas seulement que le projet sera converti. Ce chemin d'accès ou un de ses répertoires parents doit contenir un sous-répertoire appelé CVSROOT (malgré que le répertoire CVSROOT peut être vide). De multiples dépôts CVS peuvent être convertis en un seul référentiel Subversion en un seul passage de cvs2svn, mais seulement en utilisant un fichier --options. OPTION DE FICHIER --options=path Lire les options de conversion du path plutôt qu'à partir de la ligne de commande. Cette option permet une souplesse de conversion beaucoup plus grande que ce qui peut être obtenu en utilisant la ligne de commande seule. Voir la documentation pour plus d'informations. Seules les options en ligne de commande suivantes sont autorisées en combinaison avec --options: -h/--help, --help-passes, --version, -v/--verbose, -q/--quiet, -p/--pass/--passes, --dry-run, and --profile. OPTIONS DE SORTIE -s, --svnrepos path Écrit la sortie de la conversion en un dépôt Subversion situé au path (chemin d'accès). Cette option entraîne un nouveau dépôt Subversion sera créé à chemin d'accès sauf si l'option --existing-svnrepos est aussi utilisée. --existing-svnrepos Chargez le référentiel CVS convertis dans un dépôt Subversion existants, au lieu de créer un nouveau référentiel. (Cette option doit être utilisée en combinaison avec -s/--svnrepos.) Le dépôt doit être vide ou ne contiennent pas de chemins qui se recoupent avec celles qui résultent de la conversion. S'il vous plaît noter que vous avez besoin de l'autorisation en écriture pour les fichiers du référentiel. --fs-type Passer --fs-type=type à "svnadmin create" lors de la création d'un nouveau référentiel. --bdb-txn-nosync Passer --bdb-txn-nosync à "svnadmin create" lors de la création d'un nouveau référentiel Subversion BDB-style. --create-option=opt Choisir opt à "svnadmin create" lorsque vous créez un nouveau référentiel Subversion (peut être spécifié à plusieurs reprises pour passer des options multiples). --dumpfile=path Produire simplement un dumpfile; ne pas faire un commit dans un dépôt SVN. Ecrire le dumpfile au path. --dry-run Ne pas créer un répertoire ou (dumpfile) une image mémoire, il suffit d'imprimer les détails de ce que cvs2svn ferait si il était réellement la conversion de votre référentiel. OPTIONS DE CONVERSION --trunk-only Convertit seulement les commits tronc, pas de balises ni de branches. --trunk=path Définissez le chemin du plus haut niveau à utiliser pour le tronc dans le dépôt Subversion. La valeur par défaut est le tronc. --branches=path Définissez le chemin du plus haut niveau à utiliser pour les branches dans le dépôt Subversion. La valeur par défaut est branches. --tags=path Définissez le chemin du plus haut niveau à utiliser pour les balises (tags) dans le dépôt Subversion. La valeur par défaut est balises. --no-prune Lorsque tous les fichiers sont supprimés à partir d'un répertoire dans le dépôt Subversion, ne supprimez pas le répertoire vide (valeur par défaut est de supprimer tous les répertoires vides. --encoding=encoding Utiliser le codage comme l'encodage des noms de fichiers, des messages de log, et des noms d'auteurs dans le répertoire CVS. Cette option peut être spécifiée plusieurs fois, dans ce cas, les encodages sont testé dans l'ordre jusqu'à une éventuelle réussite. Par défaut: ascii. Voir http://docs.python.org/lib/standard-encodings.html pour une liste des autres encdage standard. --fallback-encoding=encoding Si aucun des codages spécifiés avec -- encoding réussi à décoder un nom d'auteur ou de message de log, alors revennez à l'utilisation du mode d'encodage à perte 'replace'. L'utilisation de cette option peut provoquer une perte d'information, mais au moins il permet à la conversion d'aller jusqu'à la fin. Cette option affecte uniquement l'encodage des messages de log et noms d'auteurs, il n'y a pas d'encodage de secours pour les noms de fichiers. (En utilisant un - fichier d'options, il est possible de spécifier un encodage de secours pour les noms de fichiers.) Par défaut: désactivé. --symbol-transform=pattern:replacement Transforme les noms de symboles RCS/CVS avant de les entrer dans Subversion. pattern est un motif de regexp Python qui est comparré avec le nom entier du symbole, le remplacement est un remplacement en utilisant la syntaxe d'une regexp de référence Python. Vous pouvez spécifier autant de ces options que vous voulez, elles seront appliquées dans l'ordre indiqué sur la ligne de commande. --symbol-hints=path Lire les notes de conversion de symbole depuis le path. Le format du path est le même que le format de sortie par --write-symbol-info, à savoir un fichier texte avec quatre colonnes séparées par des espaces: project-id, symbol, conversion, et parent-lod-name. project-id est l'identifiant numérique du projet auquel appartient le symbole, comptage à partir de 0. projet-ID peut être réglé à '.' si la spécificité du projet (project-spécificity) n'est pas demandé. symbol-name est le nom du symbole étant précisé. conversion précise comment le symbole doit être convertie, et peut être une valeurs de 'branch'(branche), 'tag'(balises), ou (exclu)'exclude'. Si la conversion est '.', Alors cette règle n'affecte pas la façon dont le symbole est converti. parent-lod-name est le nom du symbole à partir duquel ce symbole doit apparaitre, ou 'trunk'. Si le symbole doit apparaitre à partir du trunk. Si le parent-lod-name est omis ou '.', Alors cette règle n'affecte pas le parent préféré de ce symbole. Le fichier peut contenir des lignes vides ou les lignes de commentaire (les lignes dont le premier caractère non-blanc est'#'). --force-branch=regexp Forcer les symboles dont les noms correspondent à regexp qui sont des branches. regexp doit correspondre au nom complet du symbole. --force-tag=regexp Forcer les symboles dont les noms correspondent à regexp qui sont des étiquettes (tags, balises). regexp doit correspondre au nom complet du symbole. --exclude=regexp Exclure les branches et les étiquettes dont les noms correspondent à la regexp de la conversion. regexp doit correspondre au nom complet du symbole. --keep-trivial-imports Ne pas exclure des branches qui ont été utilisés que pour une seule importation. (Par défaut ces branches sont exclues, car elles sont généralement créées par l'utilisation inappropriée de cvs import.) --symbol-default=opt Précisez comment convertir les symboles ambigus (ceux qui figurent dans l'archive CVS comme étant les deux branches et tags). opt doit être «heuristique» (décider comment traiter chaque symbole ambigu selon qu'elle a été utilisée plus souvent comme une branch/tag dans le CVS), 'stricte' (pas de défaut, chaque symbole ambigu doit être résolu manuellement en utilisant --force-branch, --force-tag, ou --exclude), 'branch' (Traiter chaque symbole ambigu comme une branche), ou 'tag' (traitement de chaque symbole ambigu comme une étiquette (tag)). La valeur par défaut est 'heuristic'. --keep-cvsignore Include .cvsignore files in the output. (Normally they are unneeded because cvs2svn sets the corresponding svn:ignore prop- erties.) --retain-conflicting-attic-files If a file appears both inside an outside of the CVS attic, retain the attic version in an SVN subdirectory called ‘Attic’. (Normally this situation is treated as a fatal error.) --username=name Set the default username to name when cvs2svn needs to generate a commit for which CVS does not record the original username. This happens when a branch or tag is created. The default is to use no author at all for such commits. --cvs-revnums Record CVS revision numbers as file properties in the Subversion repository. (Note that unless it is removed explicitly, the last CVS revision number will remain associated with the file even after the file is changed within Subversion.) --mime-types=file Specify an apache-style mime.types file for setting svn:mime- type. --eol-from-mime-type For files that don’t have the kb expansion mode but have a known mime type, set the eol-style based on the mime type. For such files, set svn:eol-style to "native" if the mime type begins with "text/", and leave it unset (i.e., no EOL translation) oth- erwise. Files with unknown mime types are not affected by this option. This option has no effect unless the --mime-types option is also specified. --auto-props=file Specify a file in the format of Subversion’s config file, whose [auto-props] section can be used to set arbitrary properties on files in the Subversion repository based on their filenames. (The [auto-props] section header must be present; other sections of the config file, including the enable-auto-props setting, are ignored.) Filenames are matched to the filename patterns case- insensitively. --default-eol=style Set svn:eol-style to style for files that don’t have the CVS ‘kb’ expansion mode and whose end-of-line translation mode hasn’t been determined by one of the other options. style must be ‘binary’ (default), ‘native’, ‘CRLF’, ‘LF’, or ‘CR’. --keywords-off By default, cvs2svn sets svn:keywords on CVS files to "author id date" if the mode of the RCS file in question is either kv, kvl or unset. If you use the --keywords-off switch, cvs2svn will not set svn:keywords for any file. While this will not touch the keywords in the contents of your files, Subversion will not expand them. EXTRACTION OPTIONS --use-internal-co Use internal code to extract revision contents. This is up to 50% faster than using --use-rcs, but needs a lot of disk space: Roughly the size of your CVS repository plus the peak size of a complete checkout of the repository with all branches that existed and still had commits pending at a given time. This option is the default. --use-rcs Use RCS ’co’ to extract revision contents. --use-cvs Use CVS to extract revision contents (only use this if having problems with --use-internal-co or --use-rcs, as those options are much faster). ENVIRONMENT OPTIONS --tmpdir=path Set the path to use for temporary data. Default is a directory called cvs2svn-tmp under the current directory. --svnadmin=path Path to the svnadmin program. (svnadmin is needed when the -s/--svnrepos output option is used.) --co=path Path to the co program. (co is needed if the --use-rcs option is used.) --cvs=path Path to the cvs program. (cvs is needed if the --use-cvs option is used.) --sort=path Path to the GNU sort program. (cvs2svn requires GNU sort.) PARTIAL CONVERSIONS -p, --pass pass Execute only pass pass of the conversion. pass can be specified by name or by number (see --help-passes). -p, --passes [start]:[end] Execute passes start through end of the conversion (inclusive). start and end can be specified by name or by number (see --help- passes). If start or end is missing, it defaults to the first or last pass, respectively. For this to work the earlier passes must have been completed before on the same CVS repository, and the generated data files must be in the temporary directory (see --tmpdir). INFORMATION OPTIONS --version Print the version number. -h, --help Print the usage message and exit with success. --help-passes Print the numbers and names of the conversion passes and exit with success. -v, --verbose Print more information while running. This option may be speci- fied twice to output voluminous debugging information. -q, --quiet Print less information while running. This option may be speci- fied twice to suppress all non-error output. --write-symbol-info=path Write symbol statistics and information about how symbols were converted to path during CollateSymbolsPass. --skip-cleanup Prevent the deletion of temporary files. --profile Profile with ’hotshot’ (into file cvs2svn.hotshot). FILES A directory called cvs2svn-tmp (or the directory specified by --tmpdir) is used as scratch space for temporary data files. AUTHORS Main authors are: C. Michael Pilato Greg Stein Branko Čibej Blair Zajac Max Bowsher Brian Fitzpatrick Tobias Ringström Karl Fogel Erik Hülsmann David Summers Michael Haggerty Ce manuel a été écrit pour la Debian GNU/Linux system by Laszlo ’GCS’ Boszormenyi (mais peut être utilisé par d'autres). TRADUCTION Alain Adelmar VOIR AUSSI cvs(1), svn(1), svnadmin(1) Subversion Oct 24, 2004 CVS2SVN(1)