[Libguestfs] [PATCH 15/16] gobject: Improve the structure of guestfs-sections.txt
Richard W.M. Jones
rjones at redhat.com
Tue Mar 27 15:20:58 UTC 2012
On Tue, Mar 27, 2012 at 04:00:57PM +0100, Matthew Booth wrote:
> The generator doesn't make a very good job of guestfs-sections.txt. This change
> manually fixes its title, and moves various sections which shouldn't be in the
> documentation into a Private subsection.
>
> This change requires removing the --rebuild-sections command line option from
> gtkdoc-scan. This means that any future apis will have to be manually added to
> guestfs-sections.txt if they are to appear in the gtk-doc output.
Sorry, but no. I took a strong stance against *any* manually hackery
and over time that stance has proven to be a good one. Imagine we'd
done this with other bindings -- that would by now have negated all
the good work we did with the generator.
Please explain why the generator cannot get this right, but a human can.
Is there some missing information we need in the generator?
Rich.
--
Richard Jones, Virtualization Group, Red Hat http://people.redhat.com/~rjones
virt-top is 'top' for virtual machines. Tiny program with many
powerful monitoring features, net stats, disk stats, logging, etc.
http://et.redhat.com/~rjones/virt-top
More information about the Libguestfs
mailing list