README file for the Rail package, version 1.0 #1The Rail package allows you to include syntax diagrams (also known asrailroad diagrams) in a LaTeX document. A UNIX manual page and LaTeXdocumentation are included. The package consists of a LaTeX style file(rail.sty) and a C program (rail) and works in two passes not unlikeBibTeX. Diagrams are specified in a regular-expression like formatbetween \begin{rail} and \end{rail} brackets, and are formatted usingthe standard LaTeX picture environment.To use the package, you need a UNIX system with LaTeX. Actually, therail program should be portable to non-UNIX systems, but you need lexand yacc (or compatible programs such as flex and bison) and a Ccompiler. No fancy ANSI C constructions are used, and the programpasses 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/reduceconflicts; this is normal.To create rail.dvi (DVI version of rail.tex) and rail.txt (plain textversion 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 wherethings should be installed (BINDIR,TEXDIR,MANDIR,MANSUFFIX), then typethe 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 bizarretest cases, try.tex. This can be used as a regression test aftermodifications.As of version 1.0, the Rail package is available for Internet anonymousFTP 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.tarand rail.1.0.tar.Z, respectively. If you cannot use FTP, mail copies canbe requested from the author of the package.Please report any bugs or improvements to me, and have fun.L.W.J. RooijakkersUniversity of NijmegenThe NetherlandsE-mail: lwj@cs.kun.nlUpdate history:09-Oct-1990 L. Rooijakkersfirst available for local distribution07-Feb-1991 L. Rooijakkersseveral enhancements08-Feb-1991 L. Rooijakkersversion 1.0 #012-Feb-1991 L. Rooijakkersversion 1.0 #1 portability mods