[doc] Add anchors for Maven and Ant sections to index
[doc] Add tip
[doc] Another anchor, this time for dependency handling
[doc] Finish section "Example RPM Project"
[tests] Fix tests for add_maven_depmap (injecting pom.properties)
Revert creating parent directories for pom.properties

Since we can't properly create directories let's just leave it up as default
permissions. At least it will not cause problems for various tooling

Fixes: rhbz#1031769
[test] pythonpath should not be overriden by eggs
[doc] Add short javadoc section
[doc] minor fixes in introduction.txt
[doc] fix broken link
[doc] more comments in minimal specfile
[doc] build system identification
[doc] note about Java packages(namespaces)
[doc] reordering sections in intro for packagers
[doc] fix typos, missing quotes, etc.

Please note that RPM macros with braces that are not enclosed in
backticks cause whole line of text to be entirely skipped.
[doc] split directory layout into two sections

Separate directories that are important for regular packagers from the
rest.
[doc] use Java example for minimal spec

Use example HelloWorld project from Introduction for packagers as the
project being packaged in example spec file in order to have something
more realistic with actual sources and build.
[doc] more information about spec file contents
[doc] Add few words about JARs

More detailed explanation of JAR purpose and contents.
Moved "compiling project" section a bit up.