grim/gplate

Properly generate the documentation (at least: 100% symbol coverage).

I hate to flatten history like this, as this represented by 37 commits
in my local repository. However, I could _not_ get the result to
merge for some reason that I didn't have the time to figure out, so I
flattened it down to a single patch against upstream, and fixed the
resulting diff, and this is that commit.

In a nutshell, this commit:

- gets rid of the SGML template files, as the content that they had
was moved to source code files so that the documentation is closer
to the code, and also because the SGML templates were blocking some
already existing doc-comments in the source code.

- Gets rid of the gplate-sections.txt file, as gtk-doc builds it for
us.

- Gets rid of the gplate.types file. It is generated from scanning
the source code, and adjusted by sed to eliminate things that
gtk-doc won't be able to runtime introspect since they're not
currently "there".

- Hooks the doc/gplates directory into the build system (just
barely). The real work is not even done by CMake, as I couldn't
figure out how to get it to do what I wanted, which leads to...

- The documentation is _actually_ built by doc/gplate/build-docs.sh,
which contains hardcoded values that I could not figure out how to
get CMake to expose certain things. This means that the build
system doesn't actually know jack about the documentation (and this
also means that the documentation won't be installed as part of the
"make install" target, either). (BUT, the documentation is
available and BUILDS!)

While this commit makes things better than they were before the
commit, I would not call this commit overly polished. I fully expect
the shell script to be replaced by something done in/with/via CMake
directly, I just don't know how to do it that way.
Version 0.0.3 ??/??/????:
* Added an iterator to GPlateObjectVariable
* Added code coverage support
* Added gplate_template_render_until which will render until a type/contents
pair is matched.
* Added gplate_template_jump_to which will skip all tags until a
type/contents pair is matched.
* Updated gplate-for-function.c to use gplate_template_render_until, and
gplate_template_jump_to.
* Moved from autotools to cmake
Version 0.0.2 09/20/2008:
* Fixed the bug where a default tag that didn't start with a word rendered
an empty string
* Added a working directory property to GPlateTemplate that is currently
only used for GPlateIncludeFunction. This allows includes to work
correctly without needing to hard code the path in the including template.
* Changed the GPlateIterator->next to return a GPlateVariable rather than
a char *.
* Added GPlateFileVariable that exports the results of stat(filename) as a
GPlateCollection.
* Added GPlateDirectoryVariable that is a collection of GPlateFileVariables.
Version 0.0.1 03/01/2008:
* Initial release. Only basic templating and for loops work, I'm sure there
are plenty of bugs to be found.