styx Command description

contents

# styx A combined parser and scanner generator

'styx' translates the token and syntax description for a language in [$SPESTYX/Language.sty] into scanner and parser tables and a functional interface to the abstract derivation tree.

The generated tables have to be applied to the actual scanner and parser function which are part of the styx library. The result of the parser function will be a derivation tree which can be accessed through the above mentioned interface.

## Arguments

Name | Type | Semantic
Language | name | language name

## Options

An option will be specified as follows: -<Name>=<Value>
A flag is toggled that way: -<Name>
The default value will be applied when the option wasn't specified.

Name | Type | Default value | Semantic
diagnose | flag | false | additional diagnose and information
verbose | flag | false | progress information
makeIMG | flag | false | create binary table images
makeINT | flag | false | create interface c source
makeANT | flag | false | create abstract interface c source
makeC | flag | false | create table c sources
shortform | flag | false | use short form of language name

Dependant on the given options different source and image files will be created:

1. -makeIMG
   For an interpretative execution you may only need the binary [$BINSTYX/Language.pim] and [$BINSTYX/Language.lim] image files which contain the parser and scanner tables.
2. -makeINT
   To process the derivation tree within your c/c++ program it's useful to create the interface c source [$GENSTYX/Language(1,4)_int.c].
3. -makeANT
   To process a derivation tree variant optimized wrt. memory usage it's useful to create the special interface c source [$GENSTYX/Language(1,4)_ant.c].
4. -makeC
   Instead of using the table image files you can include the c sources [$GENSTYX/Language(1,4)_pim.c] and [$GENSTYX/Language(1,4)_lim.c]. This option implies '-makeINT'.

## Environment

An environment variable will be specified as followed: -<Name>=<Value>
The default value will be applied when no environment variable was specified.

Name | Type | Default value | Semantic
BINSTYX | path | . | [.pim] und [.lim] target directory
GENSTYX | path | . | [.c] target directory
SPESTYX | path | . | [.sty] source directory