Tweaks.

Troy Melhase · Troy Melhase · commit 0a79dbd57378 · 2012-02-05T18:49:47.000-05:00
diff --git a/doc/readme.md b/doc/readme.md
@@ -15,10 +15,12 @@ The [Translation Details][] page documents how the package translates Java
 syntax to Python.
 
 #### Usage
+
 The [Usage][] page explains how to run the `j2py` script.
 
 
 #### Customization
+
 The [Customization][] doc describes how to customize translation behavior.
 
 
diff --git a/doc/translation.md b/doc/translation.md
@@ -1,10 +1,5 @@
 ## Translation Features
 
-The java2python package can translate any syntactically valid Java source code
-file.  The generated Python code is not guaranteed to run, nor is guaranteed to
-be syntactically valid Python.  However, java2python works well many cases, and
-in some of those, it creates perfectly usable and workable Python code.
-
 
 ### General Approach
 
diff --git a/readme.md b/readme.md
@@ -3,21 +3,21 @@
 Simple but effective tool to translate Java source code into Python.
 
 
+The java2python package can translate any syntactically valid Java source code
+file.  The generated Python code is not guaranteed to run, nor is guaranteed to
+be syntactically valid Python.  However, java2python works well many cases, and
+in some of those, it creates perfectly usable and workable Python code.
+
 There are [lots of docs][], [plenty of tests][], and [many options][] for
 controlling code generation.
 
-I'm in the process of finalizing the documentation and packaging a release.
-That will be release 0.5 when it's done.  If you're looking for old releases,
-check the [downloads][] link above.
+If you're looking for old releases, check the [downloads][] link above.
 
-Here's a very simple example.  First we show the file:
+Here's a very simple example:
 
 ```bash
 $ cat HelloWorld.java
 ```
-
-And we get this:
-
 ```java    
 // This is the HelloWorld class with a single method.
 class HelloWorld {
@@ -33,24 +33,17 @@ Next we run our program:
 ```bash
 $ j2py HelloWorld.java
 ```
-
-And we get this:
-
 ```python
 #!/usr/bin/env python
-""" generated source for module HelloWorld
+""" generated source for module HelloWorld """
 
-"""
 #  This is the HelloWorld class with a single method.
 class HelloWorld(object):
-    """ generated source for class HelloWorld
+    """ generated source for class HelloWorld """
 
-    """
     @classmethod
     def main(cls, args):
-        """ generated source for method main
-
-        """
+        """ generated source for method main """
         print "Hello, world."
 
 if __name__ == '__main__':
