Skip to content

Commit e7ef1f3

Browse files
author
Troy Melhase
committed
Twiddles.
1 parent eceb94e commit e7ef1f3

File tree

2 files changed

+8
-8
lines changed

2 files changed

+8
-8
lines changed

doc/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
## java2python Documentation Index
1+
# java2python Documentation Index
22

33

44
Please read the [introduction](./intro.md) for information about what the

doc/intro.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
1-
## Introduction
1+
# Introduction
22

3-
### What it Does
3+
## What it Does
44

55
java2python reads the Java source files you give it and produces somewhat
66
roughly equivalent Python source code. It tries to make the same decisions
77
you would if you were porting the code manually. It can perform the
88
translation faster and more accurately than you could (usually).
99

10-
### Where It's Useful
10+
## Where It's Useful
1111

1212
java2python can help in two situations. First, if you're doing a one-time
1313
port 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
1818
help tremendously. The per-project and per-file configuration system
1919
helps out a lot in this area.
2020

21-
### Where It's Not
21+
## Where It's Not
2222

2323
Where java2python is not useful is also important. It won't be useful to you
2424
if you expect your newly translated Python code to run correctly the first
2525
time. The platforms are too different and this tool is too limited for that
2626
to happen. Also, you won't find java2python very useful if you expect to
2727
convert Java sources at runtime. I suppose you could try, but I wouldn't.
2828

29-
### How it Works
29+
## How it Works
3030

3131
java2python first converts the source code you give it into an abstract syntax
3232
tree. (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
3434
cooler than java2python could ever be. Obviously, really smart people worked
3535
on 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
9494
further explanation and enumeration see the [features](features.md) page.
9595

9696

97-
### Why Bother?
97+
## Why Bother?
9898

9999
I bothered to write this because I needed a Java package to run on the
100100
CPython interpreter. I got tired of porting by hand, so I wrote this

0 commit comments

Comments
 (0)