wiggle - Online en la nube

PROGRAMA:

NOMBRE

wiggle: aplique parches rechazados y realice diferencias de palabra

SINOPSIS

menearse [función] [opciones] presentar [archivos]

DESCRIPCIÓN

La función principal de menearse es aplicar un parche a un archivo de manera similar a la
parche(1) programa.

La diferencia distintiva de menearse es que intentará aplicar un parche incluso si el
La parte "antes" del parche no coincide perfectamente con el archivo de destino. Esto se logra por
dividir el archivo y el parche en palabras y encontrar la mejor alineación de palabras en el archivo
con palabras en el parche. Una vez que se ha encontrado esta alineación, cualquier diferencia (en términos de palabras)
en el parche se aplican al archivo de la mejor manera posible.

También, menearse detectará (en algunos casos) cambios que ya se han aplicado, y
ingnóralos.

menearse asegura que todos los cambios en el parche se apliquen al archivo de destino de alguna manera. Si un
No se puede realizar un cambio particular en el archivo, el archivo se anota para mostrar dónde
El cambio debe realizarse de manera similar a la unir(1) programa con el -A opción. Cada
La anotación contiene 3 componentes: una parte del archivo original donde el cambio debe
aplicar, una parte del parche que no pudo coincidir con precisión en el archivo, y el
texto que debería reemplazar esa parte del parche. Estos están separados por líneas
que contiene exactamente 7 caracteres idénticos, ya sea '<', '|', '=' o '>', posiblemente
seguido de una palabra descriptiva. Entonces
<<<<<<< encontrado
Alguna parte del archivo original
||||||| previsto
texto para reemplazar
=======
texto para reemplazarlo con
>>>>>>> reemplazo
indica que "texto para reemplazar" debe reemplazarse por "texto para reemplazarlo con" en algún lugar
en la parte del archivo original. Sin embargo menearse no pude encontrar un lugar para hacer
este cambio.

menearse También puede producir informes de conflictos que muestren solo las palabras involucradas en lugar de
que mostrar líneas completas. En este caso, la salida se ve así:
<<< --- original ||| antiguo === nuevo --- >>>

Un posible uso de menearse es correr parche aplicar un parche y recopilar una lista de
rechaza al monitorear los mensajes de error del parche. Luego, para cada archivo para el que
se encontró el rechazo, ejecutar
wiggle --reemplaza originalfile originalfile.rej

Finalmente, cada archivo debe ser examinado para resolver cualquier conflicto no resuelto y para asegurarse de
el parche aplicado es semánticamente correcto.

Alternativamente, el archivo de parche original se puede alimentar al VISTA RAPIDA modo como
wiggle -B <archivo de parche

Esto permitirá que los cambios y conflictos sean inspeccionados y, hasta cierto punto, modificados;
y luego se pueden guardar los resultados.

CAMPUS
Las siguientes opciones se entienden por menearse. Algunos de estos se explican en más
detalles en las siguientes secciones sobre FUSIÓN, DIFERENCIA, EXTRACCIÓN y EXPLORACIÓN.

-m, --unir
Seleccione la función "fusionar". Ésta es la función predeterminada.

-d, --diferencia
Seleccione la función "diff". Esto muestra las diferencias entre archivos. Esto puede
ser dado después --navegar (ver abajo) en cuyo caso un parche o diff de dos archivos puede
ser visto sin los originales.

-x, --extraer
Seleccione la función "extraer". Esto extrae una rama de un parche o archivo de combinación.

-B, --navegar
Seleccione la función "examinar". Esto es similar a "fusionar" (o "diff") solo con un
presentación diferente. En lugar de que el resultado simplemente se envíe a estándar
salida, se presenta usando una GUI basada en ncurses para que cada parte del parche
puede ser examinado para comprender qué conflictos estaban involucrados y qué era necesario
ignorado para colocar el parche en su lugar.

-w, --palabras
Solicite que todas las operaciones y la visualización se basen en palabras. Este es el valor predeterminado para
función "diff".

