[getdns-api] New version incorporating the first comments

[Paul Hoffman]

Greetings again. I have updated <http://www.vpnc.org/getdns-api/> to include many of the comments received so far. Please keep them coming! The major changes are:

- The "name" argument in getdns() now allows escaping in "master file format".

- Changed a bunch of wording in the OPT extension to clarify the meaning of the payload size and what happens if there is a difference between the extension and the context.

- Added an extension for class type.

- Used better macro names for stub and recursive resolution.

- Fixed the rdata structures for TXT and URI RRtypes.

- Reorganized the sections to push context changing after the examples that are relevant to most application developers. It seems that DNS folks get all excited about the context, but that's unimportant to the main target audience.

I still want to think more about how to handle TSIG/SIG(0), particularly for advanced applications that know that their recursive upstream validates. I still also want to think more about an extension for allowing U-labels in "name". I'll get back to the list on these.

--Paul Hoffman