+* Example graphs
++ A very simple example:
+
+ [[file:example.png][file:example.resized.png]]
+
+ Graph legend:
+
+ file:legend.png
+
++ Example visualization of [[http://www2.svjatoslav.eu/gitbrowse/sixth-3d/doc/][Sixth 3D]] project: [[http://www2.svjatoslav.eu/gitbrowse/sixth-3d/doc/codeGraph/][architecture graphs]].
+
+* Usage
+Currently the only way to control JavaInspect is by using Java
+API. Simple Java based control/configuration code needs to be written
+for each project. I usually put such code into directories devoted for
+JUnit tests. Because it needs not to be compiled/embedded into final
+product or project artifact I'm just willing to visualize.
+
+Control code in general does the following:
+1. Create graph object.
+2. Java reflection/classloaders does not provide mechanism for
+ discovering all classes under given package. Therefore you need to
+ declare at least some classes to be added to the graph by:
+ + Manually adding individual classes to the graph.
+ + and/or: Let GraphViz recursively scan and parse specified
+ directories with Java source code files to discover class names.
+ + For every class added to the graph, GraphViz will recursively
+ inspect it and add all referecned classes to the graph as well.
+3. Graphs easilly get very big and complex so optionally we filter
+ important code using classname wildcards patterns based blacklist
+ and/or whitelist.
+4. Optionally we can tune some rendering parameters like:
+ + Possibility to remove orphaned classes (classes with no
+ references) from the graph.
+ + Specify target directory for generated visualization
+ files. (Default is user desktop directory)
+ + Keep intermediate GraphViz dot file for later inspection.
+5. Render graph.
+
+
+** example 1: individually picked objects