-l, --líneas
Solicite que todas las operaciones y la visualización se basen en líneas.

-b, - ignorar espacios en blanco
Restar importancia a los espacios en blanco (espacio, tabulación y nueva línea) determina las diferencias y
cambios.

Normalmente, los espacios en blanco se tratan como una palabra que puede ser
parche. Cuando esta bandera está en vigor, el espacio en blanco sirve solo como separador entre
otras palabras y no se corresponde a sí mismo. El efecto de esto es que los cambios en el
cantidad de espacios en blanco no se tratan como significativos.

Para ser precisos, cualquier espacio en blanco se combina con la palabra anterior o, en el caso
de espacio inicial en una línea, con la siguiente palabra. Sin embargo, no está involucrado en
cualquier comparación de esa palabra. Si un parche elimina una palabra, el espacio en blanco adjunto
también se elimina. Si un parche agrega una palabra, el espacio en blanco adjunto se agrega como
bien.

Una línea vacía, o una que contenga solo espacios en blanco, se tratará como una sola palabra.
que coincidirá con cualquier otra línea en blanco, sin importar cuántos espacios tenga.

-b no tiene efecto en --línea modo.

-p, --parche
Trate el último archivo nombrado como un parche en lugar de un archivo (con --diff) o una combinación
(--extraer). En unir or VISTA RAPIDA modo, -p requiere que haya exactamente un archivo que
es un parche y puede contener parches para varios archivos. Los parches se fusionan
en cada archivo. Cuando se usa en unir modo, este uso requiere el --reemplazar opción
ya que escribir muchos archivos combinados en la salida estándar no es práctico.

Al procesar un parche de varios archivos, -p puede ir seguido de un argumento numérico
que indica cuántos componentes de nombre de archivo deben eliminarse de los archivos nombrados en el
archivo de parche. Si no se proporciona un argumento numérico, menearse deducirá un apropiado
número basado en qué archivos están presentes en el sistema de archivos.

-r, --reemplazar
Normalmente, la salida combinada se escribe en salida estándar. Con --reemplazar, la
El archivo original se reemplaza con la salida de combinación. En VISTA RAPIDA modo, esto instruye
menearse para guardar siempre la combinación resultante al salir.

-o, --salida =
En lugar de escribir el resultado en stdout o reemplazar el archivo original, este
solicita que la salida se escriba en el archivo dado. Esto es solo significativo
--unir or --navegar cuando se le da una única combinación para navegar.

Esta opción anula -r.

-R, --contrarrestar
Cuando se usa con el diff función, intercambie los archivos antes de calcular el
diferencias. Cuando se usa con el unir or VISTA RAPIDA funciones, menearse intenta
revertir los cambios en lugar de aplicarlos.

-i, --no-ignorar
Normalmente, Wiggle ignorará los cambios en el parche que parecen haber sido
aplicado en el original. Con esta bandera, esos cambios se informan como conflictos
en lugar de ser ignorado.

-W, - show-wiggles
Cuando se usa con --unir, los conflictos que se pueden colocar en su lugar se informan como
entra en conflicto con una estrofa adicional que muestra cuál sería el resultado si esta bandera
no había sido utilizado. La estrofa adicional se introduce con una línea que contiene 7
ampersand&) personajes así:
<<<<<<< encontrado
Alguna parte del archivo original
||||||| previsto
texto para reemplazar
=======
texto para reemplazarlo con
&&&&&&& resolución
Texto que resultaría de un movimiento exitoso
>>>>>>> reemplazo

--informe-meneos
Si una combinación tiene éxito en la aplicación de todos los cambios, normalmente saldrá con un
estado de éxito (0), solo informando fallas (1) si ocurrió un conflicto y fue
anotado. Con --informe-meneos menearse también informará de fallas si hay algún cambio
tenía que ser movido. Esto puede ser útil cuando menearse se utiliza para fusiones automáticas
Al igual que con git. Si ocurre algún meneo, git informará el fallo y los resultados
pueden examinarse para confirmar que son aceptables.

