Improve the JavaDoc of Toadlet.showAsToadlet()

I have had to figure out what this function is for at least two times, so it is time to improve the JavaDoc.