[libvirt] [PATCH] Fix several formatting mistakes in doc

Sat Apr 2 05:45:46 UTC 2011

On Fri, Apr 01, 2011 at 12:04:04PM -0600, Eric Blake wrote:
> On 03/31/2011 07:27 PM, Daniel Veillard wrote:
> >> $ SGML_CATALOG_FILES='/etc/xml/catalog'   /usr/bin/xmllint --catalogs
> >> --nonet --format --valid formatcaps.html.in >/dev/null
> >> formatcaps.html.in:1: validity error : Validation failed: no DTD found !
> >> <html>
> >>      ^
> > 
> >   just drop --valid from the command line, xmllint usually doesn't
> > check validity. But IMHO it's simpler to just drop the --html flag from
> > xsltproc as suggestedon previous mail
> 
> Almost, it definitely caught some more bugs.  But it's not perfect; now
> I'm getting:
> 
> Generating csharp.html.tmp
> csharp.html.in:21: parser error : Entity 'nbsp' not defined
>     <p> </p>
>              ^
> ...
> csharp.html.in:125: parser error : Entity 'iacute' not defined
>       based upon the previous work of Jaromír &#x010C;ervenka.
>                                                    ^

  Ah, that normal, it's an error but not a fatal error, the nbsp
entity is available from the DTD but since we didn't asked for
validation libxml2 didn't try to fetch it. Note it's an error, not
a fatal error, i.e. processing continues, as the prser can't guess
if the entity was in the (not loaded) DTD or not.

  You can add the --loaddtd to xmllint command line to ask it to
load the DTd while just checking the well-formedness of the document

> when make tries:
> 
> name=`echo csharp.html.tmp | sed -e 's/.tmp//'`; \
>   /usr/bin/xsltproc --stringparam pagename $name --nonet \
>     ../docs/site.xsl csharp.html.in > csharp.html.tmp
> 
> How do I make xsltproc recognize html entities without using --html?

  xsltproc will load the DTD, so there should be no problem there.

Daniel

-- 
Daniel Veillard      | libxml Gnome XML XSLT toolkit  http://xmlsoft.org/
daniel at veillard.com  | Rpmfind RPM search engine http://rpmfind.net/
http://veillard.com/ | virtualization library  http://libvirt.org/