Expand docs for deprecated methods to silence Javadoc warnings

src/main/java/org/sablecc/sablecc/analysis/Analysis.java

...in/java/org/sablecc/sablecc/analysis/AnalysisAdapter.java

src/main/java/org/sablecc/sablecc/parser/Parser.java

src/main/resources/org/sablecc/sablecc/analyses.txt

src/main/resources/org/sablecc/sablecc/parser.txt