1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/parser/html/java/README.txt Wed Dec 31 06:09:35 2014 +0100 1.3 @@ -0,0 +1,46 @@ 1.4 +If this is your first time building the HTML5 parser, you need to execute the 1.5 +following commands (from this directory) to bootstrap the translation: 1.6 + 1.7 + make sync # fetch remote source files and licenses 1.8 + make translate # perform the Java-to-C++ translation from the remote 1.9 + # sources 1.10 + make named_characters # Generate tables for named character tokenization 1.11 + 1.12 +If you make changes to the translator or the javaparser, you can rebuild by 1.13 +retyping 'make' in this directory. If you make changes to the HTML5 Java 1.14 +implementation, you can retranslate the Java sources from the htmlparser 1.15 +repository by retyping 'make translate' in this directory. 1.16 + 1.17 +The makefile supports the following targets: 1.18 + 1.19 +sync_htmlparser: 1.20 + Retrieves the HTML parser and Java to C++ translator sources from Mozilla's 1.21 + htmlparser repository. 1.22 +sync_javaparser: 1.23 + Retrieves the javaparser sources from Google Code. 1.24 +sync: 1.25 + Runs both sync_javaparser and sync_htmlparser. 1.26 +javaparser: 1.27 + Builds the javaparser library retrieved earlier by sync_javaparser. 1.28 +translator: 1.29 + Runs the javaparser target and then builds the Java to C++ translator from 1.30 + sources retrieved earlier by sync_htmlparser. 1.31 +libs: 1.32 + The default target. Alias for translator 1.33 +translate: 1.34 + Runs the translator target and then translates the HTML parser sources 1.35 + retrieved by sync_htmlparser copying the Java sources to ../javasrc. 1.36 +translate_from_snapshot: 1.37 + Runs the translator target and then translates the HTML parser sources 1.38 + stored in ../javasrc. 1.39 +named_characters: 1.40 + Generates data tables for named character tokenization. 1.41 +clean_javaparser: 1.42 + Removes the build products of the javaparser target. 1.43 +clean_htmlparser: 1.44 + Removes the build products of the translator target. 1.45 +clean: 1.46 + Runs both clean_javaparser and clean_htmlparser. 1.47 + 1.48 +Ben Newman (23 September 2009) 1.49 +Henri Sivonen (21 April 2010)