wiebelen - Online in de cloud

PROGRAMMA:

NAAM

wiggle - pas afgewezen patches toe en voer woordgewijze diffs uit

KORTE INHOUD

wiebelen [functie] [Opties] filet [Files]

PRODUCTBESCHRIJVING

De hoofdfunctie van wiebelen is om een ​​patch op een bestand toe te passen op een vergelijkbare manier als het
stuk(1) programma.

Het kenmerkende verschil van wiebelen is dat het zal proberen een patch toe te passen, zelfs als de
"voor" deel van de patch komt niet perfect overeen met het doelbestand. Dit wordt bereikt door
het bestand en de patch in woorden breken en de beste uitlijning van woorden in het bestand vinden
met woorden in de patch. Zodra deze uitlijning is gevonden, worden eventuele verschillen (woordsgewijs)
in de patch zo goed mogelijk op het bestand worden toegepast.

Dus, wiebelen zal (in sommige gevallen) wijzigingen detecteren die al zijn toegepast, en zal
negeer hun.

wiebelen zorgt ervoor dat elke wijziging in de patch op de een of andere manier wordt toegepast op het doelbestand. Als een
bepaalde wijziging niet kan worden aangebracht in het bestand, wordt het bestand geannoteerd om aan te geven waar het
wijziging moet worden aangebracht op dezelfde manier als de samensmelten(1) programma met de -A keuze. Elk
annotatie bevat 3 componenten: een gedeelte van het originele bestand waar de wijziging zou moeten
worden toegepast, een deel van de patch dat niet exact kon worden gevonden in het bestand, en de
tekst die dat gedeelte van de patch moet vervangen. Deze worden gescheiden door lijnen
met precies 7 identieke tekens, mogelijk '<', '|', '=' of '>'
gevolgd door een beschrijvend woord. Dus
<<<<<<< gevonden
Een deel van het originele bestand
||||||| verwacht
tekst te vervangen
=======
tekst om het te vervangen
>>>>>>> vervanging
geeft aan dat "tekst om te vervangen" ergens moet worden vervangen door "tekst om het door te vervangen".
in het gedeelte van het originele bestand. Echter wiebelen kon geen plek vinden om te maken
deze verandering.

wiebelen kan ook conflictrapporten produceren met alleen de woorden die erbij betrokken zijn
dan hele lijnen tonen. In dit geval ziet de uitvoer er als volgt uit:
<<<---origineel|||oud===nieuw--->>>

Een mogelijk gebruik van wiebelen is om te rennen stuk om een ​​patch toe te passen, en om een ​​lijst van te verzamelen
verwerpt door de foutmeldingen van patch te controleren. Vervolgens voor elk bestand waarvoor een
weigering is gevonden, rennen
wiggle --vervang origineelbestand origineelbestand.rej

Ten slotte moet elk bestand worden onderzocht om eventuele onopgeloste conflicten op te lossen en zeker te zijn
de toegepaste patch is semantisch correct.

Als alternatief kan het originele patchbestand worden ingevoerd in het doorbladeren modus als
wiggle -B < patchbestand

Hierdoor kunnen de wijzigingen en conflicten worden geïnspecteerd en tot op zekere hoogte worden aangepast;
en dan kunnen de resultaten worden opgeslagen.

OPTIES
Onder de volgende opties wordt verstaan wiebelen. Sommige hiervan worden in meer uitgelegd
details in de volgende secties over MERGE, DIFF, EXTRACT en BROWSE.

-m, --samenvoegen
Selecteer de functie "samenvoegen". Dit is de standaardfunctie.

-d, --verschil
Selecteer de functie "diff". Dit toont de verschillen tussen bestanden. Dit kan
na gegeven worden --bladeren (zie hieronder) in welk geval een patch of diff van twee bestanden kan
worden bekeken zonder de originelen.

-x, --extract
Selecteer de functie "uitpakken". Dit extraheert één tak van een patch of een samenvoegbestand.

