add autoyast waiting after install
Updated the docs about getting started

tested on openSUSE-12.1 (mrakoplas)
POD docs for functions used in tests.
Makefile rules to build HTML out of POD.

It is crude and needs polishing. Not integrated with the rest of the
makefile.
FIXME disabling parts of the makefile broken by some earlier refactoring