Fixes #4 by enhancing documentation (#15)

Author: reinhapa

README.adoc

@@ -1,4 +1,4 @@
-= OpenJDK proposals
+= OpenJDK split package scanner
 Patrick Reinhart <https://github.com/reinhapa[@reinhapa]>
 :project-full-path: reinhapa/jsplitpkgscan
 :github-branch: master
@@ -8,7 +8,14 @@ Patrick Reinhart <https://github.com/reinhapa[@reinhapa]>
 image:https://img.shields.io/badge/license-GPL2+CPE-blue.svg["GNU General Public License, version 2,
 with the Classpath Exception", link="https://github.com/{project-full-path}/blob/{github-branch}/LICENSE"]
 
-This project contains a proposal for a split package scanner tool http://openjdk.java.net[OpenJDK].
+This project contains a proposal for http://openjdk.java.net[OpenJDK] split package scanner addition.
+
+The diving force starting this tool was the lack of tooling to prepare existing class path based modules
+for later migration to modules. For split packages with the current JDK, they will be shown by the `jdeps`
+tool as of today, but not class path based modules so far.
+
+The `jsplitpgkscan` utility will search for split packages within all given `.jar` files and the modules
+known to the JDK itself and report them.
 
 == Build and run
 To build the tool you need to have a actual _JDK_ build (OpenJDK or Oracle) that you can get from 
@@ -29,13 +36,20 @@ java -p build/libs -m jsplitpkg
 ----
 
 == Create DOT graphic
-To get a PNG graphic for any .DOT file output you could use:
+To get a PNG graphic for any .DOT file output for directed graphs you could use:
 
 [source, bash]
 ----
 dot -Tpng summary.dot -O -Gratio=0.5
 ----
 
+If your experience problems due undirected graphs you could also use this command:
+ 
+[source, bash]
+----
+twopi -Tpng summary.dot -O -Gratio=0.5 -Goverlap=false
+----
+
 == Contribute
 Contributions are always welcome.