Descriptions are created by RDoc (in ri_generator) and written out in serialized form into the documentation tree. ri then reads these to generate the documentation
We handle the parsing of options, and subsequently as a singleton object to be queried for option values