Man Linux: Main Page and Category List

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)