michael@0: If this is your first time building the HTML5 parser, you need to execute the
michael@0: following commands (from this directory) to bootstrap the translation:
michael@0: 
michael@0:   make sync             # fetch remote source files and licenses
michael@0:   make translate        # perform the Java-to-C++ translation from the remote 
michael@0:                         # sources
michael@0:   make named_characters # Generate tables for named character tokenization
michael@0: 
michael@0: If you make changes to the translator or the javaparser, you can rebuild by
michael@0: retyping 'make' in this directory.  If you make changes to the HTML5 Java
michael@0: implementation, you can retranslate the Java sources from the htmlparser 
michael@0: repository by retyping 'make translate' in this directory.
michael@0: 
michael@0: The makefile supports the following targets:
michael@0: 
michael@0: sync_htmlparser:
michael@0:   Retrieves the HTML parser and Java to C++ translator sources from Mozilla's 
michael@0:   htmlparser repository.
michael@0: sync_javaparser:
michael@0:   Retrieves the javaparser sources from Google Code.
michael@0: sync:
michael@0:   Runs both sync_javaparser and sync_htmlparser.
michael@0: javaparser:
michael@0:   Builds the javaparser library retrieved earlier by sync_javaparser. 
michael@0: translator:
michael@0:   Runs the javaparser target and then builds the Java to C++ translator from 
michael@0:   sources retrieved earlier by sync_htmlparser.
michael@0: libs:
michael@0:   The default target. Alias for translator
michael@0: translate:
michael@0:   Runs the translator target and then translates the HTML parser sources 
michael@0:   retrieved by sync_htmlparser copying the Java sources to ../javasrc.
michael@0: translate_from_snapshot: 
michael@0:   Runs the translator target and then translates the HTML parser sources 
michael@0:   stored in ../javasrc.
michael@0: named_characters:
michael@0:   Generates data tables for named character tokenization.
michael@0: clean_javaparser:
michael@0:   Removes the build products of the javaparser target.
michael@0: clean_htmlparser:
michael@0:   Removes the build products of the translator target.
michael@0: clean:
michael@0:   Runs both clean_javaparser and clean_htmlparser.
michael@0: 
michael@0: Ben Newman (23 September 2009)
michael@0: Henri Sivonen (21 April 2010)