-B, --bladeren
Selecteer de functie "bladeren". Dit is vergelijkbaar met "merge" (of "diff"), alleen met a
andere presentatie. In plaats van dat het resultaat simpelweg naar standaard wordt gestuurd
output, wordt het gepresenteerd met behulp van een op ncurses gebaseerde grafische gebruikersinterface, zodat elk stuk van de patch
kan worden onderzocht om te begrijpen welke conflicten er waren en wat er moest gebeuren
genegeerd in de volgorde waarin de patch op zijn plaats moet worden gewiegd.

-w, --woorden
Verzoek dat alle bewerkingen en weergave op woorden zijn gebaseerd. Dit is de standaardinstelling voor de
"diff"-functie.

-l, --lijnen
Verzoek dat alle bewerkingen en weergave lijngebaseerd zijn.

-b, --negeer-blanks
Het minder benadrukken van witruimte (spatie, tab en nieuwe regel) is bepalend voor verschillen en
veranderingen.

Normaal gesproken wordt witruimte behandeld als een woord dat kan worden aangepast of gewijzigd door een
lapje. Wanneer deze vlag van kracht is, dient witruimte alleen als scheidingsteken ertussen
andere woorden en is zelf niet gematcht. Het effect hiervan is dat veranderingen in de
hoeveelheid witruimte worden niet als significant beschouwd.

Om precies te zijn wordt elke witruimte gecombineerd met het voorgaande woord of, in het geval
van voorloopspatie op een regel, met het volgende woord. Het is er echter niet bij betrokken
alle vergelijkingen van dat woord. Als een patch een woord verwijdert, de bijgevoegde witruimte
wordt ook verwijderd. Als een patch een woord toevoegt, wordt de bijgevoegde witruimte toegevoegd als
goed.

Een lege regel, of een regel die alleen spaties bevat, wordt behandeld als een enkel woord
die overeenkomt met elke andere lege regel, ongeacht hoeveel spaties deze heeft.

-b heeft geen invloed op --lijn modus.

-p, --lapje
Behandel het laatstgenoemde bestand als een patch in plaats van een bestand (met --diff) of een samenvoeging
(--extract). In samensmelten or doorbladeren mode, -p vereist dat er precies één bestand is dat
is een patch en kan patches voor meerdere bestanden bevatten. De patches zijn samengevoegd
in elk bestand. Bij gebruik binnen samensmelten modus vereist dit gebruik de --vervangen optie
omdat het schrijven van veel samengevoegde bestanden naar standard-out onpraktisch is.

Bij het verwerken van een patch met meerdere bestanden, -p kan worden gevolgd door een numeriek argument
geeft aan hoeveel bestandsnaamcomponenten moeten worden verwijderd uit bestanden met de naam in de
patch-bestand. Als er geen numeriek argument wordt gegeven, wiebelen zal een passend afleiden
aantal op basis van welke bestanden aanwezig zijn in het bestandssysteem.

-r, --vervangen
Normaal gesproken wordt de samengevoegde uitvoer naar standaarduitvoer geschreven. Met --vervangen
originele bestand wordt vervangen door de samenvoeguitvoer. In doorbladeren modus, dit instrueert
wiebelen om de resulterende samenvoeging altijd op te slaan bij het afsluiten.

-o, --uitvoer=
In plaats van het resultaat naar stdout te schrijven of het originele bestand te vervangen, is dit
verzoekt dat de uitvoer naar het opgegeven bestand wordt geschreven. Dit is alleen maar zinvol
Met --samenvoegen or --bladeren wanneer een enkele samenvoeging wordt gegeven om te bladeren.

Deze optie overschrijft -r.

-R, --omgekeerde
Bij gebruik met de diff functie, verwissel de bestanden voordat u de
verschillen. Bij gebruik met de samensmelten or doorbladeren functies wiebelen probeert om
wijzigingen terugdraaien in plaats van ze toe te passen.

-i, --geen-negeren
Normaal gesproken negeert wiggle veranderingen in de patch die al lijken te zijn aangebracht
toegepast in het origineel. Met deze vlag worden die wijzigingen gerapporteerd als conflicten
in plaats van genegeerd te worden.

