1- ## Introduction
1+ # Introduction
22
3- ### What it Does
3+ ## What it Does
44
55java2python reads the Java source files you give it and produces somewhat
66roughly equivalent Python source code. It tries to make the same decisions
77you would if you were porting the code manually. It can perform the
88translation faster and more accurately than you could (usually).
99
10- ### Where It's Useful
10+ ## Where It's Useful
1111
1212java2python can help in two situations. First, if you're doing a one-time
1313port of a Java project to Python, it can save you a lot of time and
@@ -18,19 +18,19 @@ Python port and keep the port up to date, you'll find that java2python can
1818help tremendously. The per-project and per-file configuration system
1919helps out a lot in this area.
2020
21- ### Where It's Not
21+ ## Where It's Not
2222
2323Where java2python is not useful is also important. It won't be useful to you
2424if you expect your newly translated Python code to run correctly the first
2525time. The platforms are too different and this tool is too limited for that
2626to happen. Also, you won't find java2python very useful if you expect to
2727convert Java sources at runtime. I suppose you could try, but I wouldn't.
2828
29- ### How it Works
29+ ## How it Works
3030
3131java2python first converts the source code you give it into an abstract syntax
3232tree. (That's a lie, really. java2python doesn't do this step,
33- [ ANTLR] ( www.antlr.org ) does this step, and ANTLR is a whole lot bigger and
33+ [ ANTLR] ( http:// www.antlr.org) does this step, and ANTLR is a whole lot bigger and
3434cooler than java2python could ever be. Obviously, really smart people worked
3535on ANTLR and only one fairly dim one worked on java2python).
3636
@@ -94,7 +94,7 @@ See what java2python did there? It tried to do what you would do. For
9494further explanation and enumeration see the [ features] ( features.md ) page.
9595
9696
97- ### Why Bother?
97+ ## Why Bother?
9898
9999I bothered to write this because I needed a Java package to run on the
100100CPython interpreter. I got tired of porting by hand, so I wrote this
0 commit comments