Le format arch d'un changeset

Un changeset arch est un répertoire contenant un certain nombre de fichiers et répertoires. Ils sont décrit ci-dessous :

Fichiers :

orig-dirs-index
mod-dirs-index
orig-files-index
mod-files-index

Format :

<file path><tab><id>

Tri :

sort -k 2

Ils contiennent un index de tous les fichiers et répertoires ajoutés, déplacés, ou modifiés entre deux arborescences.

Fichiers :

original-only-dir-metadata
modified-only-dir-metadata

Format :

<metadata><tab><name>

Tri :

sort -t '<tab>' -k 2

Le champ <metadata><tab><name> contient la sortie du programme file-metadata avec l'option --permissions. Quelques exemples de sorties :

--permissions 777

Cette sortie peut également être utilisée pour les options et arguments du programme set-file-metadata. Les prochaines versions de arch ajouteront d'autres options (entre autres permissions).

Répertoires :

removed-files-archive
new-files-archive

Chacun de ces répertoires contient une copie complète de tous les fichiers présents seulement dans l'arborescence originale (removed-files-archive) ou dans l'arborescence modifiée (new-files-archive). Chaque fichier sauvegardé est archivé au même emplacement que dans l'arborescence source, avec les permissions (au moins) préservées.

Répertoire :

patches

Ce répertoire contient une arborescence dont la structure des répertoires est la même que la structure des répertoires de l'arborescence modifiée. Il contient les données de modification pour les répertoires et les fichiers communs aux deux arborescences.

Pour un fichier new-name stocké dans l'arborescence modifié, le répertoire patches devrait contenir :

• new_name.link-orig

  Le fichier original est un lien symbolique. new_name.link-orig est un fichier texte contenant la cible de ce lien terminé par un retour à la ligne.

  Ce fichier n'est présent que si la cible du lien a changé, ou si le lien a été remplacé par un fichier normal.

• new_name.link-mod

  Le fichier modifié est un lien symbolique et ce fichier est un fichier texte contenant la cible pour le lien terminé par un retour à la ligne.

  Ce fichier n'est présent que si le lien cible a changé, ou si le lien remplace un fichier normal.

• new_name.original

  C'est une copie complète du fichier de l'arborescence originale, dont les permissions sont (si possible) préservées.

  Ce fichier n'est présent que si le fichier a été remplacé par un lien symbolique, ou si le contenu du fichier ne peut pas être traité par diff(1).

• new_name.modified

  C'est une copie complète du fichier de l'arborescence modifiée, dont les permissions sont (si possible) préservées.

  Ce fichier n'est présent que si le fichier remplace un lien symbolique, ou si son contenu ne peut pas être traité par diff(1).

• new_name.patch

  C'est le résultat d'un diff entre le fichier orignal et le fichier modifié. Une version courante de diff (GNU diff) génère un résultat non-standard en oubliant une copie des lignes du résultat qui sont identiques entre le fichier original et le fichier modifié. Ainsi, les fichiers .patch peuvent avoir le même bogue. Heureusement, la version courante de patch (GNU patch) accepte de recevoir un tel résultat.

• new_name.meta-orig

• new_name.meta-mod

  Fichier de « metadata » (actuellement uniquement les permissions) modifiées entre deux versions du fichier. Ces fichiers contiennent la sortie du programme file-metadata avec les options --symlink --permissions, utilisable pour comparer deux sorties similaires, et pour être utilisé comme options et arguments à set-file-metadata.

• new_name/=dir-meta-orig

• new_name/=dir-meta-mod

  Répertoire « metadata » (actuellement seulement les permissions) des modifications entre deux versions des répertoires contenant ces fichiers. Ces fichiers contiennent la sortie du programme file-metadata avec les options --symlink --permissions, utilisable pour comparer deux sorties similaires, et être utilisé comme options et arguments à set-file-metadata.

Version du 31/05/2004 21h18 : wilk@flibuste.net--libre   docs-tla--fr--1.0     patch-99 ... base-0