Update docs and add more java tests (#463)

* doxygenize and update API documentation
 * fix spelling
 * add "fuzz" corpus for java decoder to improve coverage
 * use upper-case-snake names for dictionary constant definitions
 * use `LDFLAGS` in conventional `Makefile`
diff --git a/Makefile b/Makefile
index df220c2..9dc5ecc 100644
--- a/Makefile
+++ b/Makefile
@@ -23,7 +23,7 @@
 	mkdir -p $@
 
 $(EXECUTABLE): $(OBJECTS)
-	$(CC) $(OBJECTS) -lm -o $(BINDIR)/$(EXECUTABLE)
+	$(CC) $(LDFLAGS) $(OBJECTS) -lm -o $(BINDIR)/$(EXECUTABLE)
 
 lib: $(LIBOBJECTS)
 	rm -f $(LIB_A)