-W, --show-wiebelt
Bij gebruik bij --samenvoegen, worden conflicten die op hun plaats kunnen worden gewiegd, gerapporteerd als
conflicteert met een extra strofe die laat zien wat het resultaat zou zijn als deze vlag
niet was gebruikt. De extra strofe wordt ingeleid met een regel met 7
ampersand (&) tekens dus:
<<<<<<< gevonden
Een deel van het originele bestand
||||||| verwacht
tekst te vervangen
=======
tekst om het te vervangen
&&&&&&& oplossing
Tekst die het resultaat zou zijn van een succesvolle wiggle
>>>>>>> vervanging

--rapport-wiebelt
Als een samenvoeging erin slaagt alle wijzigingen toe te passen, wordt deze normaal gesproken afgesloten met een
successtatus (0), rapporteert alleen mislukking (1) als er een conflict is opgetreden en was
geannoteerd. Met --rapport-wiebelt wiebelen zal ook fouten melden als er wijzigingen zijn
moest worden ingeslingerd. Dit kan handig zijn wanneer wiebelen wordt gebruikt voor automatische samenvoegingen
zoals bij git. Als er kronkels optreden, git zal de storing en de resultaten rapporteren
kunnen worden onderzocht om te bevestigen dat ze acceptabel zijn.

-h, --help
Druk een eenvoudig hulpbericht af. Indien gegeven na een van de functiekiezers
(--samenvoegen, --verschil, --extract, --bladeren) help die specifiek is voor die functie wordt weergegeven.

-V, --versie
Geef het versienummer weer van wiebelen.

-v, --uitgebreid
Schakel de uitgebreide modus in. Momenteel maakt dit geen verschil.

-q, --stil
Schakel de stille modus in. Dit onderdrukt het bericht van de samenvoegfunctie als die er is
zijn onoplosbare conflicten.

WOORDEN
wiebelen kan een tekst opdelen in regels of woorden bij het uitvoeren van zijn taken. Een lijn is gewoon
een reeks tekens die wordt afgesloten door een nieuwe regel. Een woord is ofwel maximaal aangrenzend
reeks alfanumerieke tekens (inclusief onderstrepingsteken), een maximale aaneengesloten reeks spaties of
tab-tekens of een ander afzonderlijk teken.

MERGE
De samenvoegfunctie wijzigt een gegeven tekst door alle wijzigingen tussen twee andere teksten te vinden
en het opleggen van die wijzigingen aan de gegeven tekst.

Normaal wiebelen richt zich op welke woorden zijn veranderd om de mogelijkheid van te maximaliseren
het vinden van een goede match in de gegeven tekst voor de context van een bepaalde wijziging. Het kan echter
overweeg in plaats daarvan alleen hele regels.

wiebelen extraheert de drie teksten die het nodig heeft uit bestanden die op de opdrachtregel worden vermeld.
Er kunnen 1, 2 of 3 bestanden worden vermeld, en elk daarvan kan een eenzaam koppelteken zijn dat aangeeft
standaard invoer.

Als er één bestand wordt gegeven en de -p optie niet aanwezig is, wordt het bestand behandeld als een samensmelten
bestand, dwz de uitvoer van "merge -A" of "wiggle". Zo'n bestand bevat impliciet drie
streams en deze worden geëxtraheerd en vergeleken.

Als er twee bestanden worden gegeven, bevat de eerste eenvoudig de primaire tekst en de tweede
behandeld als een patchbestand (de uitvoer van "diff -u" of "diff -c", of een ".rej"-bestand van
stuk) en de twee andere teksten zijn daaruit gehaald.

Als één bestand samen met de -p optie, wordt het bestand behandeld als een patchbestand
met de namen van de bestanden die worden gepatcht. In dit geval meerdere samenvoegbewerkingen
kan gebeuren en elk neemt één stream van een bestand met de naam in de patch, en de andere twee
van de patch zelf. De --vervangen optie is vereist en de resultaten worden teruggeschreven
naar de doelbestanden.

