Wiggle - En ligne dans le Cloud

PROGRAMME:

Nom

wiggle - appliquez les correctifs rejetés et effectuez des différences au niveau des mots

SYNOPSIS

se tortiller [fonction] [choix] filet [des dossiers]

DESCRIPTION

La fonction principale de se tortiller consiste à appliquer un correctif à un fichier de la même manière que le
pièce(1) programme.

La différence distinctive de se tortiller est qu'il tentera d'appliquer un correctif même si le
La partie "avant" du correctif ne correspond pas parfaitement au fichier cible. Ceci est réalisé par
briser le fichier et le patch en mots et trouver le meilleur alignement de mots dans le fichier
avec des mots dans le patch. Une fois cet alignement trouvé, toutes les différences (au niveau des mots)
dans le patch sont appliqués au fichier le mieux possible.

Aussi, les se tortiller détectera (dans certains cas) les changements qui ont déjà été appliqués et
ignore les.

se tortiller garantit que chaque modification du correctif est appliquée au fichier cible d'une manière ou d'une autre. Si un
une modification particulière ne peut pas être apportée au fichier, le fichier est annoté pour montrer où le
le changement doit être effectué de la même manière que le fusionner(1) programme avec le -A option. Chaque
l'annotation contient 3 composants : une partie du fichier d'origine où la modification doit
être appliqué, une partie du patch qui n'a pas pu être mis en correspondance avec précision dans le fichier, et le
texte qui doit remplacer cette partie du patch. Ceux-ci sont séparés par des lignes
contenant précisément 7 caractères identiques, soit '<', '|', '=', ou '>', éventuellement
suivi d'un mot descriptif. Donc
<<<<<<< trouvé
Une partie du fichier d'origine
||||||| attendu
texte à remplacer
=======
texte pour le remplacer par
>>>>>>> remplacement
indique que "texte à remplacer" doit être remplacé par "texte à remplacer par" quelque part
dans la partie du fichier d'origine. toutefois se tortiller n'a pas pu trouver un endroit pour faire
Ce changement.

se tortiller peut également produire des rapports de conflit ne montrant que les mots qui sont impliqués plutôt
que de montrer des lignes entières. Dans ce cas, la sortie ressemble à :
<<<---original|||ancien===nouveau--->>>

Une utilisation possible de se tortiller est de courir pièce d'appliquer un correctif et de collecter une liste de
rejette en surveillant les messages d'erreur de patch. Ensuite pour chaque fichier pour lequel un
le rejet a été trouvé, exécutez
wiggle --replace originalfile originalfile.rej

Enfin, chaque dossier doit être examiné pour résoudre les conflits non résolus, et pour s'assurer
le patch appliqué est sémantiquement correct.

Alternativement, le fichier de correctif d'origine peut être envoyé au feuilleter mode comme
wiggle -B < fichier de correctif

Cela permettra d'inspecter les changements et les conflits et, dans une certaine mesure, de les modifier ;
et puis les résultats peuvent être enregistrés.

OPTIONS
Les options suivantes sont comprises par se tortiller. Certains d'entre eux sont expliqués plus
en détail dans les sections suivantes sur MERGE, DIFF, EXTRACT et BROWSE.

-m, --fusionner
Sélectionnez la fonction "fusionner". C'est la fonction par défaut.

-d, --diff
Sélectionnez la fonction "diff". Cela affiche les différences entre les fichiers. Ceci peut
être donné après --Feuilleter (voir ci-dessous) auquel cas un patch ou un diff de deux fichiers peut
être visualisé sans les originaux.

-x, --extrait
Sélectionnez la fonction "extraire". Cela extrait une branche d'un fichier de correctif ou de fusion.

-B, --Feuilleter
Sélectionnez la fonction "parcourir". Ceci est similaire à "fusionner" (ou "diff") uniquement avec un
présentation différente. Au lieu que le résultat soit simplement envoyé à la norme
sortie, il est présenté à l'aide d'une interface graphique basée sur ncurses afin que chaque morceau du correctif
peuvent être examinés pour comprendre quels conflits étaient impliqués et ce qui devait être
ignorés dans l'ordre de mise en place du patch.

-w, --mots
Demandez que toutes les opérations et l'affichage soient basés sur des mots. C'est la valeur par défaut pour le
fonction "diff".

