[libvirt] [PATCH v2 0/7] documentation improvements

Claudio Bley cbley at av-test.de
Tue Jan 29 15:05:31 UTC 2013


Hi.

Version 2 of this series incorporates the following changes:

- patch #1 fail if documentation is missing
- reword subject line of patch #3 as suggessted by Eric

Incidently, patch #1 truthfully makes the build fail because
of missing documentation. Go figure :)

I'll submit a single patch with a fix shortly.

Claudio Bley (7):
  docs: abort when missing return or argument documention
  docs: only generate function argument info for args with a
    description
  docs: use div, not table, for notices on opaque types
  docs: process code blocks similar to markdown
  docs: add class "description" to div's containing descriptions
  docs: define style of code blocks inside descriptions
  docs: syntax highlight code blocks using SHJS

 docs/apibuild.py      |   15 +++-
 docs/libvirt.css      |    8 ++
 docs/newapi.xsl       |  209 +++++++++++++++++++++++++++++--------------------
 docs/page.xsl         |    5 +-
 docs/sh_c.min.js      |    1 +
 docs/sh_emacs.min.css |    1 +
 docs/sh_main.min.js   |    4 +
 7 files changed, 157 insertions(+), 86 deletions(-)
 create mode 100644 docs/sh_c.min.js
 create mode 100644 docs/sh_emacs.min.css
 create mode 100644 docs/sh_main.min.js

-- 
1.7.9.5




More information about the libvir-list mailing list