hdf5doc

I added text to further explain how to write the first sentence 
of a Description. I put in their own sections the text that describes 
more specifically how to write a motivation and how to write 
a deprecated function. I changed the instruction statement for 
writing a Purpose to more specifically say how to write the statement. 

Tested: Firefox