Als er ten slotte drie bestanden worden vermeld, wordt ervan uitgegaan dat ze de gegeven tekst en de twee bevatten
andere teksten, in volgorde.

Normaal gesproken wordt het resultaat van de samenvoeging naar standaarduitvoer geschreven. Als de -r vlag wordt gegeven,
de uitvoer wordt weggeschreven naar een bestand dat het origineel gegeven bestand vervangt. In dit geval de
origineel bestand wordt hernoemd naar een .porig achtervoegsel (voor "gepatcht origineel", wat logisch is
als je voor het eerst gebruikt stuk om een ​​pleister toe te passen en vervolgens te gebruiken wiebelen om de afwijzingen naar binnen te wiebelen).

Verder als de -o optie wordt gegeven met een bestandsnaam, de uitvoer zal daarnaar worden geschreven
bestand. In dit geval wordt er geen back-up gemaakt.

Als er geen fouten optreden (zoals fouten bij bestandstoegang) wiebelen zal afsluiten met een status van 0 als alles
wijzigingen zijn met succes samengevoegd, en met een afsluitstatus van 1 en een kort bericht indien van toepassing
wijzigingen konden niet volledig worden samengevoegd en werden in plaats daarvan als annotaties ingevoegd. Echter, als
beide --rapport-wiebelt or --show-wiebelt opties werden gegeven, wiebelen zal er ook mee bestaan
status van 1 als er wijzigingen moesten worden doorgevoerd, ook al was dit succesvol.

De samenvoegfunctie kan in drie verschillende modi werken met betrekking tot regels of woorden.

Met de --lijnen optie worden hele regels vergeleken en eventuele conflicten worden als geheel gerapporteerd
lijnen die vervangen moeten worden.

Met de --woorden optie, individuele woorden worden vergeleken en eventuele conflicten worden gewoon gerapporteerd
die de getroffen woorden bedekken. Hierbij wordt het <<<|||===>>> conflictformaat gebruikt.

Zonder een van deze opties wordt gekozen voor een hybride aanpak. Individuele woorden zijn
vergeleken en samengevoegd, maar wanneer een conflict wordt gevonden, wordt de hele omringende lijn gerapporteerd
als in conflict zijn.

wiebelen zal ervoor zorgen dat elke wijziging tussen de twee andere teksten wordt weerspiegeld in de
resultaat van de fusie op de een of andere manier. Er zijn vier verschillende manieren waarop een verandering kan plaatsvinden
weerspiegeld.

1 Als een wijziging converteert A naar B en A is gevonden op een geschikte plaats in het origineel
bestand, wordt het vervangen door B. Dit omvat de mogelijkheid dat B is leeg, maar
niet dat A is leeg.

2 Als er een wijziging wordt gevonden die gewoon toevoegt B en de tekst direct voorafgaand aan en
na de invoeging bevinden zich naast in het originele bestand in een geschikte
plek dan B wordt ingevoegd tussen die aangrenzende teksten.

3 Als er een wijziging wordt gevonden die verandert A naar B en dit lijkt (op basis van de context) te zijn
af te stemmen op B in het origineel, dan wordt aangenomen dat deze wijziging al is aangebracht
toegepast en de wijziging wordt genegeerd. Wanneer dit gebeurt, verschijnt er een bericht dat de
aantal genegeerde wijzigingen wordt afgedrukt door wiebelen. Deze optimalisatie kan zijn
onderdrukt met de -i vlag.

4 Als er een wijziging wordt gevonden die niet past in een van de bovenstaande mogelijkheden, dan a
conflict wordt gerapporteerd zoals eerder beschreven.

VERSCHIL
De diff-functie is voornamelijk bedoeld om inspectie van de uitlijningen mogelijk te maken wiebelen
berekend tussen teksten en die het gebruikt voor het uitvoeren van een samenvoeging.

De uitvoer van de diff-functie is vergelijkbaar met de uniforme uitvoer van diff. Echter terwijl
diff voert geen lange stukken gewone tekst uit, wiebelenDe diff-modus voert alles uit.

Bij het berekenen van een op woorden gebaseerde uitlijning (standaard), wiebelen kan nodig zijn om deze woord-
gebaseerde verschillen. Dit wordt gedaan met behulp van een uitbreiding op het unified-diff-formaat. Als een lijn
begint met een verticale balk, dan kan het secties bevatten omgeven door speciale multi-
karakter haakjes. De haakjes "<<<++" en "++>>>" omgeven toegevoegde tekst terwijl "<<<--"
en "-->>>" surround verwijderde tekst.

wiebelen kan de twee teksten worden gegeven om op drie manieren te vergelijken.

Als er slechts één bestand wordt opgegeven, wordt het behandeld als een patch en de twee takken daarvan
patch worden vergeleken. Hierdoor kan een patch effectief worden verfijnd vanuit een lijngebaseerde patch
naar een op woorden gebaseerde patch.

Als er twee bestanden worden gegeven, wordt er normaal gesproken van uitgegaan dat het eenvoudige teksten zijn die moeten worden vergeleken.

Als twee bestanden samen met de optie --patch worden gegeven, wordt aangenomen dat het tweede bestand dat is
een patch zijn en of de eerste (met -1) of de tweede (met -2) tak wordt geëxtraheerd en
vergeleken met tekst gevonden in het eerste bestand.

Deze laatste optie veroorzaakt wiebelen om een ​​"best-fit" algoritme toe te passen voor het uitlijnen van patch-hunks
met het bestand voordat u de verschillen berekent. Dit algoritme wordt gebruikt bij het samenvoegen van a
patch met een bestand, en de waarde ervan kan worden gezien door het op deze manier geproduceerde verschil te vergelijken
met het verschil dat wordt geproduceerd door eerst een tak van een patch in een bestand te extraheren, en
vervolgens het verschil berekenen van dat bestand met het hoofdbestand.

EXTRACT
De extractiefunctie van wiebelen legt eenvoudigweg de interne functionaliteit voor het extraheren bloot
een tak van een patch of een samenvoegbestand.

Er moet precies één bestand worden opgegeven en er wordt aangenomen dat het een samenvoegbestand is, tenzij
--lapje wordt gegeven, in welk geval een patch wordt aangenomen.

De keuze van het filiaal wordt gemaakt door er een aan te bieden -1, -2of -3 met duidelijke betekenissen.

BROWSE
De bladerfunctie van wiebelen presenteert het resultaat van een samenvoeging of (met -d) een verschil in een
op tekst gebaseerde GUI waarin kan worden genavigeerd met toetsaanslagen vergelijkbaar met vi(1) of emacs(1).

Met de browser kan elk van de twee of drie streams afzonderlijk worden bekeken
kleuren die worden gebruikt om verschillende soorten tekst te markeren - groen voor toegevoegde tekst, rood voor verwijderde tekst
tekst enz. Het kan ook de patch op zichzelf tonen, het volledige resultaat van de samenvoeging of het
merge en de patch naast elkaar.

De browser biedt een aantal contextgevoelige helppagina's die toegankelijk zijn via
typen '?'

Rechtsboven in de GUI wordt het type tekst onder de cursor weergegeven, wat ook het geval is
aangegeven door de kleur van de tekst. Opties zijn Ongewijzigd, Gewijzigd, Ongeëvenaard,
Vreemd, Reeds toegepast en Conflict. Als de betekenissen hiervan een beetje duidelijk zijn
experimenten zouden moeten helpen.

Een beperkte hoeveelheid bewerking is toegestaan ​​terwijl je binnen bent doorbladeren modus. Momenteel tekst dat is
ongewenste kan worden weggegooid met x. Dit zal een Conflict of Wijziging omzetten in Ongewijzigd,
en een Unmatched naar Changed (die het effectief verandert in de lege string). Evenzo
een tekst kan naar wens worden gemarkeerd met c. Dit converteert een conflict of vreemd naar
gewijzigd. Als u dezelfde toets nogmaals gebruikt, wordt de wijziging ongedaan gemaakt.

