add copying and readme information

--HG--
branch : JLexPHP
extra : convert_revision : svn%3A6e7b9e80-5218-0410-8339-b7667638d355/wez/php/JLexPHP%40148

Author: wez

COPYING

@@ -0,0 +1,25 @@
+Copyright 2006 Wez Furlong, OmniTI Computer Consulting, Inc.
+Based on JLex which is:
+
+       JLEX COPYRIGHT NOTICE, LICENSE, AND DISCLAIMER
+  Copyright 1996-2000 by Elliot Joel Berk and C. Scott Ananian 
+
+  Permission to use, copy, modify, and distribute this software and its
+  documentation for any purpose and without fee is hereby granted,
+  provided that the above copyright notice appear in all copies and that
+  both the copyright notice and this permission notice and warranty
+  disclaimer appear in supporting documentation, and that the name of
+  the authors or their employers not be used in advertising or publicity
+  pertaining to distribution of the software without specific, written
+  prior permission.
+
+  The authors and their employers disclaim all warranties with regard to
+  this software, including all implied warranties of merchantability and
+  fitness. In no event shall the authors or their employers be liable
+  for any special, indirect or consequential damages or any damages
+  whatsoever resulting from loss of use, data or profits, whether in an
+  action of contract, negligence or other tortious action, arising out
+  of or in connection with the use or performance of this software.
+  **************************************************************/
+
+

README

@@ -0,0 +1,60 @@
+JLexPHP: a Lexical Analyzer Generator for PHP, based on JLex.
+For copyright and licensing information, see the COPYING file.
+
+This is an adaptation of some Java code that generates lexers from lex style
+input files.
+
+The porting effort was pretty trivial, with the hardest part being the buffer management.
+
+Usage is fairly typical of lexers; you'll want to create a lexer file like this:
+
+----8<------
+<?php
+include 'jlex.php';
+
+%%
+
+D = [0-9]
+
+%%
+
+D+ { echo "The number ", $this->yytext(), "\n"; }
+.  { echo "Something else ", $this->yytext(), "\n"; }
+
+----8<------
+
+Then run process this file:
+
+  java -cp JLexPHP.jar JLexPHP.Main your.lex
+
+(the supplied makefile will create the jar file for you, or you
+can build it with:
+
+  javac JLexPHP/Main.java
+  jar cvf JLexPHP.jar JLexPHP/*.class
+)
+
+JLexPHP will output your.lex.php.  It will contain a class that will recognize
+the input stream described in your .lex file.
+
+Usage of that class is along the lines of:
+
+$scanner = new Yylex(fopen("file", "r"));
+while ($scanner->yylex())
+	;
+
+A more complicated scanner will use the createToken() method to create a token
+object that can then be fed into a parser, such as a lemon based parser.  You
+can see an example of that in the c.lex source file.  It is designed to work in
+conjunction with it's corresponding c.y file in my lemon port for php.
+
+
+You can find more information on the lexer syntax in the JLex manual:
+http://www.cs.princeton.edu/~appel/modern/java/JLex/current/manual.html
+
+
+Enjoy!
+
+--Wez.
+[email protected]
+

jlex.php

@@ -1,4 +1,29 @@
 <?php # vim:ts=2:sw=2:et:
+/*
+  Copyright 2006 Wez Furlong, OmniTI Computer Consulting, Inc.
+  Based on JLex which is:
+
+       JLEX COPYRIGHT NOTICE, LICENSE, AND DISCLAIMER
+  Copyright 1996-2000 by Elliot Joel Berk and C. Scott Ananian 
+
+  Permission to use, copy, modify, and distribute this software and its
+  documentation for any purpose and without fee is hereby granted,
+  provided that the above copyright notice appear in all copies and that
+  both the copyright notice and this permission notice and warranty
+  disclaimer appear in supporting documentation, and that the name of
+  the authors or their employers not be used in advertising or publicity
+  pertaining to distribution of the software without specific, written
+  prior permission.
+
+  The authors and their employers disclaim all warranties with regard to
+  this software, including all implied warranties of merchantability and
+  fitness. In no event shall the authors or their employers be liable
+  for any special, indirect or consequential damages or any damages
+  whatsoever resulting from loss of use, data or profits, whether in an
+  action of contract, negligence or other tortious action, arising out
+  of or in connection with the use or performance of this software.
+  **************************************************************
+*/
 
 class JLexToken {
   public $line;