Red Hat Bugzilla – Bug 596354
guestfish.1.html and guestfs.3.html declared "XHTML 1.0 Strict" but are not in fact well-formed XML
Last modified: 2012-11-30 10:12:52 EST
Description of problem:
Using xmllint to validate these two files gives the
errors which I will attach.
Version-Release number of selected component (if applicable):
Steps to Reproduce:
1. xmllint --valid /usr/share/doc/libguestfs-devel-1.3.16/guestfs.3.html > /dev/null
2. xmllint --valid /usr/share/doc/guestfish-1.3.16/guestfish.1.html > /dev/null
Should be strict XHTML.
Created attachment 416913 [details]
Validation errors in guestfish.1.html
Created attachment 416915 [details]
Validation errors in guestfs.3.html
Since this commit we are no longer claiming that the HTML
files are Strict. (In fact, the Perl class doesn't even
bother adding a DOCTYPE at all).
Author: Richard W.M. Jones <firstname.lastname@example.org>
Date: Mon Jul 16 19:41:39 2012 +0100
Replace podwrapper shell script with custom Perl script.
This uses Pod::Simple so it properly parses the input POD and can
generate proper custom output as required specifically by libguestfs.
One immediate benefit is that links between and within manual pages
now work mostly correctly.