parser/html/java/README.txt@925c144e1f1f (annotated)
parser/html/java/README.txt
Fri, 16 Jan 2015 18:13:44 +0100
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Fri, 16 Jan 2015 18:13:44 +0100
- branch
- TOR_BUG_9701
- changeset 14
- 925c144e1f1f
- permissions
- -rw-r--r--
Integrate suggestion from review to improve consistency with existing code.
| michael@0 | 1 | If this is your first time building the HTML5 parser, you need to execute the |
| michael@0 | 2 | following commands (from this directory) to bootstrap the translation: |
| michael@0 | 3 | |
| michael@0 | 4 | make sync # fetch remote source files and licenses |
| michael@0 | 5 | make translate # perform the Java-to-C++ translation from the remote |
| michael@0 | 6 | # sources |
| michael@0 | 7 | make named_characters # Generate tables for named character tokenization |
| michael@0 | 8 | |
| michael@0 | 9 | If you make changes to the translator or the javaparser, you can rebuild by |
| michael@0 | 10 | retyping 'make' in this directory. If you make changes to the HTML5 Java |
| michael@0 | 11 | implementation, you can retranslate the Java sources from the htmlparser |
| michael@0 | 12 | repository by retyping 'make translate' in this directory. |
| michael@0 | 13 | |
| michael@0 | 14 | The makefile supports the following targets: |
| michael@0 | 15 | |
| michael@0 | 16 | sync_htmlparser: |
| michael@0 | 17 | Retrieves the HTML parser and Java to C++ translator sources from Mozilla's |
| michael@0 | 18 | htmlparser repository. |
| michael@0 | 19 | sync_javaparser: |
| michael@0 | 20 | Retrieves the javaparser sources from Google Code. |
| michael@0 | 21 | sync: |
| michael@0 | 22 | Runs both sync_javaparser and sync_htmlparser. |
| michael@0 | 23 | javaparser: |
| michael@0 | 24 | Builds the javaparser library retrieved earlier by sync_javaparser. |
| michael@0 | 25 | translator: |
| michael@0 | 26 | Runs the javaparser target and then builds the Java to C++ translator from |
| michael@0 | 27 | sources retrieved earlier by sync_htmlparser. |
| michael@0 | 28 | libs: |
| michael@0 | 29 | The default target. Alias for translator |
| michael@0 | 30 | translate: |
| michael@0 | 31 | Runs the translator target and then translates the HTML parser sources |
| michael@0 | 32 | retrieved by sync_htmlparser copying the Java sources to ../javasrc. |
| michael@0 | 33 | translate_from_snapshot: |
| michael@0 | 34 | Runs the translator target and then translates the HTML parser sources |
| michael@0 | 35 | stored in ../javasrc. |
| michael@0 | 36 | named_characters: |
| michael@0 | 37 | Generates data tables for named character tokenization. |
| michael@0 | 38 | clean_javaparser: |
| michael@0 | 39 | Removes the build products of the javaparser target. |
| michael@0 | 40 | clean_htmlparser: |
| michael@0 | 41 | Removes the build products of the translator target. |
| michael@0 | 42 | clean: |
| michael@0 | 43 | Runs both clean_javaparser and clean_htmlparser. |
| michael@0 | 44 | |
| michael@0 | 45 | Ben Newman (23 September 2009) |
| michael@0 | 46 | Henri Sivonen (21 April 2010) |
