troff

troff ( / ˈ t iː r ɒ f / ), abreviatura de "typesetter roff", es el componente principal de un sistema de procesamiento de documentos desarrollado por Bell Labs para el sistema operativo Unix . Tanto troff como el relacionado nroff se desarrollaron a partir del roff original .

Mientras que nroff estaba diseñado para generar salida en terminales e impresoras de línea, troff estaba diseñado para generar salida en sistemas de composición tipográfica , específicamente en el CAT de Graphic Systems , que se había introducido en 1972. Ambos utilizaban el mismo lenguaje de marcado subyacente , y normalmente un único archivo fuente podía ser utilizado por nroff o troff sin modificaciones.

troff incluye comandos para definir fuentes, espaciado, párrafos, márgenes, notas al pie y mucho más. A diferencia de otros formateadores de texto, troff permite posicionar caracteres arbitrariamente en una página, incluso superponiéndolos, y cuenta con un lenguaje de entrada totalmente programable. Se utilizan preprocesadores independientes para facilitar la creación de tablas, diagramas y fórmulas matemáticas. Los archivos de entrada de troff son archivos de texto plano y pueden crearse con cualquier editor de texto.

Se han creado extensos paquetes de macros para diversos estilos de documentos. Una distribución típica de troff incluye las macros me para formatear artículos de investigación, las macros man y mdoc para crear páginas man de Unix , las macros mv para crear transparencias montables y las macros ms y mm para cartas, libros, memorandos técnicos e informes.

Los orígenes de troff se remontan a un programa de formato de texto llamado RUNOFF , escrito por Jerome H. Saltzer para el sistema operativo CTSS del MIT a mediados de la década de 1960. (Se dice que el nombre proviene de la frase " I'll run off a document" o "I'll run off a document ").

Bob Morris lo adaptó a la arquitectura GE 635 y llamó al programa roff (una abreviatura de runoff ). Fue reescrito como rf para el PDP-7 y, al mismo tiempo (1969), Doug McIlroy reescribió una versión extendida y simplificada de roff en el lenguaje de programación BCPL .

La primera versión de Unix se desarrolló en un PDP-7 que estaba en los laboratorios Bell . En 1971, los desarrolladores quisieron conseguir un PDP-11 para seguir trabajando en el sistema operativo. Para justificar el coste de este sistema, propusieron implementar un sistema de formato de documentos para el departamento de patentes de los laboratorios Bell. ^{[ 1 ]} Este primer programa de formato fue una reimplementación de roff de McIllroy , escrito por Joe F. Ossanna .

Cuando necesitaron un lenguaje más flexible, se escribió una nueva versión de roff llamada nroff ( un "roff" más reciente ), que proporcionó la base para todas las versiones futuras. Cuando obtuvieron una fotocompositora CAT de Graphic Systems , Ossanna modificó nroff para admitir múltiples fuentes y espaciado proporcional . Bautizada como troff , por typesetter roff , su sofisticada salida asombró al fabricante de la fotocompositora y confundió a los revisores , quienes pensaron que los manuscritos que usaban troff ya se habían publicado antes. ^{[ 2 ] [ 3 ]} Por lo tanto, el nombre troff se pronuncia / ˈ t iː r ɒ f / en lugar de * / ˈ t r ɒ f / .

Con troff llegó nroff (en realidad eran casi el mismo programa), que servía para generar salida para impresoras de línea y terminales de caracteres . Entendía todo lo que hacía troff e ignoraba los comandos que no eran aplicables, por ejemplo, los cambios de fuente .

El troff de Ossanna fue escrito en lenguaje ensamblador PDP-11 y producía una salida específica para la fotocomponedora CAT . Lo reescribió en C , aunque ahora eran 7000 líneas de código sin comentarios y seguía dependiendo de la CAT. A medida que la CAT se volvió menos común y dejó de ser compatible con el fabricante, la necesidad de que fuera compatible con otros dispositivos se convirtió en una prioridad. Ossanna murió antes de completar esta tarea, por lo que Brian Kernighan asumió la tarea de reescribir troff . La nueva versión reescrita produjo un código independiente del dispositivo que era muy fácil de leer para los postprocesadores y traducir a los códigos de impresora apropiados. Además, esta nueva versión de troff (a menudo llamada ditroff por troff independiente del dispositivo ) tenía varias extensiones, que incluían funciones de dibujo. ^{[ 4 ]} La documentación del programa define el formato de salida de ditroff , que es utilizado por muchos clones modernos de troff como GNU groff .

