Update package source and readme

2 files changed, 27 insertions, 7 deletions

diff --git a/README.md b/README.md
index 52423c7..1fd0b46 100644
--- a/README.md
+++ b/README.md
@@ -1,14 +1,34 @@
 # Generic Go lexer
 
-A very simple lexer.
+A very simple state-based lexer.
 
 ```go
-import "github.com/felix/lexer"
-```
+import "src.userspace.com.au/lexer"
 
-or
+// Define the tokens for the lexer.
+const (
+	_ lexer.TokenType = iota
+	tBREStart
+	tBREEnd
+	tRangeStart
+	tRangeDash
+	tRangeEnd
+	tCharacter
+	tClass
+	tNot
+)
 
-```go
-import "src.userspace.com.au/felix/lexer"
+// Define states returning a StateFunc.
+func startState(l *lexer.Lexer) lexer.StateFunc {
+	l.SkipWhitespace()
+	r := l.Next()
+	if r != '[' {
+		return l.Error("expecting [")
+	}
+	l.Emit(tBREStart)
+	return beFirstState
+}
 ```
 
+For a complete (but simple) example see the code in a [bracket expression
+generator](https://src.userspace.com.au/bechars/tree/lexer.go).
diff --git a/go.mod b/go.mod
index 7646d18..7fe7e93 100644
--- a/go.mod
+++ b/go.mod
@@ -1,3 +1,3 @@
-module src.userspace.com.au/felix/lexer
+module src.userspace.com.au/lexer
 
 go 1.12