[libvirt] Question about html file in docs

[Daniel Veillard]

On Wed, Aug 13, 2008 at 05:51:25AM -0400, Daniel Veillard wrote:
> On Wed, Aug 13, 2008 at 04:37:27PM +0900, Atsushi SAKAI wrote:
> > Hi, Daniel
> > 
> > If I run the make on libvirt,
> > cvs diff outputs large diffs on html.
> > This is because the difference of html and html.in is large.

  We investigated a bit with Chris Lalancette who is seeing the same problem

>   What kind of diff do you get ? The html output should only
> be dependant on the html.in and the .xsl stylesheets

  Well apparently the XSL output is post-processed by xmlling --valid --format
which then introduce a dependancy on the XHTML1 DTDs . If you don't have them
installed locally you will get validation error messages when building
in docs and the output will diverge.

  The simplest solution for you is probably to make sure you have XHTML1
DTDs installed in your local XML catalog, which on RHEL/Fedora is as simple
as having the package xhtml1-dtds installed on your machine(s).

> > I think it should be fixed.
> 
>  One should see changes in .html only if the .in and .xsl changed
> so:
>   1/ you should not have any rebuild done on your CVS checkout
>      unless you have timestamp problems on the checkout box

  That is still a problem, I see some files being rebuilt on a fresh checkout
there is some timestamp problems in CVS state I guess.

>   2/ if it were to be rebuilt it really should be the same as
>      on the checkout

  unfortunately no because xsltproc output is post processed,

Daniel

-- 
Red Hat Virtualization group http://redhat.com/virtualization/
Daniel Veillard      | virtualization library  http://libvirt.org/
veillard at redhat.com  | libxml GNOME XML XSLT toolkit  http://xmlsoft.org/
http://veillard.com/ | Rpmfind RPM search engine  http://rpmfind.net/