NAME

       styx — A combined parser and scanner generator

SYNOPSIS

       styx  [-diagnose]   [-verbose]   [-makeC]   [-makeIMG]   [-makeINT]   [-shortform]   [-BINSTYX=directory]
       [-GENSTYX=directory]  [-SPESTYX=directory] language

       stypp [-charset=string]  [-wprint]  [-prepar=string]  [-premac=string]  [-prefun=string]  [-Start=string]
       [-xaron]  [-early]  [-shiftfun=string]   [-reducefun=string]   [-ppfun=string]   [-BINSTYX=path]  srclang
       tgtlang filename

       stydoc [-StyxPath=path]  [-Template=path]  [-RefAlias=string]  [-recursiv]  [-prodcom]  [-keepNTs=string]
       [-noClass=string]  [-exProds=string]  [-ignRRef=string]  [-BINSTYX=path] grammarfile outfile

       ctoh [-ct]  [-force]  [-CPATH=path]  [-HPATH=path]  [-PRJ=path]  [-DPATH=path]  [-DROOT=path]

       ptm_img  [-FileName=path]   [-charset=string]  [-skipset=string]  [-binmode]  [-wprint]  [-prepar=string]
       [-premac=string]    [-prefun=string]     [-Start=string]     [-xaron]     [-early]     [-shiftfun=string]
       [-reducefun=string]  [-BINSTYX=path] language image

       lim_test  [-charset=string]   [-binmode]  [-wprint]  [-prepar=string]  [-premac=string]  [-prefun=string]
       [-tokens]  [-symbols]  [-BINSTYX=path] language filename

       pim_test [-charset=string]  [-binmode]  [-wprint]  [-prepar=string]   [-premac=string]   [-prefun=string]
       [-Start=string]   [-xaron]   [-early]   [-shiftfun=string]  [-reducefun=string]  [-tree]  [-BINSTYX=path]
       language filename

DESCRIPTION

       This manual page documents briefly the styx, stypp, stydoc, ctoh, lim_test and  pim_test        commands.
       It  was  written  for  the  Debian GNU/Linux distribution because the original programs don't have manual
       pages, but have documentation in HTML format (see below).

       styx translates token and syntax descriptions contained in  $SPESTYX/language.sty  yielding  scanner  and
       parser tables as well as a functional interface to the abstract derivation tree.

       stypp is sort of a ``pretty printer'' for source files written in a styx-defined language. Furthermore it
       can be used to port source files, provided source and target languages have equivalent abstract syntax.

       stydoc generates HTML reference documentation for a grammar specified in grammarfile using a template.

       ctoh  is  used  to  create  header  files from C sources generated by styx. It is taken from the upstream
       author's own project development environment  where  source  files  are  written  in  a  manner  allowing
       interface definitions to be automatically generated.

       ptm_img  translates  a  source  file  specified by the FileName option to a binary image. If the FileName
       option is omitted, the image file must exist and the program writes the derivation tree to stdout.

       lim_test uses a scanner image file for language to scan the source in filename writing the  token  stream
       to stdout.

       pim_test  uses  scanner  and  parser image files for language to parse the source in filename writing the
       derivation tree to stdout.

ENVIRONMENT

       Upstream authors use non-standard conventions for command-line options and environment variables, to  the
       effect  that  the  latter  are best viewed as options which default to the value of the identically named
       environment variable if not specified.

       For styx, SPESTYX is the search path for language specifications (language.sty), scanner and parser image
       files are located using BINSTYX while the location of generated C code is determined by GENSTYX.

       stypp, stydoc, ptm_img, lim_test and pim_test use BINSTYX  to  locate  scanner  and  parser  image  files
       language.lim and language.pim.

SEE ALSO

       The  programs  are documented fully in The Styx Handbook available in the source distribution in LinuxDoc
       and HTML format. On Debian GNU/Linux systems the documentation is contained in the styx-doc package.

AUTHOR

       This manual page was written by Siggy Brentrup <bsb@debian.org> for the Debian GNU/Linux system (but  may
       be  used  by  others).   Permission  is granted to copy, distribute and/or modify this document under the
       terms of the GNU Free Documentation License, Version 1.1 or any  later  version  published  by  the  Free
       Software Foundation; with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts.

                                                                                                         STYX(1)