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.

Herramientas de GNU                            22 Septiembre 1993                                        DIFF(1)