Getting closer to release...

Troy Melhase · Troy Melhase · commit c4f83ea17b2d · 2012-02-05T17:00:57.000-05:00
diff --git a/doc/customization.md b/doc/customization.md
@@ -8,6 +8,23 @@ line. See the [usage][] page for instructions on specifying additional configs.
 The default configuration module is `java2python.config.default`.  Refer to [the source
 of that module][1] for its values and additional descriptions.
 
+### Usage
+
+To change the behavior of some or all of the config items, create a Python
+file, define the items you want, and specify that file when invoking `j2py`.
+
+For example, if you would like to change the comment prefix to `##`, you might
+do this:
+
+    $ echo "indentPrefix = '##'" >> myconfig.py
+
+Then run the script:
+
+    $ j2py SomeJavaSource.java -c myconfig.py 
+
+The config files are Python modules, so you can use the full power of Python
+when writing your configurations.
+
 ### A Note About Some of the Names:  Prologue, Base, Head, and Epilogue
 
 When a config point has `Prologue` in its name, it means that the item will be
@@ -31,38 +48,40 @@ be responsible for generating code after the body of the item.  The only
 recognized epilogue config point is `moduleEpilogueHandlers`, which generates a
 main script stanza if necessary.
 
+
+
 ### Customization Points
 
-* indentPrefix
-* commentPrefix
-* expressionVariableNamingHandler
+#### <a name="indentPrefix"></a>indentPrefix
+#### <a name="commentPrefix"></a>commentPrefix
+#### <a name="expressionVariableNamingHandler"></a>expressionVariableNamingHandler
 
-* modulePrologueHandlers
-* moduleEpilogueHandlers
-* moduleOutputHandlers
-* modulePackageDeclarationHandler
-* moduleImportDeclarationHandler
-* moduleOutputSubs
+#### <a name="modulePrologueHandlers"></a>modulePrologueHandlers
+#### <a name="moduleEpilogueHandlers"></a>moduleEpilogueHandlers
+#### <a name="moduleOutputHandlers"></a>moduleOutputHandlers
+#### <a name="modulePackageDeclarationHandler"></a>modulePackageDeclarationHandler
+#### <a name="moduleImportDeclarationHandler"></a>moduleImportDeclarationHandler
+#### <a name="moduleOutputSubs"></a>moduleOutputSubs
 
 
-* classHeadHandlers
-* classBaseHandlers
-* classPostWalkHandlers
+#### <a name="classHeadHandlers"></a>classHeadHandlers
+#### <a name="classBaseHandlers"></a>classBaseHandlers
+#### <a name="classPostWalkHandlers"></a>classPostWalkHandlers
 
-* interfaceBaseHandlers
-* interfaceHeadHandlers
+#### <a name="interfaceBaseHandlers"></a>interfaceBaseHandlers
+#### <a name="interfaceHeadHandlers"></a>interfaceHeadHandlers
 
-* enumHeadHandlers
-* enumValueHandler
+#### <a name="enumHeadHandlers"></a>enumHeadHandlers
+#### <a name="enumValueHandler"></a>enumValueHandler
 
 
-* methodParamHandlers
-* methodLockFunctionName
-* methodHeadHandlers
-* methodPrologueHandlers
+#### <a name="methodParamHandlers"></a>methodParamHandlers
+#### <a name="methodLockFunctionName"></a>methodLockFunctionName
+#### <a name="methodHeadHandlers"></a>methodHeadHandlers
+#### <a name="methodPrologueHandlers"></a>methodPrologueHandlers
 
-* astTransforms
-* typeSubs
+#### <a name="astTransforms"></a>astTransforms
+#### <a name="typeSubs"></a>typeSubs
 
 
 [usage]: https://github.com/natural/java2python/tree/master/doc/usage.md
diff --git a/doc/intro.md b/doc/intro.md
@@ -95,10 +95,11 @@ explanation and enumeration see the [features][] page.
 
 ### Why Bother?
 
-I bothered to write this because I needed a Java package to run on the CPython
-interpreter.  I got tired of porting by hand, so I wrote this instead.  And
+I bothered to write this because [I needed a Java package][1] to run on the CPython
+interpreter.  I got tired of porting by hand so I wrote this instead.  And
 it's an interesting problem (kind of).
 
 
 [ANTLR]: http://www.antlr.org
 [features]: https://github.com/natural/java2python/tree/master/doc/features.md
+[1]:  http://roundrockriver.wordpress.com/2007/02/15/automated-translation-of-java-to-python/