-h, --ayuda
Imprima un mensaje de ayuda simple. Si se da después de uno de los selectores de función
(--unir, --diferencia, --extraer, --navegar) se muestra la ayuda específica para esa función.

-V, --versión
Muestra el número de versión de menearse.

-v, --verboso
Habilite el modo detallado. Actualmente esto no hace ninguna diferencia.

-q, --tranquilo
Habilite el modo silencioso. Esto suprime el mensaje de la función de combinación cuando hay
son conflictos irresolubles.

PALABRAS
menearse puede dividir un texto en líneas o palabras al realizar sus tareas. Una linea es simplemente
una cadena de caracteres terminada por una nueva línea. Una palabra es un contiguo máximo
cadena de caracteres alfanuméricos (incluido el subrayado), una cadena de espacio contigua máxima o
caracteres de tabulación, o cualquier otro carácter individual.

UNIR
La función de combinación modifica un texto dado al encontrar todos los cambios entre otros dos textos
e imponer esos cambios en el texto dado.

Normalmente menearse se centra en qué palabras han cambiado para maximizar la posibilidad de
encontrar una buena coincidencia en el texto dado para el contexto de un cambio dado. Sin embargo puede
en su lugar, considere solo líneas completas.

menearse extrae los tres textos que necesita de los archivos enumerados en la línea de comando.
Se pueden enumerar 1, 2 o 3 archivos, y cualquiera de ellos puede ser un guión solitario que significa
entrada estándar.

Si se proporciona un archivo y el -p opción no está presente, el archivo se trata como un unir
archivo, es decir, la salida de "merge -A" o "wiggle". Dicho archivo contiene implícitamente tres
arroyos y estos se extraen y comparan.

Si se dan dos archivos, entonces el primero simplemente contiene el texto principal y el segundo es
tratado como un archivo de parche (la salida de "diff -u" o "diff -c", o un archivo ".rej" de
parche) y los otros dos textos se extraen de eso.

Si se proporciona un archivo junto con el -p opción, el archivo se trata como un archivo de parche
que contiene los nombres de los archivos que parchea. En este caso, varias operaciones de combinación
puede suceder y cada uno toma una secuencia de un archivo nombrado en el parche, y los otros dos
del parche en sí. El --reemplazar Se requiere la opción y los resultados se escriben de nuevo.
a los archivos de destino.

Finalmente, si se enumeran tres archivos, se considera que contienen el texto dado y los dos
otros textos, en orden.

Normalmente, el resultado de la combinación se escribe en la salida estándar. Si el -r se da la bandera,
la salida se escribe en un archivo que reemplaza el archivo original dado. En este caso el
se cambia el nombre del archivo original para tener un .porig sufijo (para "original parcheado" que tiene sentido
si usas por primera vez parche aplicar un parche y luego usar menearse para mover los rechazos).

Además, si el -o La opción se da con un nombre de archivo, la salida se escribirá en ese
Archivo. En este caso, no se crea ninguna copia de seguridad.

Si no se producen errores (como errores de acceso a archivos) menearse saldrá con un estado de 0 si todos
los cambios se fusionaron con éxito, y con un estado de salida de 1 y un breve mensaje si lo hubiera
los cambios no se pudieron combinar por completo y, en su lugar, se insertaron como anotaciones. Sin embargo, si
ya sea --informe-meneos or - show-wiggles se dieron opciones, menearse también existirá con
estado de 1 si se tuvo que introducir algún cambio a pesar de que esto fue exitoso.

La función de combinación puede operar en tres modos diferentes con respecto a líneas o palabras.

Con la --líneas opción, las líneas completas se comparan y los conflictos se informan como
líneas que necesitan ser reemplazadas.

Con la --palabras opción, las palabras individuales se comparan y cualquier conflicto se informa solo
cubriendo las palabras afectadas. Esto usa el formato de conflicto <<< ||| === >>>.

Sin ninguna de estas opciones, se adopta un enfoque híbrido. Las palabras individuales son
comparados y fusionados, pero cuando se encuentra un conflicto, se informa de toda la línea circundante
como en conflicto.

