Provided by: manpages-es_1.55-9_all bug

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.