Tot slot de hoofdletter X zal alle wijzigingen op de huidige regel ongedaan maken.

Om meer ingrijpende wijzigingen aan te brengen die u kunt gebruiken v die een editor uitvoert, bij voorkeur $VISUEEL or
$ EDITOR als ze zich in de omgeving bevinden.

Als u wijzigingen aanbrengt, zal Wiggle u vragen of u de wijzigingen wilt opslaan, zelfs als
--vervangen werd niet gegeven.

WAARSCHUWING

Voorzichtigheid is altijd geboden bij het aanbrengen van een afgekeurde pleister wiebelen. Wanneer stuk
een patch afwijst, doet het dat met een goede reden. Zelfs wiebelen misschien een vinden
geloofwaardige plaats om elke tekstuele wijziging toe te passen, is er geen garantie dat het resultaat is
correct in semantische zin. Het resultaat moet altijd worden geïnspecteerd om er zeker van te zijn dat dit het geval is
corrigeren.

Voorbeelden

wiebelen --vervangen filet bestand.rej
Dit is het normale gebruik van wiebelen en zal eventuele wijzigingen doorvoeren bestand.rej dat stuk kon
niet toepassen en voeg ze samen in filet.

wiebelen -dp1 filet bestand.rej
Dit zal een woordsgewijze vergelijking uitvoeren tussen de filet en vaardigheden tak van de
verschil in bestand.rej en laat de verschillen zien. Hiermee kunt u zien waar een bepaalde patch zich bevindt
zou van toepassing zijn.

wiebelen --samenvoegen --help
Krijg hulp over de samenvoegfunctie van wiebelen.

wiebelen --bladeren --lapje update.patch
Ontleden de update.patch bestand voor patches en presenteer een lijst met gepatchte bestanden die kunnen worden
gebladerd om elke patch in detail te onderzoeken.

wiebelen kan worden geïntegreerd met git zodat het wordt gebruikt als het standaard samenvoeggereedschap en diff
hulpmiddel. Dit kan worden bereikt door de volgende regels toe te voegen aan .gitconfig bij de gebruiker thuis
directory.
[voeg "wiebelen" samen]
name = "Wiggle flexibel samenvoegen"
bestuurder = wiebelen -o %A %A %O %B
recursief = binair
[samenvoegen]
gereedschap = wiebelen
[mergetool "wiebelen"]
cmd = wiebelen -B -o $GEMERGD $LOCAL $BASE $REMOTE
[difftool "wiebelen"]
cmd = wiebelen -Bd $LOCAL $REMOTE
Dit zal maken git samenvoegtool en git difftool . wiebelen.

Als je wilt git altijd gebruiken wiebelen voor samenvoegingen (wat gevaarlijk kan zijn), kunt u toevoegen
* samenvoegen = wiebelen
naar een geschikte gitattributen bestand zoals $HOME/.config/git/attributen.

OFFERTE

De naam van wiebelen werd geïnspireerd door het volgende citaat.

Het probleem vind ik dat ik vaak wil nemen
(bestand1+patch) -> bestand2,
als ik geen file1. Maar merge-tools willen nemen
(bestand1|bestand2) -> bestand3.
Ik heb geen grafische tool gezien die je helpt een patch te wiebelen
in een bestand.
-- Andrew Morton - 2002

TEKORTKOMINGEN

- wiebelen kan de uitgebreide unified-diff-uitvoer die het produceert voor --diff niet lezen
--woorden.

- wiebelen kan het op woorden gebaseerde samenvoegformaat dat het produceert voor --merge niet lezen
--woorden.

- wiebelen begrijpt Unicode niet en zal dus alle niet-ASCII-tekens veel behandelen
hetzelfde als het behandelt interpunctie - het zal elk als een afzonderlijk woord behandelen. De
browser niet-ASCII-tekens correct weergeeft.

Gebruik wiggle online met behulp van onworks.net-services