lgrind: en línea en la nube

PROGRAMA:

NOMBRE

lgrind - muele listas de programas agradables usando LaTeX

NOTA

Esta página de manual aún no está muy desactualizada, pero podría estarlo pronto, excepto que alguien me pida que trabaje.
en eso. Considere los documentos LaTeX como los documentos reales.

SINOPSIS

moler [ -e ] [ -i ] [ - ] [ -n ] [ -c ] [ -t ] [ -h ] [ -d <descripción
archivo> ] [ -l ] [ -s ] ...

DESCRIPCIÓN

LGrind formatea las fuentes del programa con un estilo agradable usando Látex(1). Los comentarios se colocan en
roman, palabras clave en negrita, variables en cursiva y cadenas en letra de máquina de escribir. Fuente
los números de línea de archivo aparecen en el margen derecho (cada 10 líneas).

LGrind procesa sus archivos de entrada y escribe el resultado en la salida estándar. Esta salida
se puede guardar para editarlo más tarde, incluirlo en un documento más grande, etc.

Las opciones son:

-e procesar un archivo LaTeX para código incrustado.

-i procesar el archivo de código fuente para su inclusión en un documento LaTeX.

- tomar la entrada de la entrada estándar.

-n no ponga las palabras clave en negrita.

-c no trate a @, etc. especialmente en los comentarios.

-t cambiar el ancho de la pestaña (por defecto 8).

-h especifica el texto que se incluirá en el encabezado.

-d especifica el archivo de definiciones de idioma (el valor predeterminado es
/ usr / lib / texmf / tex / latex / lgrind / lgrindef).

-¡D! igual que el anterior, pero escribe un ejecutable parcheado.

-l especifica el idioma a utilizar.

-s muestra una lista de idiomas conocidos actualmente.

Si se llama a LGrind sin parámetros, se mostrará una pantalla de ayuda. Si ninguno -e ni -i
se especifican, se produce un archivo LaTeX completo. Cuando no se especifica ningún idioma, LGrind
trata de averiguar el idioma que se usa por sí mismo; C se utiliza cuando esto falla.

USO

Por ejemplo, para incluir un archivo C llamado foo.c en su documento LaTeX, primero dé el
mando:

lgrind -i -lc foo.c> foo.tex

Esto generará foo.tex, que tendrá la versión bastante impresa de foo.c con mucho
de los comandos LaTeX.

Luego incluya lgrind.sty como incluye cualquier otro estilo, es decir, con el
\ usepackage {lgrind} línea al comienzo de su documento LaTeX. Habiendo hecho esto, dentro
el documento puede incluir foo.tex usando uno de los siguientes comandos:

\ lgrindfile {foo.tex}
que simplemente incluirá el archivo en ese punto del texto y dibujará horizontalmente
líneas antes y después del listado.

\ lagrind [htbp] {foo.tex} {título} {etiqueta}
que pondrá la lista también dentro de un entorno de figura, usando el flotador
opciones, título y etiqueta que le dio.

Para producir un archivo LaTeX independiente a partir de, digamos, un archivo Yacc:

lgrind -ly bary.y> bary.tex
Esto usa fancyhdr.sty de Piet van Oostrum para hacer los encabezados y pies de página.

Para obtener una explicación más detallada de estos comandos, consulte
/usr/TeX/texmf/doc/latex/lgrind.dvi.

EMBEDDED PROGRAMAS DENTRO A Látex ARCHIVO

(De las notas de Jerry Leichter.)

Dentro del texto de su archivo LaTeX, marca grupos de líneas como texto o visualización
código de programa de estilo:

Estilo de texto:

La expresion
%(
un + 3
%)
produce 10.
imprime algo como: "La expresión a + 3 produce 10. "(con" a + 3 "establecido como
programa.)

El mismo efecto se puede lograr con @ en línea.

La expresión @a + 3 @ produce 10.

Estilo de visualización:

La declaración
%[
a + = 3;
%]
es un ejemplo de un operador incremental.
imprime algo como:

La declaración
a + = 3;
es un ejemplo de un operador incremental.

Reglas importantes:

% y el siguiente carácter deben ser los dos primeros caracteres de la línea para ser
Reconocido.

poner nada en la línea después del% y el carácter clave. Si haces eso, LGrind
proporcionará un entorno predeterminado que producirá un \ hbox para% ()%, y un
\ vbox para% [-%]. Si arriesgas cosas, LGrind asume que quieres
controlar el formato por completo. Hacer esto requiere comprensión exactamente que
código que LGrind produce está haciendo. (¡A veces no estoy seguro de hacerlo!)

%) y%] son, si recuerdo bien, simplemente ignorados fuera de un grupo de código, pero cualquier
extra% (o% [produce una advertencia, por lo que falta un%) o%] normalmente se detecta.

Puede insertar su propio código usando una línea que comience con% = en el texto del programa.
Todo lo que ingrese después de eso se deja en la salida, exactamente como lo escribió. Será
ejecutado en un entorno extraño, por lo que hacer cualquier cosa elegante es muy complicado. Una macro
\ Line, se proporciona para ayudarlo a hacer cosas simples. Por ejemplo,

%[
% = \ Línea {________ \ vdots}

a = 1;
%]
produce:

.
.
.
a = 1;

(Dentro del texto del programa, _ está activo y se expande a un espacio de ancho fijo. Un montón
de macros también se definen. Si comprende cómo configura LGrind, puede reemplazar
los 8 _ con una llamada a \ Tab, pero dejaré que te cuelgues en ese.)

La salida de LGrind siempre contiene exactamente una línea de salida para cada línea de entrada. Por eso,
puede buscar números de línea en los mensajes de error de TeX en su archivo original, en lugar de en
el archivo lgrind'ed (lground?). (Por supuesto, si el problema está en la salida de LGrind ...)

Muchas cosas se pueden controlar redefiniendo varias macros. Puedes cambiar las fuentes
LGrind usará para varios tipos de cosas, cuánto sangra la salida, si
agrega números de línea, y si es así, en qué intervalo los imprime y si los pega en
la izquierda o la derecha, y así sucesivamente. Todo esto se describe en lgrind.dvi, aunque probablemente
no muy bien. La configuración predeterminada produce una salida que me parece razonable, aunque
No puedo decir que estoy extasiado por eso. Haciendo un realmente un buen trabajo requeriría definir algunos
fuentes especiales.

Use lgrind en línea usando los servicios de onworks.net