cmake bugfix and improved component action docs

fixed some issue in cmake to let it find the DOCBOOK_ROOT environment variable.
slight improvements in the action definition documentation.