third public release

README.md

@@ -1,7 +1,29 @@
-# Autumn Parsing
+# Autumn: Extensible Parsing Combinators
 
-Soon-ish: a user manual and various UX improvements.
+## Documentation
 
-In the meantime, dig around
-src/com/norswap/autumn/test/parsing/JavaGrammarTest.java for pointers on how to
-use the library.
+Soon: a user manual. You can send me angry emails if I procrastinate for too
+long.
+
+In the meantime, dig around [the Autumn class][autumn] for documented entry
+points into the parser. There's also [a good example][java-example] that uses
+the bundled Java grammar.
+
+For the internals, [the ParseState class][parse-state] class has a long
+explanation of the concepts underlying parse state handling. For writing custom
+parsing expressions, look at [the ParsingExpression class][parsing-exp].
+
+[autumn]: https://github.com/norswap/autumn/blob/master/src/com/norswap/autumn/Autumn.java
+
+[java-example]: https://github.com/norswap/autumn/blob/master/src/com/norswap/autumn/test/parsing/JavaGrammarTest.java
+
+[parse-state]:
+https://github.com/norswap/autumn/blob/master/src/com/norswap/autumn/parsing/state/ParseState.java
+
+[parsing-exp]: https://github.com/norswap/autumn/blob/master/src/com/norswap/autumn/parsing/ParsingExpression.java
+
+## Building
+
+    make build
+
+... will output the class files under the `out/dev` directory.

library.mk

@@ -87,7 +87,7 @@ help:
 
 build:
 	mkdir -p $(OUTDIR)
-	cp -R resources/* $(OUTDIR)
+	cp -R resources/* $(OUTDIR) 2>/dev/null || :
 	javac -Xlint:unchecked $(DEBUG) -d $(OUTDIR) -cp "deps/*" `find src $(LIBS) -name *.java`
 
 clean: