La función Comparar permite comparar las diferencias entre dos documentos. Si el formato de uno de los documentos es XML libre, debe serlo también para el otro. Un documento abierto se puede comparar con cualquier otro documento abierto, con un fichero del disco o con la última versión guardada del mismo documento.

Las opciones de menú para la comparación de documentos están disponibles en el menú Herramientas si se ha habilitado Menús completos. Elija Herramientas > Comparar y seleccione una de estas tres opciones: Última guardada, Ventana o Fichero.

También se pueden comparar dos ficheros del disco por medio de la función ACL compare_files. El resultado de la comparación se guarda en un tercer fichero que se menciona en un argumento. Si desea determinar si un documento lo ha generado la función de comparación, se puede utilizar la función ACL doc_from_compare.

La comparación del contenido de los documentos se realiza a nivel de palabra. Las palabras se consideran secuencias de caracteres separadas por espacios en blanco. Un espacio en blanco es cualquier carácter de tabulación, avance de línea, tabulación vertical, avance de página, retorno de carro o espacio. Sin embargo, cuando un carácter de espacio en blanco es significativo, como sucede dentro de los elementos as-is (donde todos los caracteres son significativos), se incluye en la comparación.

La comparación de documentos desestima las instrucciones de procesamiento (PI) de marcadores y marcadores rápidos, pero procesa otras PI de formato de contenido (fuente, salto de página o sombreado de celda de tabla). En las comparaciones se desestima el texto generado. Los cambios en el texto generado no se consideran comparaciones válidas (por ejemplo, el cambio de numeración que se produciría cuando los elementos de una lista se marcan para ser borrados o añadidos pero estas operaciones todavía no se han realizado).

Las imágenes de gráfico y las ecuaciones no se evalúan. Sin embargo, si se inserta o se borra un gráfico o una ecuación, se marcará en la comparación (pero para ver el cambio, Visualización de etiquetas debe haberse definido en Full o Partial).

El documento con los resultados de Comparar se puede guardar, manteniendo intactas los marcadores de las diferencias. Es posible que el documento de comparación guardado no sea válido en cuanto al contexto, pero se puede volver a abrir sin perder el marcador de comparación. Si se seleccionó Comparar entidades, la ventana Comparar guardará el fichero con las entidades en formato plano, de texto, es decir, el contenido de la entidad se sustituirá por la referencia a la entidad al guardar el documento.

El documento con los resultados de la comparación se puede imprimir. Si se usa Imprimir vista del editor, la salida incluye el marcador de diferencias, tales como los empaquetadores y el color de fondo (o escala de grises en las impresoras en blanco y negro). En la opción Imprimir normal, los cambios de atributos no son visibles.

La ficha Comparar del cuadro de diálogo Preferencias incluye opciones para personalizar los resultados de la comparación.

Cuando se ejecuta la comparación, la salida aparece en una ventana Comparar. (Si se usa la función ACL compare_files para comparar dos ficheros, la salida de la comparación se envía a un fichero de resultados). La ficha Comparar permite elegir entre etiquetas empaquetadoras o PI (instrucciones de procesamiento denominadas Inserty Delete ) para marcar las diferencias entre el contenido insertado o borrado. Por defecto, se usan PI para marcar el contenido insertado con caracteres de subrayado y el contenido borrado con tachado. Los colores de fondo por defecto también se cambian para las selecciones de contenido insertado y borrado. Si el contenido simplemente se ha movido, se marca como borrado en su ubicación original y como insertado en la nueva ubicación.

También se pueden comparar entidades. Al seleccionar Comparar entidades, las entidades de fichero y de texto se expanden durante la comparación y se evalúa su contenido. Cuando se envía la salida con los resultados a la ventana Comparar, las entidades se mantienen expandidas. Si no se selecciona Comparar entidades, en la comparación se incluyen únicamente las referencias a entidad y las entidades no se expanden para su evaluación.

Si se selecciona Mostrar cambios de atributos, se aplican marcadores de empaquetador a los cambios de los atributos.

Arbortext Editor usa un bloque de memoria designado que se asigna durante el proceso de comparación. La memoria asignada por defecto son 50 MB. Se puede utilizar el comando ACL set diffmemory para regular la cantidad de memoria que se asigna durante el proceso de comparación. Si la memoria asignada no es suficiente, aparecerá un mensaje de error para que se aumente.

Cuando se visualiza el documento de resultados de Comparar, las diferencias se pueden examinar con los elementos Cambio siguiente y Cambio anterior del menú Buscar.