[SR-Dev] Auto-generated Docbook Documentation

Jan Janak jan at iptel.org
Thu May 14 03:44:21 CEST 2009


Hello,

Automatically generated HTML documentation from docbook documents stored in
the git repository is available at

http://sip-router.org/docbook/sip-router/branch/master/

This is all the docbook documentation that we currently have in the
repository, including the documents under doc, modules, modules_k, modules_s,
and lib subdirectories.

The HTML documentation is updated automatically upon changes in the git
repository. The script processes all directories that contain a Makefile with
the string "docbook_dir" in it. If you add a new directory with docbook
documentation anywhere in the git repository then add a Makefile in the
directory that can be used to build the documentation and your documentation
will be automatically converted to HTML and uploaded to the server.

We do not have fancy stuff like module lists or documentation index yet. Also
the CSS stylesheets need some changes to produce better-looking HTML pages and
images are missing if they were included in a docbook document.

We can address that later.

  Jan.



More information about the sr-dev mailing list