better docs, consistent output to stderr