menearse garantizará que cada cambio entre los otros dos textos se refleje en el
resultado de la fusión de alguna manera. Hay cuatro formas diferentes en las que se puede realizar un cambio.
reflejado.

1 Si un cambio convierte A a B y A se encuentra en un lugar adecuado en el original
archivo, se reemplaza con B. Esto incluye la posibilidad de que B está vacío, pero
eso no A esta vacio.

2 Si se encuentra un cambio que simplemente agrega B y el texto inmediatamente anterior y
después de la inserción se encuentran adyacentes en el archivo original en un adecuado
lugar, entonces B se inserta entre esos textos adyacentes.

3 Si se encuentra un cambio que cambia A a B y esto parece (basado en el contexto)
alinear con B en el original, entonces se supone que este cambio ya ha sido
aplicado y el cambio se ignora. Cuando esto sucede, un mensaje que refleja la
El número de cambios ignorados se imprime mediante menearse. Esta optimización puede ser
suprimido con el -i bandera.

4 Si se encuentra un cambio que no se ajusta a ninguna de las posibilidades anteriores, entonces
El conflicto se informa como se describió anteriormente.

DIFF
La función diff se proporciona principalmente para permitir la inspección de las alineaciones que menearse
calculado entre textos y que utiliza para realizar una fusión.

La salida de la función diff es similar a la salida unificada de diff. Sin embargo, mientras
diff no genera grandes extensiones de texto común, menearseEl modo de diferenciación muestra todo.

Al calcular una alineación basada en palabras (la predeterminada), menearse puede que necesite mostrar estas palabras
diferencias basadas. Esto se hace usando una extensión del formato unificado-diff. Si una linea
comienza con una barra vertical, luego puede contener secciones rodeadas por múltiples
corchetes de caracteres. Los corchetes "<<< ++" y "++ >>>" rodean el texto agregado mientras que "<<< -"
y "- >>>" rodean el texto eliminado.

menearse Se le pueden dar los dos textos para compararlos de tres maneras.

Si solo se proporciona un archivo, entonces se trata como un parche y las dos ramas de ese
se comparan los parches. Esto permite refinar efectivamente un parche a partir de un parche basado en líneas.
a un parche basado en palabras.

Si se dan dos archivos, normalmente se supone que son textos simples para comparar.

Si se dan dos archivos junto con la opción --patch, se supone que el segundo archivo
ser un parche y se extrae la primera (con -1) o la segunda (con -2) rama y
en comparación con el texto que se encuentra en el primer archivo.

Esta última opción provoca menearse para aplicar un algoritmo de "mejor ajuste" para alinear trozos de parches
con el archivo antes de calcular las diferencias. Este algoritmo se utiliza al fusionar un
parche con un archivo, y su valor se puede ver comparando la diferencia producida de esta manera
con la diferencia que se produce al extraer primero una rama de un parche en un archivo, y
luego calculando la diferencia de ese archivo con el archivo principal.

EXTRAER
La función de extracción de menearse simplemente expone la funcionalidad interna para extraer
una rama de un parche o un archivo de combinación.

Precisamente se debe proporcionar un archivo, y se asumirá que es un archivo de combinación a menos que
--parche se da, en cuyo caso se asume un parche.

La elección de la rama se realiza proporcionando una de las -1, -2o -3 con significados obvios.

BUSCAR
La función de navegación de menearse presenta el resultado de una fusión o (con -d) una diferencia en una
GUI basada en texto que se puede navegar usando pulsaciones de teclas similares a vi(1) o emacs(1).

El navegador permite que cada una de las dos o tres transmisiones se vean individualmente con
colores utilizados para resaltar diferentes tipos de texto: verde para texto agregado, rojo para eliminado
texto, etc. También puede mostrar el parche por sí mismo, el resultado completo de la fusión o el
fusionar y el parche uno al lado del otro.

El navegador proporciona una serie de páginas de ayuda sensibles al contexto a las que puede acceder
mecanografía '?'