-l, --lignes
Demandez que toutes les opérations et l'affichage soient basés sur des lignes.

-b, --ignorer les blancs
Diminuer les espaces blancs (espace, tabulation et saut de ligne) détermine les différences et
changements.

Normalement, l'espace blanc est traité comme un mot qui peut être mis en correspondance ou modifié par un
pièce. Lorsque ce drapeau est en vigueur, l'espace blanc sert uniquement de séparateur entre
d'autres termes et n'est pas égalé lui-même. L'effet de ceci est que les changements dans la
quantité d'espaces blancs ne sont pas traités comme significatifs.

Pour être précis, tout espace blanc est combiné avec le mot précédent ou, dans le cas
d'espace de début sur une ligne, avec le mot suivant. Cependant, il n'est pas impliqué dans
toute comparaison de ce mot. Si un patch supprime un mot, l'espace blanc joint
est également supprimé. Si un patch ajoute un mot, l'espace blanc attaché est ajouté comme
Hé bien.

Une ligne vide, ou qui ne contient que des blancs, sera traitée comme un seul mot
qui correspondra à n'importe quelle autre ligne vide, quel que soit le nombre d'espaces dont elle dispose.

-b n'a aucun effet sur --ligne mode.

-p, --pièce
Traiter le dernier fichier nommé comme un correctif au lieu d'un fichier (avec --diff) ou une fusion
(--extrait). Dans fusionner or feuilleter Mode, -p nécessite qu'il y ait exactement un fichier qui
est un correctif et qui peut contenir des correctifs pour plusieurs fichiers. Les patchs sont fusionnés
dans chaque fichier. Lorsqu'il est utilisé dans fusionner mode, cette utilisation nécessite le --remplacer option
car l'écriture de nombreux fichiers fusionnés sur la sortie standard n'est pas pratique.

Lors du traitement d'un patch multi-fichier, -p peut être suivi d'un argument numérique
indiquant combien de composants de nom de fichier doivent être supprimés des fichiers nommés dans le
fichier de correctif. Si aucun argument numérique n'est donné, se tortiller en déduira une
nombre basé sur les fichiers présents dans le système de fichiers.

-r, --remplacer
Normalement, la sortie fusionnée est écrite sur la sortie standard. Avec --remplacer,
le fichier d'origine est remplacé par la sortie de fusion. Dans feuilleter mode, cela indique
se tortiller pour toujours enregistrer la fusion résultante lorsque vous quittez.

-o, --sortie=
Plutôt que d'écrire le résultat sur stdout ou de remplacer le fichier d'origine, cette
demande que la sortie soit écrite dans le fichier donné. Ceci n'a de sens que
avec --fusionner or --Feuilleter lorsqu'on lui donne une seule fusion à parcourir.

Cette option remplace -r.

-R, --sens inverse
Lorsqu'il est utilisé avec diff fonction, échangez les fichiers avant de calculer le
différences. Lorsqu'il est utilisé avec le fusionner or feuilleter fonctions, se tortiller essayer de
annuler les modifications plutôt que de les appliquer.

-i, --non-ignorer
Normalement, wiggle ignorera les changements dans le patch qui semblent déjà avoir été
appliqué dans l'original. Avec ce drapeau, ces changements sont signalés comme des conflits
plutôt que d'être ignoré.

-W, --show-wiggles
Lorsqu'il est utilisé avec --fusionner, les conflits qui peuvent être mis en place sont signalés comme
entre en conflit avec une strophe supplémentaire qui montre quel serait le résultat si ce drapeau
n'avait pas été utilisé. La strophe supplémentaire est introduite par un vers contenant 7
esperluette (&) caractères ainsi :
<<<<<<< trouvé
Une partie du fichier d'origine
||||||| attendu
texte à remplacer
=======
texte pour le remplacer par
&&&&&&& résolution
Texte qui résulterait d'un wiggle réussi
>>>>>>> remplacement

--rapport-wiggles
Si une fusion réussit à appliquer toutes les modifications, elle se terminera normalement avec un
statut de réussite (0), signalant uniquement l'échec (1) si un conflit s'est produit et a été
annoté. Avec --rapport-wiggles se tortiller signalera également l'échec si des changements
a dû être agité. Cela peut être utile lorsque se tortiller est utilisé pour les fusions automatiques
comme avec jet. Si des tremblements se produisent, jet signalera l'échec et les résultats
peuvent être examinés pour confirmer qu'ils sont acceptables.

