executables should be, errr, executable!
added docbook generation and error handling bits