Bison - Invocando a Bison

La manera habitual de invocar a Bison es la siguiente:

bison fichero-entrada

Aquí fichero-entrada es el nombre del fichero de la gramática, que normalmente termina en `.y'. El nombre del archivo del analizador se construye reemplazando el `.y' con `.tab.c'. Así, el nombre de fichero `bison foo.y' produce `foo.tab.c', y el nombre de fichero `bison hack/foo.y' produce `hack/foo.tab.c'.

Opciones de Bison

Bison soporta las opciones tradicionales de una única letra y nombres de opción mnemónicos largos. Los nombres de opción largos se indican con `--' en lugar de `-'. Las abreviaciones para los nombres de opción se permiten siempre que sean únicas. Cuando una opción larga toma un argumento, como `--file-prefix', se conecta el nombre de la opcion con el argumento con `='.

Aquí hay una lista de opciones que puede utilizar con Bison, alfabetizadas por la opción corta.

`-b prefijo-fichero' `--file-prefix=prefijo' Especifica un prefijo a ser usado por todos los nombres de archivo de salida de Bison. Los nombres se eligen como si el fichero de entrada se llamase `prefijo.c'. `-d' `--defines' Escribe un archivo extra de salida conteniendo las definiciones de las macros para los nombres de tipo de tokens definidos en la gramática y el tipo de valor semántico YYSTYPE, además de unas cuantas declaraciones de variables extern. Si el archivo de salida del analizador se llama `name.c' entonces este archivo se llama `name.h'. Este archivo de salida es esencial si desea poner las definiciones de yylex en un archivo fuente por separado, porque yylex necesita ser capaz de hacer referencia a los códigos de tipo de token y las variables yylval. See section Valores Semánticos de los Tokens. `-l' `--no-lines' No pone ningún comando #line del preprocesador en el fichero del analizador. Normalmente Bison los pone en el archivo del analizador de manera que el compilador de C y los depuradores asocien errores con su fichero fuente, el achivo de la gramática. Esta opción hace que asocien los errores con el archivo del analizador, tratándolo como un archivo fuente independiente por derecho propio. `-n' `--no-parser' No incluye ningún código C en el archivo del analizador; genera únicamente las tablas. El archivo del analizador contiene sólo directivas #define y declaraciones de variables estáticas. Esta opción también le dice a Bison que escriba el código C para las acciones gramaticales en un archivo llamado `nombrefichero.act', en la forma de un cuerpo encerrado entre llaves para formar una sentencia switch. `-o fichero-salida' `--output-file=fichero-salida' Especifica el nombre fichero-salida para el archivo del analizador. El resto de los nombres de fichero de salida son construidos a partir de fichero-salida como se describió bajo las opciones `-v' y `-d'. `-p prefijo' `--name-prefix=prefijo' Renombra los símbolos externos utilizados en el analizador de manera que comiencen con prefijo en lugar de `yy'. La lista precisa de símbolos renombrados es yyparse, yylex, yyerror, yynerrs, yylval, yychar y yydebug. Por ejemplo, si utiliza `-p c', los nombres serán cparse, clex, etc. See section Múltiples Analizadores en el Mismo Programa. `-r' `--raw' Hace que parezca que haya sido especificado %raw. See section Sumario de Declaraciones de Bison. `-t' `--debug' Produce una definición de la macro YYDEBUG en el achivo del analizador, de manera que las facilidades de depuración sean compiladas. See section Depurando Su Analizador. `-v' `--verbose' Escribe un archivo de salida extra conteniendo descripciones amplias de los estados del analizador y qué se hace para cada tipo de token de preanálisis en ese estado. Este archivo también describe todos los conflictos, aquellos resueltos por la precedencia de operadores y los no resueltos. Este nombre de fichero se construye quitando `.tab.c' o `.c' del nombre de salida del analizador, y añadiendo `.output' en su lugar. Por lo tanto, si el archivo de entrada es `foo.y', entonces el archivo del analizador se llama `foo.tab.c' por defecto. Como consecuencia, el archivo de salida amplia se llama `foo.output'. `-V' `--version' Imprime el número de versión de Bison y termina. `-h' `--help' Imprime un sumario de las opciones de línea de comando de Bison y termina. `-y' `--yacc' `--fixed-output-files' Equivalente a `-o y.tab.c'; el archivo de salida del analizador se llama `y.tab.c', y el resto de salida se llama `y.output' y `y.tab.h'. El propósito de esta opcion es la de imitar las convenciones de los nombres de fichero de Yacc. De este modo, el siguiente script de comandos puede ser sustituto de Yacc: bison -y $*

Clave Cruzada de Opciones

Aquí hay una lista de opciones, alfabetizada por la opcion larga, para ayudarle a encontrar la opción corta correspondiente.

Invocando Bison bajo VMS

La sintaxis de la línea de comandos para Bison sobre VMS es una variante de la sintaxis del comando de Bison usual--adaptada para ajustarse a las convenciones de VMS.

Para encontrar el equivalente VMS de cualquier opción de Bison, comience con la opción larga, y sustituya con `/' el `--' inicial, y sustituya con `_' cada `-' en el nombre de opción largo. Por ejemplo, la siguiente invocación bajo VMS:

bison /debug/name_prefix=bar foo.y

es equivalente al siguiente comando bajo POSIX.

bison --debug --name-prefix=bar foo.y

El sistema de archivos de VMS no permite nombre de ficheros tales como `foo.tab.c'. En el ejemplo anterior, el archivo de salida se llamaría `foo_tab.c'.