phpwebnotes is an application to allow users to enter comments on webpages,
similar to the system that the php documentation uses (ie
http://www.php.net/manual/en/features.remote-files.php). To have
docbook-generated documentation use this system, a couple of options have to be
configured in a customization layer that will insert the php code necessary. The
attached xsl file is such a customization layer; the patch adds support to the
docs/tutorial/makefile.am to build that documentation. This way it's easy to
build both un-annotated documentation for distribution with the tarball and
annotated documentation for the website.

Websites that want to display annotated documentation will need to be hosted on
a webserver with php support and access to a mysql database.
Start with downloading phpwebnotes from http://webnotes.futureware.biz/. Untar
the release tarball to the directory where the index.html file of the tutorial
is (actually the index.php file, because the xsl will make xsltproc generate
.php files instead of .html files). (It is also possible to install phpwebnotes
somewhere else, like in the docs/ subdirectory, if you do that you'll have to
keep that location in account when reading the rest of this procedure) There is
an INSTALL file in the doc/ subdirectory that will tell you how to install
phpwebnotes further; basically, you have to make a mysql database and populate
it with the script in the sql/ directory, create a file called
'custom_config_inc.php' in the core/ directory and set the database host, name
and username/password and the directory where phpwebnotes is installed, relative
to the docroot (for example I have it set to '/html/phpwebnotes/' because my
docroot is the gtkmm2\docs\tutorial\html\ directory).

Now if you generate the annotated version of the tutorial (make html/index.php I
think) and navigate to the index.php file in your browser, you'll see that you
can enter new annotations there. You can also login (the default
username/password is 'administrator'/'root') and then you can delete and approve
annotations. If you want annotations to be approved by default (so not needing
approval basically), you can set that in the custom_config_inc.php file.

Please note that the makefile.am is untested as I don't have a make environment
on this (Windows) machine. Also I never really understood automake but I think
the patch should work. If it doesn't, the command line in it is clear and should
allow anyone who does know how automake work to easily correct any mistakes.