git-mv - Déplace ou renomme un fichier, un répertoire, ou un lien symbolique

Déplace ou renomme un fichier, un répertoire ou un symlink.

Dans la première forme, cela renomme <source>, qui doit exister et être soit un fichier, un lien symbolique ou un répertoire, en <destination>. Dans la deuxième forme, le dernier argument doit être un répertoire existant ; les sources données seront déplacées dans ce répertoire.

L’index est mis à jour une fois l’opération terminée, mais la modification doit toujours être validée.

Déplacer un sous-module utilisant un fichier git (ce qui signifie qu’il a été cloné avec une version de Git 1.7.8 ou plus récente) mettra à jour le gitfile et le paramètre core.worktree pour que le sous-module fonctionne dans le nouvel emplacement. Il tentera également de mettre à jour le paramètre submodule.<nom>.path dans le fichier gitmodules[5] et d’indexer ce fichier (sauf si -n est utilisé).

Chaque fois qu’une mise à jour d’un superprojet déplace un sous-module peuplé (par exemple lors du basculement d’un commit à l’autre avant et après le déplacement), une extraction de sous-module périmée reste dans l’ancien emplacement et un répertoire vide apparaît dans le nouvel emplacement. Pour remplir à nouveau le sous-module dans le nouvel emplacement, l’utilisateur devra ensuite exécuter "git submodule update". Supprimer l’ancien répertoire n’est sûr que lorsqu’il utilise un fichier gitfile, sinon l’historique du sous-module sera également supprimé. Ces deux étapes seront obsolètes lorsque la mise à jour récursive de sous-module aura été implémentée.

Fait partie de la suite git[1]

Cette page de manuel a été traduite par Jean-Noël Avila <jn.avila AT free DOT fr> et les membres du projet git-manpages-l10n. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le site https://github.com/jnavila/git-manpages-l10n .