Update readme instructions for how to use the java html5 parser codegen makefile

This commit is contained in:
Matt A. Tobin 2020-01-16 07:43:21 -05:00 committed by Roy Tam
commit df37b6046c

View file

@ -1,7 +1,6 @@
If this is your first time building the HTML5 parser, you need to execute the
following commands (from this directory) to bootstrap the translation:
following commands (from this directory) to accomplish the translation:
make sync # fetch remote source files and licenses
make translate # perform the Java-to-C++ translation from the remote
# sources
make named_characters # Generate tables for named character tokenization
@ -13,34 +12,30 @@ repository by retyping 'make translate' in this directory.
The makefile supports the following targets:
sync_htmlparser:
Retrieves the HTML parser and Java to C++ translator sources from Mozilla's
htmlparser repository.
sync_javaparser:
Retrieves the javaparser sources from GitHub.
sync:
Runs both sync_javaparser and sync_htmlparser.
javaparser:
Builds the javaparser library retrieved earlier by sync_javaparser.
translator:
Runs the javaparser target and then builds the Java to C++ translator from
sources retrieved earlier by sync_htmlparser.
sources.
libs:
The default target. Alias for translator
translate:
Runs the translator target and then translates the HTML parser sources and
copys the parser impl java sources to ../javasrc.
translate-javasrc:
Runs the translator target and then translates the HTML parser sources
retrieved by sync_htmlparser copying the Java sources to ../javasrc.
translate_from_snapshot:
Runs the translator target and then translates the HTML parser sources
stored in ../javasrc.
named_characters:
stored in ../javasrc. (Depercated)
named-characters:
Generates data tables for named character tokenization.
clean_javaparser:
clean_-avaparser:
Removes the build products of the javaparser target.
clean_htmlparser:
clean-htmlparser:
Removes the build products of the translator target.
clean-javasrc:
Removes the javasrc snapshot code in ../javasrc
clean:
Runs both clean_javaparser and clean_htmlparser.
Runs clean-javaparser, clean-htmlparser, and clean-javasrc.
Ben Newman (23 September 2009)
Henri Sivonen (11 August 2016)
Matt A. Tobin (16 January 2020)