.TH "STYX" "1" .SH "NAME" styx \(em A combined parser and scanner generator .SH "SYNOPSIS" .PP \fBstyx\fR [\fB-diagnose\fP] [\fB-verbose\fP] [\fB-makeC\fP] [\fB-makeIMG\fP] [\fB-makeINT\fP] [\fB-shortform\fP] [\fB-BINSTYX=\fP\fIdirectory\fR] [\fB-GENSTYX=\fP\fIdirectory\fR] [\fB-SPESTYX=\fP\fIdirectory\fR] \fIlanguage\fR .PP \fBstypp\fR [\fB-charset=\fP\fIstring\fR] [\fB-wprint\fP] [\fB-prepar=\fP\fIstring\fR] [\fB-premac=\fP\fIstring\fR] [\fB-prefun=\fP\fIstring\fR] [\fB-Start=\fP\fIstring\fR] [\fB-xaron\fP] [\fB-early\fP] [\fB-shiftfun=\fP\fIstring\fR] [\fB-reducefun=\fP\fIstring\fR] [\fB-ppfun=\fP\fIstring\fR] [\fB-BINSTYX=\fP\fIpath\fR] \fIsrclang\fR \fItgtlang\fR \fIfilename\fR .PP \fBstydoc\fR [\fB-StyxPath=\fP\fIpath\fR] [\fB-Template=\fP\fIpath\fR] [\fB-RefAlias=\fP\fIstring\fR] [\fB-recursiv\fP] [\fB-prodcom\fP] [\fB-keepNTs=\fP\fIstring\fR] [\fB-noClass=\fP\fIstring\fR] [\fB-exProds=\fP\fIstring\fR] [\fB-ignRRef=\fP\fIstring\fR] [\fB-BINSTYX=\fP\fIpath\fR] \fIgrammarfile\fR \fIoutfile\fR .PP \fBctoh\fR [\fB-ct\fP] [\fB-force\fP] [\fB-CPATH=\fP\fIpath\fR] [\fB-HPATH=\fP\fIpath\fR] [\fB-PRJ=\fP\fIpath\fR] [\fB-DPATH=\fP\fIpath\fR] [\fB-DROOT=\fP\fIpath\fR] .PP \fBptm_img\fR [\fB-FileName=\fP\fIpath\fR] [\fB-charset=\fP\fIstring\fR] [\fB-skipset=\fP\fIstring\fR] [\fB-binmode\fP] [\fB-wprint\fP] [\fB-prepar=\fP\fIstring\fR] [\fB-premac=\fP\fIstring\fR] [\fB-prefun=\fP\fIstring\fR] [\fB-Start=\fP\fIstring\fR] [\fB-xaron\fP] [\fB-early\fP] [\fB-shiftfun=\fP\fIstring\fR] [\fB-reducefun=\fP\fIstring\fR] [\fB-BINSTYX=\fP\fIpath\fR] \fIlanguage\fR \fIimage\fR .PP \fBlim_test\fR [\fB-charset=\fP\fIstring\fR] [\fB-binmode\fP] [\fB-wprint\fP] [\fB-prepar=\fP\fIstring\fR] [\fB-premac=\fP\fIstring\fR] [\fB-prefun=\fP\fIstring\fR] [\fB-tokens\fP] [\fB-symbols\fP] [\fB-BINSTYX=\fP\fIpath\fR] \fIlanguage\fR \fIfilename\fR .PP \fBpim_test\fR [\fB-charset=\fP\fIstring\fR] [\fB-binmode\fP] [\fB-wprint\fP] [\fB-prepar=\fP\fIstring\fR] [\fB-premac=\fP\fIstring\fR] [\fB-prefun=\fP\fIstring\fR] [\fB-Start=\fP\fIstring\fR] [\fB-xaron\fP] [\fB-early\fP] [\fB-shiftfun=\fP\fIstring\fR] [\fB-reducefun=\fP\fIstring\fR] [\fB-tree\fP] [\fB-BINSTYX=\fP\fIpath\fR] \fIlanguage\fR \fIfilename\fR .SH "DESCRIPTION" .PP This manual page documents briefly the \fBstyx\fR, \fBstypp\fR, \fBstydoc\fR, \fBctoh\fR, \fBlim_test\fR and \fBpim_test\fR commands. It was written for the \fBDebian GNU/Linux\fP distribution because the original programs don't have manual pages, but have documentation in HTML format (see below). .PP \fBstyx\fR 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. .PP \fBstypp\fR is sort of a ``\fIpretty printer\fP'' 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. .PP \fBstydoc\fR generates HTML reference documentation for a grammar specified in grammarfile using a template. .PP \fBctoh\fR is used to create header files from C sources generated by \fBstyx\fR. 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. .PP \fBptm_img\fR translates a source file specified by the FileName option to a binary image. If the FileName option is omitted, the \fIimage\fP file must exist and the program writes the derivation tree to stdout. .PP \fBlim_test\fR uses a scanner image file for \fIlanguage\fP to scan the source in \fIfilename\fP writing the token stream to stdout. .PP \fBpim_test\fR uses scanner and parser image files for \fIlanguage\fP to parse the source in \fIfilename\fP writing the derivation tree to stdout. .SH "ENVIRONMENT" .PP 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. .PP For \fBstyx\fR, \fBSPESTYX\fP is the search path for language specifications (\fIlanguage\fP.sty), scanner and parser image files are located using \fBBINSTYX\fP while the location of generated C code is determined by \fBGENSTYX\fP. .PP \fBstypp\fR, \fBstydoc\fR, \fBptm_img\fR, \fBlim_test\fR and \fBpim_test\fR use \fBBINSTYX\fP to locate scanner and parser image files \fIlanguage\fP.lim and \fIlanguage\fP.pim. .SH "SEE ALSO" .PP The programs are documented fully in \fIThe Styx Handbook\fP available in the source distribution in LinuxDoc and HTML format. On \fBDebian GNU/Linux\fP systems the documentation is contained in the \fIstyx-doc\fP package. .SH "AUTHOR" .PP This manual page was written by Siggy Brentrup for the \fBDebian GNU/Linux\fP 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. .\" created by instant / docbook-to-man, Sun 01 Jan 2012, 16:10