Apidoc fixes (regarding DocBook XML generation)

Here is some changes about generating apidocs as DocBook xml, we use that for making a PDF file. In order to produce valid XML it was necessary to adjust the xmlrpc.doc comments in SystemHandler.java a little. Apart from that there is some typos and grammar fixed also for the jsp and html verisons of the apidocs.