Log Message:
update to 1.8
pkgsrc change: make SGML output optional, off per default, which saves
the heavyweight dependency on jade
other changes:
o Made it easier to include example code in the source code comment blocks.
  "|[ ... ]|" can be used to delineate example code (it just gets converted
  to "<informalexample><programlisting>"), and most of the \ 
text in example
  code is left as it is. The only thing that is still expanded is
  '#' to allow links to a symbol's documentation, e.g. '#GtkWidget'.
o Made the field widths wider for the HTML output, so it looks a bit nicer.
o Added a '--rebuild-sections' option to gtkdoc-scan to automatically rebuild
  the MODULE-sections.txt file. This only works if all the header files are
  organized neatly and functions don't need rearranging in the docs.
o Added a '--rebuild-types' option to gtkdoc-scan to automatically rebuild
  the MODULE.types file, so you don't need to add new types manually.
o Leave CDATA sections as they are, in the extra XML content files and within
  source code comment blocks.
o Allow the section id and #include's to be set within the "SECTION:" \ 
comment
  block, using "@Section_ID:xxx" and "@Include:".
o Added "--default-includes" option to specify the default #include's (for
  people who are using --rebuild-sections and so can't specify it in
  MODULE-sections.txt).
o Added a '--query-child-properties' argument to help document child
  properties of arbitrary GObjects (used by things like canvas widgets).
o Fixed documentation of signals of interfaces.