En 1983, troff era una de las varias herramientas UNIX disponibles para el sistema operativo UNOS de Charles River Data Systems bajo licencia de Bell Laboratories . ^{[ 5 ]}

El conjunto de herramientas troff (que incluye preprocesadores y posprocesadores) se denominó posteriormente Documenter's WorkBench (DWB) y se desarrolló continuamente en Bell Labs y más tarde en la empresa derivada Unix System Laboratories (USL) hasta 1994. En ese momento, SoftQuad se hizo cargo del mantenimiento, aunque Brian Kernighan continuó mejorando troff por su cuenta. Por lo tanto, existen al menos las siguientes variantes del troff original de Bell Labs en uso:

• El SoftQuad DWB, basado en el USL DWB 2.0 de 1994;
• el DWB 3.4 de Lucent Software Solutions (anteriormente USL);
• troff, edición Plan 9 .

Aunque troff ha sido reemplazado por otros programas como Interleaf , FrameMaker y LaTeX , todavía se usa bastante. Sigue siendo el formateador predeterminado para la documentación de UNIX .

El software se reimplementó como groff para el sistema GNU a partir de 1990. Además, debido al código abierto de los sistemas Ancient UNIX , así como a los sucesores modernos como las versiones de código abierto basadas en ditroff que se encuentran en OpenSolaris y Plan 9 de Bell Labs , hay varias versiones de AT&T troff (CAT y basadas en ditroff ^{[ 6 ]} ) disponibles bajo diversas licencias de código abierto.

En general, no se recomendaba usar troff directamente, sino a través de una interfaz más fácil de usar. ^{[ 7 ] [ 8 ]} Troff incluye macros que se ejecutan antes de comenzar a procesar el documento. Estas macros incluyen la configuración de encabezados y pies de página, la definición de nuevos comandos y la influencia en cómo se formateará la salida. El argumento de línea de comandos para incluir un conjunto de macros es , lo que ha llevado a que muchos conjuntos de macros se conozcan como el nombre de archivo base con una m al principio . ^{[ 9 ]}-mname

Los conjuntos de macros estándar, con la "m" al principio, son:

• hombre para crear páginas de manual ^{[ 10 ] [ 11 ]}
• mdoc para páginas de manual anotadas semánticamente , que se adaptan mejor a la conversión de mandoc a otros formatos. ^{[ 12 ] [ 13 ]}mandoc es una fusión que admite ambos conjuntos de comandos manuales. ^{[ 14 ]}
• yo por crear artículos de investigación ^{[ 15 ]}
• mm para crear memorandos ^{[ 16 ]}
• ms para crear libros, informes y documentación técnica ^{[ 17 ]}

Las macros ms fueron las primeras de estas, desarrolladas en AT&T, antes de ser reemplazadas por las macros mm. ^{[ 18 ]} Uno de los objetivos de las macros mm era que pudieran ser utilizadas por el grupo de mecanógrafos de Bell Labs y, con el tiempo, esto sucedió y las macros mm se convirtieron en un estándar en Bell Labs. ^{[ 19 ]} AT&T comercializó las macros mm para System V Unix. ^{[ 18 ]} En contraste, las macros me fueron desarrolladas en Berkeley. ^{[ 18 ]}

Un ejemplo de una carta comercial sencilla preparada con las macros mm sería:

.TL.ND"January 10, 1993".AU"Ms. Jane Smith".AT"Upcoming appointment".MT5 Referencia n.° A12345 .sp4 Señor Samuel Jones .sp0 Director de campo, Oficina de Inspecciones .sp0 Plaza del Gobierno 1010 .sp0 Capitoltown, ST .sp3 Estimado Sr. Jones, .sp2.P Haciendo referencia a la mencionada obligación de someter a inspección estatal nuestro proceso de producción recientemente creado, solicitamos que considere la posible inadecuación de someter las tecnologías innovadoras del mañana a los requisitos en gran medida anticuados del pasado. Si nuestro gran estado ha de prosperar en el siglo XXI, debemos tomar medidas. .Bahora , en .Ieste año de .Ieste Esta década, para preparar nuestra base industrial para la competencia interestatal e internacional que sin duda surgirá. Nuestro nuevo proceso hace precisamente eso. Por favor, no permitamos que se vea frustrado por un marco regulatorio que ya no es adecuado. .P Gracias por tener en cuenta nuestra postura. .FCSincerely.SG

Una lista completa de las macros disponibles suele figurar en una tmac(5)página del manual . ^{[ 14 ]}

A medida que Troff evolucionó, y dado que existen varias tareas que no se pueden realizar fácilmente en Troff , se desarrollaron varios preprocesadores . Estos programas transforman ciertas partes de un documento en entrada para Troff , integrándose de forma natural en el uso de "pipelines" en Unix, que envían la salida de un programa como entrada a otro (véase pipes y filtros ). Normalmente, cada preprocesador traduce solo las secciones del archivo de entrada que están marcadas especialmente, dejando el resto del archivo sin cambios. Las instrucciones de preprocesamiento integradas están escritas en un lenguaje de programación sencillo y específico de la aplicación, lo que proporciona un alto grado de potencia y flexibilidad.

• El preprocesador eqn permite especificar fórmulas matemáticas de manera sencilla e intuitiva. ^{[ 20 ]}
• tbl es un preprocesador para dar formato a tablas.
• El programa refer (y el programa similar bib ) procesa las citas en un documento según una base de datos bibliográfica .

Tres preprocesadores dotan a troff de capacidades de dibujo mediante la definición de un lenguaje específico de dominio para describir la imagen.

• PIC es un lenguaje de programación procedimental que proporciona varias funciones de dibujo como círculo y caja . ^{[ 21 ]}
• Ideal permite dibujar imágenes de forma declarativa , derivando la imagen mediante la resolución de un sistema de ecuaciones simultáneas basado en vectores y transformaciones descritas por su entrada. ^{[ 22 ]}
• grn describe las imágenes a través de elementos gráficos dibujados en coordenadas absolutas, basándose en el formato de archivo gremlin definido por una antigua estación de trabajo gráfica. ^{[ 23 ]}

Además, existe un comando soelim que elimina .solas directivas de inclusión del texto de entrada. ^{[ 24 ]}

Una estructura típica del oleoducto podría ser:

soelim file | refer | ideal | pic | tbl | eqn | troff

Sin embargo, otros preprocesadores permiten dibujar imágenes más complejas generando una salida para pic .

• grap dibuja gráficos , como diagramas de dispersión e histogramas . ^{[ 25 ]}
• chem dibuja diagramas de estructuras químicas . ^{[ 26 ]}
• dformat dibuja estructuras de datos basadas en registros . ^{[ 27 ]}

Se han desarrollado otras interfaces de usuario que pretenden ser más fáciles de usar para troff.

Uno de ellos es Sanscribe , desarrollado originalmente en Berkeley y mejorado durante la década de 1980 por varios usuarios, entre ellos Intel e InterACT . Utilizado para escribir memorandos, informes y documentos, Sanscribe se basa en comandos básicos de troff, así como en las macros me y diversos preprocesadores y postprocesadores como soelim, eqn, tbl, grap y pic. Sin embargo, es un programa binario principal, no un preprocesador. Su capacidad de inclusión condicional lo hace especialmente útil para mantener manuales de referencia multiplataforma. No obstante, Sanscribe es frágil y propenso a generar errores crípticos o resultados con formatos extraños. ^{[ 28 ]}

Un front-end de propósito especial es vgrind , que genera listados de programas fuente con un formato atractivo, con características como comentarios en cursiva, palabras clave en negrita y nombres de funciones resaltados en los márgenes. Puede ejecutarse como filtro o como programa principal, y su salida se pasa a troff. Es compatible con los lenguajes utilizados en las instalaciones de Bell Labs, incluyendo no solo Fortran , C y C++ , sino también herramientas específicas del dominio como Bourne shell y yacc, así como otras más generales como Emacs Lisp e Icon . ^{[ 24 ]}

El conjunto de herramientas CADiZ emplea un enfoque diferente para la notación Z. En lugar de que el cadizprograma sea un preprocesador al inicio de la canalización, interactúa varias veces con troffcomo entrada y salida, utilizando archivos guardados en lugar de una tubería. CADiZ también contiene su propio conjunto de macros, llamadas .ZAa .ZZ. ^{[ 29 ]}

• Autoedición
• Libro de documentos
• groff GNU troff/nroff reemplazo
• nroff
• SGML
• Texas
• Escriba (lenguaje de marcado)

• El procesador de texto para tipógrafos
• La historia de troff
• Implementación gratuita de troff
• Versión adaptada de troff y programas relacionados, derivada de OpenSolaris.
• Manual de usuario para la edición Plan 9 de troff (en formato PostScript)
• La sección 3 de "Una historia de UNIX antes de Berkeley" describe la historia de roff, nroff, troff, ditroff, tbl, eqn y más.
• El código fuente original de nroff, troff y los preprocesadores de AT&T Bell Labs en forma de Documenter's Workbench (DWB) Release 3.3 (adaptado a los sistemas UNIX actuales desde http://www2.research.att.com/sw/download )