6.38. Groff-1.18.1.4

El paquete Groff contiene programas para procesar y formatear texto.

Tiempo estimado de construcción: 0.4 SBU
Espacio requerido en disco: 39.2 MB

6.38.1. Instalación de Groff

Aplica el parche para añadir los dispositivos “ascii8” y “nippon” a Groff:

patch -Np1 -i ../groff-1.18.1.4-debian_fixes-1.patch
[Nota]

Nota

Estos dispositivos son usados por Man-DB cuando se formatean páginas de manual que no están en inglés y no están codificadas en ISO-8859-1. Actuamente no hay un parche usable para Groff-1.19.x que añada dicha funcionalidad.

Muchas fuentes de pantalla no incluyen las comillas simples y dobles de Unicode. Indicale a Groff que utilice en su lugar los equivalentes ASCII:

sed -i -e 's/2010/002D/' -e 's/2212/002D/' \
    -e 's/2018/0060/' -e 's/2019/0027/' font/devutf8/R.proto

Groff espera que la variable de entorno PAGE contenga el valor por defecto para el tamaño de papel. Para los residentes en Estados Unidos, PAGE=letter es un valor adecuado. Para el resto, PAGE=A4 puede ser más correcto. Aunque el tamaño del papel por defecto se configura durante la compilación, puede sobreescribirse posteriormente cambiando “A4” o “letter” en el fichero /etc/papersize.

Prepara Groff para su compilación:

PAGE=<paper_size> ./configure --prefix=/usr --enable-multibyte

Compila el paquete:

make

Este paquete no incluye un banco de pruebas.

Instala el paquete:

make install

Algunos programas de documentación, como xman, no funcionarán correctamente sin los siguientes enlaces simbólicos.

ln -sv eqn /usr/bin/geqn
ln -sv tbl /usr/bin/gtbl

6.38.2. Contenido de Groff

Programas instalados: addftinfo, afmtodit, eqn, eqn2graph, geqn (enlace a eqn), grn, grodvi, groff, groffer, grog, grolbp, grolj4, grops, grotty, gtbl (enlace a tbl), hpftodit, indxbib, lkbib, lookbib, mmroff, neqn, nroff, pfbtops, pic, pic2graph, post-grohtml, pre-grohtml, refer, soelim, tbl, tfmtodit y troff

Descripciones cortas

addftinfo

Lee un fichero de fuentes troff y añade alguna información adicional sobre la métrica de la fuente, que es usada por el sistema groff.

afmtodit

Crea un fichero de fuentes para usarlo con groff y grops.

eqn

Compila las descripciones de las fórmulas embebidas en los ficheros de entrada troff a comandos que pueda entender troff.

eqn2graph

Convierte una ecuación EQN en una imagen.

geqn

Enlace a eqn

grn

Un preprocesador groff para ficheros gremlin.

grodvi

Un controlador para groff que genera formatos dvi de TeX.

groff

Una interfaz para el sistema de formateado de documentos groff. Normalmente lanza el programa troff y un post-procesador apropiado para el dispositivo seleccionado.

groffer

Muestra ficheros groff y páginas de manual en las X y en consola.

grog

Lee ficheros y averigua cuál de las opciones-e, -man, -me, -mm, -ms, -p, -s y -t de groff se necesitan para imprimir los ficheros, y muestra el comando de groff incluyendo esas opciones.

grolbp

Un controlador de groff para las impresoras Canon CAPSL (series LBP-4 y LBP-8 de impresoras láser)

grolj4

Un controlador para groff que produce salidas en el formato PCL5 adecuado para impresoras HP LaserJet 4.

grops

Transforma la salida de GNU troff a PostScript.

grotty

Transforma la salida de GNU troff en un formato adecuado para dispositivos tipo máquina de escribir.

gtbl

Enlace a tbl.

hpftodit

Crea un fichero de fuentes para usar con groff -Tlj4 a partir de ficheros de marcas de fuentes métricas de HP.

indxbib

Hace un índice inverso para la base de datos bibliográfica, un fichero específico para usarlo con refer, lookbib y lkbib.

lkbib

Busca en las bases de datos bibliográficas referencias que contengan las claves especificadas y muestra cualquier referencia encontrada.

lookbib

Muestra un aviso en la salida de error estándar (excepto si la entrada estándar no es un terminal), lee de la entrada estándar una línea conteniendo un grupo de palabras clave, busca en las bases de datos bibliográficas de un fichero especificado las referencias que contengan dichas claves, muestra cualquier referencia encontrada en la salida estándar y repite el proceso hasta el final de la entrada.

mmroff

Un preprocesador simple para groff.

neqn

Formatea ecuaciones para salida ASCII (Código Estándar Americano para Intercambio de Información).

nroff

Un guión que emula al comando nroff usando groff.

pfbtops

Transforma una fuente en formato .pfb de PostScript a ASCII.

pic

Compila descripciones de gráficos embebidos dentro de ficheros de entrada troff o TeX a comandos que puedan ser entendidos por TeX o troff.

pic2graph

Convierte un diagrama PIC en una imagen.

post-grohtml

Transforma la salida de GNU troff a HTML.

pre-grohtml

Transforma la salida de GNU troff a HTML.

refer

Copia el contenido de un fichero en la salida estándar, excepto que las líneas entre .[ y .] son interpretadas como citas, y las líneas entre .R1 y .R2 son interpretadas como comandos sobre cómo deben ser procesadas las citas.

soelim

Lee ficheros y reemplaza líneas de la forma fichero .so por el contenido de fichero.

tbl

Compila descripciones de tablas embebidas dentro de ficheros de entrada troff a comandos que puedan ser entendidos por troff.

tfmtodit

Crea un fichero de fuentes para su uso con groff -Tdvi.

troff

Es altamente compatible con Unix troff. Normalmente debe ser invocado usando el comando groff, que también lanzará los preprocesadores y post procesadores en el orden correcto y con las opciones necesarias.