-h, --Aidez-moi
Imprimez un message d'aide simple. Si donné après l'un des sélecteurs de fonction
(--fusionner, --diff, --extrait, --Feuilleter) l'aide spécifique à cette fonction s'affiche.

-V, --version
Afficher le numéro de version de se tortiller.

-v, --verbeux
Activer le mode détaillé. Actuellement, cela ne fait aucune différence.

-q, --silencieux
Activer le mode silencieux. Cela supprime le message de la fonction de fusion lorsqu'il y a
sont des conflits insolubles.

MOTS
se tortiller peut diviser un texte en lignes ou en mots lors de l'exécution de ses tâches. Une ligne est simplement
une chaîne de caractères terminée par un saut de ligne. Un mot est soit un contigu maximal
chaîne de caractères alphanumériques (y compris le trait de soulignement), une chaîne contiguë maximale d'espace ou
tabulations ou tout autre caractère unique.

FUSIONNER
La fonction de fusion modifie un texte donné en trouvant tous les changements entre deux autres textes
et imposer ces changements sur le texte donné.

Normalement se tortiller se concentre sur les mots qui ont changé afin de maximiser la possibilité de
trouver une bonne correspondance dans le texte donné pour le contexte d'un changement donné. Cependant il peut
considérer uniquement des lignes entières à la place.

se tortiller extrait les trois textes dont il a besoin des fichiers répertoriés sur la ligne de commande.
1, 2 ou 3 fichiers peuvent être répertoriés, et chacun d'entre eux peut être un trait d'union solitaire signifiant
entrée standard.

Si un fichier est fourni et que le -p n'est pas présente, le fichier est traité comme un fusionner
fichier, c'est-à-dire la sortie de "merge -A" ou "wiggle". Un tel fichier contient implicitement trois
flux et ceux-ci sont extraits et comparés.

Si deux fichiers sont fournis, le premier contient simplement le texte principal et le second est
traité comme un fichier de correctif (la sortie de "diff -u" ou "diff -c", ou un fichier ".rej" de
pièce) et les deux autres textes en sont extraits.

Si un fichier est fourni avec le -p option, le fichier est traité comme un fichier de correctif
contenant les noms des fichiers qu'il corrige. Dans ce cas, plusieurs opérations de fusion
peut arriver et chacun prend un flux d'un fichier nommé dans le correctif, et les deux autres
du patch lui-même. Les --remplacer l'option est requise et les résultats sont réécrits
aux fichiers cibles.

Enfin si trois fichiers sont répertoriés, ils sont considérés comme contenant le texte donné et les deux
autres textes, dans l'ordre.

Normalement, le résultat de la fusion est écrit sur la sortie standard. Si la -r le drapeau est donné,
la sortie est écrite dans un fichier qui remplace le fichier original donné. Dans ce cas le
le fichier d'origine est renommé pour avoir un .porig suffixe (pour "original patché" qui a du sens
si vous utilisez d'abord pièce pour appliquer un patch, puis utilisez se tortiller pour faire rentrer les rebuts).

De plus si le -o est donnée avec un nom de fichier, la sortie sera écrite dans celle-ci
déposer. Dans ce cas, aucune sauvegarde n'est créée.

