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.