clarify behavior of %subdirs%
adjust javadoc to mark up more template path expansions