Menu
CTAN
Comprehensive TeX Archive Network
Cover Upload Browse

Direc­tory tex-archive/support/rail

README file for the Rail package, version 1.0 #1

The Rail package allows you to include syntax diagrams (also known as
railroad diagrams) in a LaTeX document. A UNIX manual page and LaTeX
documentation are included. The package consists of a LaTeX style file
(rail.sty) and a C program (rail) and works in two passes not unlike
BibTeX. Diagrams are specified in a regular-expression like format
between \begin{rail} and \end{rail} brackets, and are formatted using
the standard LaTeX picture environment.

To use the package, you need a UNIX system with LaTeX. Actually, the
rail program should be portable to non-UNIX systems, but you need lex
and yacc (or compatible programs such as flex and bison) and a C
compiler. No fancy ANSI C constructions are used, and the program
passes lint quite silently.

Caveat: To get diagrams in the documentation you must first compile
        the program.

To compile, just type "make". Yacc will report 2 reduce/reduce
conflicts; this is normal.

To create rail.dvi (DVI version of rail.tex) and rail.txt (plain text
version of rail.man) use "make doc". You can also use "make rail.dvi"
or "make rail.txt" to create only one of them.

To install, edit the Makefile to set up the various directories where
things should be installed (BINDIR,TEXDIR,MANDIR,MANSUFFIX), then type
the command "make install".

To clean up, type "make clean".

To create SHAR.* files, type "make shar".

To create a TAR file, type "make tar".

To lint everything, type "make lint"

Besides the examples in rail.tex, there is another file with bizarre
test cases, try.tex. This can be used as a regression test after
modifications.

As of version 1.0, the Rail package is available for Internet anonymous
FTP from host phoibos.cs.kun.nl (131.174.81.1) in the directory pub/Rail.
There is both a compressed and an uncompressed tar file, named rail.1.0.tar
and rail.1.0.tar.Z, respectively. If you cannot use FTP, mail copies can
be requested from the author of the package.

Please report any bugs or improvements to me, and have fun.

				L.W.J. Rooijakkers
				University of Nijmegen
				The Netherlands
				E-mail: lwj@cs.kun.nl

Update history:

09-Oct-1990 L. Rooijakkers	first available for local distribution
07-Feb-1991 L. Rooijakkers	several enhancements
08-Feb-1991 L. Rooijakkers	version 1.0 #0
12-Feb-1991 L. Rooijakkers	version 1.0 #1 portability mods

Files

Name Size Date Notes
MANIFEST 766 1998-05-21 02:00
Makefile 1390 1997-10-28 01:00
README 2381 1992-07-16 02:00
README2e 847 1998-09-30 02:00
gram.y 3191 1997-01-10 01:00
lex.l 1080 1998-09-30 02:00
patchlevel.h 406 1998-09-30 02:00
rail.c 11422 1998-09-30 02:00
rail.exe 40089 1998-09-30 02:00
rail.h 1888 1998-05-26 02:00
rail.man 2056 1998-09-30 02:00
rail.ps 298274 1998-05-21 02:00
rail.sty 29518 1998-09-30 02:00
rail.tex 19537 1998-05-21 02:00
try.tex 659 1994-06-22 02:00

Down­load the con­tents of this pack­age in one zip archive (105.2k).

rail – Syn­tax spec­i­fi­ca­tion in EBNF

A C pro­gram and LaTeX pack­age to draw syn­tax di­a­grams spec­i­fied in EBNF.

Pack­age De­tailsrail
Ver­sion1.2
Li­censeUn­known Sta­tus, No In­for­ma­tion Avail­able
Main­tainerLuc Rooi­jakkers (in­ac­tive)
Klaus Ge­org Barthel­mann
Topics syn­tax of com­puter sci­ence con­structs
di­a­grams
See also syngen
Guest Book Sitemap Contact