Si aucune erreur ne se produit (comme des erreurs d'accès aux fichiers) se tortiller sortira avec un statut de 0 si tous
les modifications ont été fusionnées avec succès, et avec un état de sortie de 1 et un bref message le cas échéant
les modifications n'ont pas pu être entièrement fusionnées et ont été insérées à la place sous forme d'annotations. Toutefois, si
non plus --rapport-wiggles or --show-wiggles des options ont été données, se tortiller existera aussi avec
statut de 1 si des changements devaient être apportés même si cela a réussi.

La fonction de fusion peut fonctionner selon trois modes différents en ce qui concerne les lignes ou les mots.

Avec la --lignes option, des lignes entières sont comparées et tout conflit est signalé comme entier
lignes qui doivent être remplacées.

Avec la --mots option, les mots individuels sont comparés et tous les conflits sont signalés juste
couvrant les mots concernés. Cela utilise le format de conflit <<<|||===>>>.

Sans l'une ou l'autre de ces options, une approche hybride est adoptée. Les mots individuels sont
comparés et fusionnés, mais lorsqu'un conflit est détecté, toute la ligne environnante est signalée
comme étant en conflit.

se tortiller veillera à ce que tout changement entre les deux autres textes soit reflété dans le
résultat de la fusion en quelque sorte. Il existe quatre manières différentes de procéder à un changement
réfléchi.

1 Si un changement convertit A à B et A se trouve à un endroit approprié dans l'original
fichier, il est remplacé par B. Cela inclut la possibilité que B est vide, mais
pas ça A est vide.

2 Si un changement est trouvé qui ajoute simplement B et le texte qui précède immédiatement et
suivant l'insertion se trouvent à côté du fichier original dans un
lieu, alors B est inséré entre ces textes adjacents.

3 Si un changement est trouvé qui change A à B et cela semble (basé sur le contexte) à
aligner avec B dans l'original, on suppose alors que ce changement a déjà été
appliqué et la modification est ignorée. Lorsque cela se produit, un message reflétant le
le nombre de modifications ignorées est imprimé par se tortiller. Cette optimisation peut être
supprimé avec le -i drapeau.

4 Si un changement est trouvé qui ne correspond à aucune des possibilités ci-dessus, alors un
le conflit est signalé comme décrit précédemment.

DIFFÉRENT
La fonction diff est fournie principalement pour permettre l'inspection des alignements qui se tortiller
calculé entre les textes et qu'il utilise pour effectuer une fusion.

La sortie de la fonction diff est similaire à la sortie unifiée de diff. Cependant tandis que
diff ne produit pas de longues portions de texte commun, se tortillerLe mode diff de s affiche tout.

Lors du calcul d'un alignement basé sur des mots (valeur par défaut), se tortiller peut-être besoin de montrer ces mots-
différences fondées. Ceci est fait en utilisant une extension au format unified-diff. Si une ligne
commence par une barre verticale, puis il peut contenir des sections entourées de multi-
crochets de caractères. Les crochets "<<<++" et "++>>>" entourent le texte ajouté tandis que "<<<--"
et "-->>>" entourent le texte supprimé.

se tortiller peut être donné les deux textes à comparer de l'une des trois manières.

Si un seul fichier est fourni, alors il est traité comme un patch et les deux branches de ce
patch sont comparés. Cela permet effectivement d'affiner un patch à partir d'un patch basé sur des lignes
à un patch basé sur des mots.

Si deux fichiers sont fournis, ils sont normalement supposés être de simples textes à comparer.

Si deux fichiers sont fournis avec l'option --patch, alors le deuxième fichier est supposé être
être un patch et la première (avec -1) ou la seconde (avec -2) branche est extraite et
par rapport au texte trouvé dans le premier fichier.

Cette dernière option provoque se tortiller appliquer un algorithme « best-fit » pour aligner les morceaux de patch
avec le fichier avant de calculer les différences. Cet algorithme est utilisé lors de la fusion d'un
patch avec un fichier, et sa valeur peut être vue en comparant la différence produite de cette façon
avec la différence produite en extrayant d'abord une branche d'un correctif dans un fichier, et
puis calculer la différence de ce fichier avec le fichier principal.

EXTRAIT
La fonction d'extraction de se tortiller expose simplement la fonctionnalité interne pour l'extraction
une branche d'un correctif ou d'un fichier de fusion.

Précisément un fichier doit être donné, et il sera supposé être un fichier de fusion à moins que
--pièce est donné, auquel cas un patch est supposé.

Le choix de l'agence s'effectue en fournissant l'un des -1, -2ou -3 avec des significations évidentes.

FEUILLETEZ
La fonction de navigation de se tortiller présente le résultat d'une fusion ou (avec -d) une différence dans un
interface graphique basée sur du texte qui peut être parcourue à l'aide de frappes similaires à vi(1) ou emacs (1).

Le navigateur permet de visualiser individuellement chacun des deux ou trois flux avec
couleurs utilisées pour mettre en évidence différentes sortes de texte - vert pour le texte ajouté, rouge pour le texte supprimé
texte, etc. Il peut également afficher le patch seul, le résultat complet de la fusion ou le
fusionner et le patch côte à côte.

Le navigateur propose un certain nombre de pages d'aide contextuelles accessibles en
en tapant '?'

Le coin supérieur droit de l'interface graphique indiquera le type de texte sous le curseur, qui est également
indiqué par la couleur du texte. Les options sont inchangées, modifiées, sans correspondance,
étranger, déjà appliqué et conflit. Si les significations de ceux-ci sont un peu claires
les expérimentations devraient aider.

Un nombre limité de modifications est autorisé pendant feuilleter mode. Texte actuellement
indésirables peuvent être jetés avec x. Cela convertira un conflit ou un changement en Inchangé,
et un Unmatched to Changed (ce qui le transforme effectivement en chaîne vide). de la même manière
un texte peut être marqué comme souhaité avec c. Cela convertira un conflit ou un étranger en
Modifié. L'utilisation à nouveau de la même clé annulera la modification.

Enfin, la majuscule X annulera toutes les modifications sur la ligne actuelle.

Pour apporter des modifications plus radicales, vous pouvez utiliser v qui exécute un éditeur, préférant $VISUEL or
$ EDITEUR s'ils sont placés dans l'environnement.

Si vous apportez des modifications, Wiggle vous demandera si vous souhaitez enregistrer les modifications, même si
--remplacer n'a pas été donné.

ATTENTION

Il faut toujours faire preuve de prudence lors de l'application d'un patch rejeté avec se tortiller. Quand pièce
rejette un patch, il le fait pour une bonne raison. Bien que se tortiller peut être en mesure de trouver un
endroit crédible pour appliquer chaque changement textuel, il n'y a aucune garantie que le résultat est
correct dans n'importe quel sens sémantique. Le résultat doit toujours être inspecté pour s'assurer qu'il est
corriger.

EXEMPLES

se tortiller --remplacer filet fichier.rej
C'est l'usage normal de se tortiller et prendra toutes les modifications fichier.rej qui pièce pourriez
ne s'appliquent pas et fusionnez-les dans filet.

se tortiller -dp1 filet fichier.rej
Cela effectuera une comparaison au niveau des mots entre les filet et par before branche de la
diff dans fichier.rej et afficher les différences. Cela vous permet de voir où un patch donné
s'appliquerait.

se tortiller --fusionner --Aidez-moi
Obtenir de l'aide sur la fonction de fusion de se tortiller.

se tortiller --Feuilleter --pièce mise à jour.patch
Analyser le mise à jour.patch fichier pour les correctifs et présenter une liste de fichiers corrigés qui peuvent être
parcouru pour examiner chaque patch en détail.

se tortiller peut être intégré avec jet afin qu'il soit utilisé comme outil de fusion par défaut et diff
outil. Ceci peut être réalisé en ajoutant les lignes suivantes à .gitconfig au domicile de l'utilisateur
répertoire.
[fusionner « agiter »]
name = "Fusion flexible de Wiggle"
pilote = wiggle -o %A %A %O %B
récursif = binaire
[fusionner]
outil = remuer
[mergetool "agiter"]
cmd = wiggle -B -o $MERGED $LOCAL $BASE $REMOTE
[difftool "agiter"]
cmd = agiter -Bd $LOCAL $REMOTE
Cela fera jet outil de fusion et jet outil de diff utilisé se tortiller.

Si vous voulez jet à toujours utiliser se tortiller pour les fusions (qui peuvent être dangereuses), vous pouvez ajouter
* fusionner=agiter
à un approprié attributs git fichier tel que $HOME/.config/git/attributs.

DEVIS

Le nom de se tortiller a été inspiré par la citation suivante.

Le problème que je trouve, c'est que j'ai souvent envie de prendre
(fichier1+patch) -> fichier2,
quand je n'ai pas file1. Mais les outils de fusion veulent prendre
(fichier1|fichier2) -> fichier3.
Je n'ai pas vu d'outil graphique qui vous aide à agiter un patch
dans un fichier.
--Andrew Morton - 2002

INSUFFISANCES

- se tortiller ne peut pas lire la sortie unified-diff étendue qu'il produit pour --diff
--mots.

- se tortiller ne peut pas lire le format de fusion basé sur des mots qu'il produit pour --merge
--mots.

- se tortiller ne comprend pas l'unicode et traitera donc beaucoup tous les caractères non ASCII
de la même manière qu'il traite la ponctuation - il traitera chacun comme un mot séparé. Les
navigateur n'affichera pas correctement les caractères non ASCII.

Utilisez wiggle en ligne en utilisant les services onworks.net