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.