NOMBRE¶
diff - busca diferencias entre dos ficheros
SINOPSIS¶
diff [opciones] fichero-origen fichero-destino
DESCRIPCIÓN¶
En el caso más simple,
diff compara los contenidos de los dos
ficheros
fichero-origen y
fichero-destino. Un nombre de fichero
- significa texto leído desde la entrada estándar. Como un
caso especial,
diff - - compara una copia de la entrada estándar
consigo misma.
Si
fichero-origen es un directorio y
fichero-destino no lo es,
diff compara el fichero en
fichero-origen cuyo nombre sea igual
que el de
fichero-destino, y viceversa. El fichero no directorio no
puede ser
-.
Si tanto
fichero-origen como
fichero-destino son directorios,
diff compara los ficheros correspondientes en ambos directorios, en
orden alfabético; esta comparación no es recursiva a menos que se
hayan dado las opciones
-r o
--recursive.
diff nunca
compara los contenidos reales de un directorio como si fuera un fichero. El
fichero que se especifique completamente no puede ser la entrada
estándar, puesto que la entrada estándar no tiene nombre y la
noción de ``fichero con el mismo nombre'' no puede aplicarse.
Las opciones de
diff empiezan con
-, así que normalmente
fichero-origen y
fichero-destino no pueden empezar con
-.
Sin embargo,
-- como un argumento solo, trata los restantes argumentos
como nombres de fichero incluso si empiezan con
-.
Opciones¶
A continuación se presenta un sumario de todas las opciones que
diff
de GNU acepta. La mayoría de ellas tienen dos nombres equivalentes, uno
de los cuales es una sola letra precedida por
-, y el otro es un nombre
largo precedido por
--. Varias opciones de una sola letra (a menos que
tomen un argumento) pueden combinarse en una sola palabra de la línea de
órdenes:
-ac es equivalente a
-a -c. Las opciones largas
pueden abreviarse a un prefijo único de sus nombres. Los corchetes
(
[ y
]) indican que una opción toma un argumento opcional.
- -líneas
- Muestra líneas (un entero) líneas de
contexto. Esta opción no especifica por sí misma un formato de
salida; no tiene efecto si no se combina con -c o -u. Esta
opción está obsoleta. Para una operación correcta,
patch necesita típicamente al menos dos líneas de
contexto.
- -a
- Trata todos los ficheros como de texto y los compara
línea por línea, incluso si no parecen ser de texto.
- -b
- Hace caso omiso de cambios referentes a la cantidad de
espacio en blanco.
- -B
- No hace caso de cambios consistentes en sólo insertar
o borrar líneas en blanco.
- --brief
- Informa solamente de si los ficheros difieren, no acerca de
los detalles de las diferencias.
- -c
- Emplea el formato de salida de contexto.
- -C líneas
-
- --context[=líneas]
- Emplea el formato de salida de contexto, mostrando
líneas (un entero) líneas de contexto, o tres si
líneas no se da. Para una operación correcta,
patch necesita típicamente al menos dos líneas de
contexto.
- --changed-group-format=formato
- Emplea formato para mostrar un grupo de líneas
conteniendo líneas que difieren en ambos ficheros en formato
if-then-else (si-entonces-en otro caso).
- -d
- Cambia el algoritmo para quizás encontrar un conjunto
de cambios más pequeño. Esto hace a diff más lento
(a veces mucho más lento).
- -D nombre
- Construye la salida en formato if-then-else mezclada,
condicional según la macro del preprocesador nombre.
- -e
-
- --ed
- Hace que la salida sea un guión válido para
ed.
- --exclude=patrón
- Cuando compara directorios, descarta ficheros y
subdirectorios cuyos nombres base concuerden con patrón.
- --exclude-from=fichero
- Cuando compara directorios, descarta ficheros y
subdirectorios cuyos nombres case concuerden con cualquier patrón
contenido en fichero.
- --expand-tabs
- Expande tabuladores a espacios en la salida, para conservar
la alineación de tabuladores en los ficheros de entrada.
- -f
- Construye una salida que se parece vagamente a un
guión del editor ed pero tiene cambios en el orden en que
aparecen en el fichero.
- -F expreg
- En formatos de contexto y unificado, para cada pedazo de
diferencias, muestra algo de la última línea precedente que
concuerde con la expresión regular expreg.
- --forward-ed
- Construye una salida que se parece vagamente a un
guión del editor ed pero tiene cambios en el orden en que
aparecen en el fichero.
- -h
- Esta opción no tiene actualmente efecto; está
presente por compatibilidad con Unix.
- -H
- Emplea heurística para agilizar el tratamiento de
ficheros grandes que tienen numerosos cambios pequeños
dispersos.
- --horizon-lines=líneas
- No descarta las últimas líneas líneas
del prefijo común y las primeras líneas líneas del
sufijo común.
- -i
- No hace caso de cambios en la caja tipográfica;
considera las letras mayúsculas y minúsculas equivalentes.
- -I expreg
- Descarta cambios que simplementen inserten o borren
líneas que concuerden con la expresión regular
expreg.
- --ifdef=nombre
- Construye la salida en formato if-then-else mezclada,
condicional según la macro del preprocesador nombre.
- --ignore-all-space
- No hace caso del espacio en blanco cuando compara
líneas.
- --ignore-blank-lines
- No hace caso de cambios que sólo consistan en insertar
o borrar líneas en blanco.
- --ignore-case
- No hace caso de cambios en la caja tipográfica;
considera letras mayúsculas y minúsculas igual.
- --ignore-matching-lines=expreg
- No hace caso de cambios que solamente consistan en insertar
o borrar líneas que concuerden con expreg.
- --ignore-space-change
- No hace caso de cambios en la cantidad de espacio en
blanco.
- --initial-tab
- Muestra en la salida un tabulador en vez de un espacio
antes del texto de una línea en formato normal o de contexto. Esto
hace que la alineación de tabuladores en la línea se vea
normal.
- -l
- Pasa la salida a través de pr para
paginarla.
- -L etiqueta
-
- --label=etiqueta
- Emplea etiqueta en vez del nombre del fichero en las
cabeceras de formatos de contexto y unificado.
- --left-column
- Imprime solamente la columna izquierda de dos líneas
comunes en el formato de lado a lado.
- --line-format=formato
- Emplea formato para mostrar en la salida todas las
líneas de entrada en el formato if-then-else.
- --minimal
- Cambia el algoritmo para quizás encontrar un conjunto
más pequeño de cambios. Esto hace a diff más lento
(a veces mucho más lento).
- -n
- Muestra en la salida diferencias en formato RCS; como
-f excepto en que cada orden especifica el número de
líneas afectadas.
- -N
-
- --new-file
- En comparaciones de directorio, si se encuentra un fichero
en solamente un directorio, lo trata como presente pero vacío en el
otro.
- --new-group-format=formato
- Emplea formato para mostrar en la salida un grupo de
líneas tomadas de justo el segundo fichero en el formato
if-then-else.
- --new-line-format=formato
- Emplea formato para mostrar en la salida una
línea tomada de justo el segundo fichero en el formato
if-then-else.
- --old-group-format=formato
- Emplea formato para mostrar en la salida un grupo de
líneas tomadas de justo el primer fichero en el formato
if-then-else.
- --old-line-format=formato
- Emplea formato para mostrar en la salida una
línea tomada de justo el primer fichero en el formato
if-then-else.
- -p
- Muestra en qué función de C está cada
cambio.
- -P
- Cuando compara directorios, si un fichero aparece solamente
en el segundo directorio de los dos, lo trata como presente pero
vacío en el otro.
- --paginate
- Pasa la salida por pr para paginarla.
- -q
- Informa sólo de si los ficheros difieren, no de los
detalles de las diferencias.
- -r
- Cuando compara directorios, compara recursivamente
cualesquier subdirectorios encontrados.
- --rcs
- Muestra en la salida diferencias en formato RCS; como
-f excepto en que cada orden especifica el número de
líneas afectadas.
- --recursive
- Cuando compara directorios, compara recursivamente
cualesquier subdirectorios encontrados.
- --report-identical-files
-
- -s
- Informa de cuando dos ficheros son el mismo.
- -S fichero
- Cuando compara directorios, comienza con el fichero
fichero. Esto se usa para reanudar una comparación
interrumpida.
- --sdiff-merge-assist
- Muestra información extra para ayudar a sdiff.
sdiff emplea esta opción cuando ejecuta diff. Esta
opción no está pensada para que los usuarios la empleen
directamente.
- --show-c-function
- Muestra en qué función de C está cada
cambio.
- --show-function-line=expreg
- En formatos de contexto y unificado, para cada trozo de
diferencias, muestra algo de la última línea precedente que
concuerde con la expresión regular expreg.
- --side-by-side
- Emplea el formato de salida lado a lado.
- --speed-large-files
- Emplea una heurística para agilizar el tratamiento de
ficheros grandes que tienen numerosos pequeños cambios
dispersos.
- --starting-file=fichero
- Cuando compara directorios, empieza con el fichero
fichero. Esto se emplea para reanudar una comparación
interrumpida.
- --suppress-common-lines
- No muestra líneas comunes en formato lado a lado.
- -t
- Expande tabuladores a espacios en la salida, para preservar
el alineamiento de tabuladores en los ficheros de entrada.
- -T
- Muestra en la salida un tabulador en vez de un espacio
antes del texto de una línea en formato normal o de contexto. Esto
hace que la alineación de tabuladores en la línea se vea de
forma normal.
- --text
- Trata todos los ficheros como texto y los compara
línea por línea, incluso si no parecen ser de texto.
- -u
- Emplea el formato de salida unificado.
- --unchanged-group-format=formato
- Emplea formato para mostrar en la salida un grupo de
líneas comunes tomadas de ambos ficheros en formato
if-then-else.
- --unchanged-line-format=formato
- Emplea formato para mostrar en la salida una
línea común a ambos ficheros en el formato if-then-else.
- --unidirectional-new-file
- Cuando compara directorios, si un fichero aparece sólo
en el 2º directorio de los dos, lo trata como presente pero
vacío en el otro.
- -U líneas
-
- --unified[=líneas]
- Emplea el formato de salida unificado, mostrando
líneas (un entero) líneas de contexto, o tres si
líneas no se da. Para una operación correcta,
patch necesita típicamente como poco dos líneas de
contexto.
- -v
-
- --version
- Muestra en la salida el número de versión de
diff.
- -w
- Descarta espacio en blanco cuando compara líneas.
- -W columnas
-
- --width=columnas
- Emplea una anchura de salida de columnas en el
formato de lado a lado.
- -x patrón
- Cuando compara directorios, descarta ficheros y
subdirectorios cuyos nombres base concuerden con patrón.
- -X fichero
- Cuando compara directorios, descarta ficheros y
subdirectorios cuyos nombres base concuerden con cualquier patrón
contenido en fichero.
- -y
- Emplea el formato de lado a lado.
VÉASE TAMBIÉN¶
cmp(1),
comm(1),
diff3(1),
ed(1),
patch(1),
pr(1),
sdiff(1).
DIAGNÓSTICOS¶
Un estado de salida de 0 significa que no se encontraron diferencias, 1
significa que se encontró alguna diferencia y 2 significa problemas.