La parte superior derecha de la GUI informará el tipo de texto debajo del cursor, que también es
indicado por el color del texto. Las opciones son inalteradas, cambiadas, incomparables,
Extraños, ya aplicados y en conflicto. Si los significados de estos son un poco claros
las experimentaciones deberían ayudar.

Se permite una cantidad limitada de edición mientras está en VISTA RAPIDA modo. Actualmente texto que es
lo no deseado se puede descartar con x. Esto convertirá un Conflicto o Cambio a Sin cambios,
y un Incomparable a Cambiado (que efectivamente lo cambia a la cadena vacía). similar
un texto se puede marcar como deseado con c. Esto convertirá un conflicto o ajeno a
Cambió. Usar la misma clave nuevamente revertirá el cambio.

Finalmente, la mayúscula X revertirá todos los cambios en la línea actual.

Para realizar cambios más radicales, puede utilizar v que ejecuta un editor, prefiriendo $ VISUAL or
$ EDITOR si se establecen en el medio ambiente.

Si realiza algún cambio, wiggle le preguntará si desea guardar los cambios, incluso si
--reemplazar no fue dado.

ADVERTENCIA

Siempre se debe tener precaución al aplicar un parche rechazado con menearse. Cuando el parche
rechaza un parche, lo hace por una buena razón. Aunque menearse puede ser capaz de encontrar un
lugar creíble para aplicar cada cambio textual, no hay garantía de que el resultado sea
correcto en cualquier sentido semántico. El resultado siempre debe inspeccionarse para asegurarse de que sea
corregir.

EJEMPLOS

menearse --reemplazar presentar archivo.rej
Este es el uso normal de menearse y tomará cualquier cambio en archivo.rej esa parche podría
no aplicar, y fusionarlos en presentar.

menearse -dp1 presentar archivo.rej
Esto realizará una comparación de palabras entre los presentar y del antes rama de la
diferencia en archivo.rej y mostrar las diferencias. Esto le permite ver dónde se
aplicaría.

menearse --unir --ayuda
Obtenga ayuda sobre la función de combinación de menearse.

menearse --navegar --parche actualizar.parche
Analizar el actualizar.parche archivo para parches y presentar una lista de archivos parcheados que se pueden
navegó para examinar cada parche en detalle.

menearse se puede integrar con git para que se utilice como la herramienta de combinación predeterminada y la diferencia
herramienta. Esto se puede lograr agregando las siguientes líneas a .gitconfig en la casa del usuario
directorio.
[fusionar "meneo"]
name = "Combinación flexible de Wiggle"
conductor = meneo -o% A% A% O% B
recursivo = binario
[unir]
herramienta = meneo
[mergetool "meneo"]
cmd = meneo -B -o $ FUSIONADO $ LOCAL $ BASE $ REMOTO
[difftool "meneo"]
cmd = meneo -Bd $ LOCAL $ REMOTE
Esto hará git herramienta de fusión y git herramienta de diferenciación utilizan el menearse.

Si desea git para usar siempre menearse para fusiones (que pueden ser peligrosas), puede agregar
* fusionar = menear
a un apropiado atributos de git archivo como $ INICIO / .config / git / atributos.

Cotizar

El nombre de menearse se inspiró en la siguiente cita.

El problema que encuentro es que a menudo quiero tomar
(archivo1 + parche) -> archivo2,
cuando no tengo file1. Pero las herramientas de fusión quieren tomar
(archivo1 | archivo2) -> archivo3.
No he visto una herramienta gráfica que te ayude a mover un parche
en un archivo.
- Andrew Morton - 2002

DEFICIENCIAS

- menearse no puede leer la salida unificada-diff extendida que produce para --diff
--palabras.

- menearse no puede leer el formato de combinación basado en palabras que produce para --merge
--palabras.

- menearse no entiende Unicode y, por lo tanto, tratará mucho a todos los caracteres no ASCII
lo mismo que trata la puntuación: tratará a cada uno como una palabra separada. El
El navegador no mostrará correctamente los caracteres que no sean ASCII.

Use wiggle en línea usando los servicios de onworks.net