odd DocBook/Yelp errors

[Brian Burger]

OK, I sat down this afternoon to do some major cleaning up of the
Desktop Guide, esp. the Common Tasks section... and almost right away
I ran into a very strange docbook/Yelp error.

I started to edit the Video section of common-tasks.xml, and got the
first section to this:

<sect1 id="video">
                <title>Video</title>
                        <para>Many video formats can be played in
Ubuntu using free codecs found in the repositories. This
                includes formats such as MPEG and other common video
formats. To install free codec support see <xref linkend="codecs"/>.
                        </para>
                        <para>To play movies, Ubuntu comes with the
<application>Totem</application> movie player which looks and
functions similar to Windows Media Player. Some features of
                <application>Totem</application> include custom
playlists, DVD playback and more.
                You can start <application>Totem</application> by clicking:
                                <menuchoice>
                                        <guimenu>Applications</guimenu>
                                        <guisubmenu>Sound &
Video</guisubmenu>
                                        <guimenuitem>Totem Movie
Player</guimenuitem>
                                </menuchoice> from the desktop menu system.
                        </para>
                <sect2 id="dvdplayback" xreflabel="DVD playback">
                        <title>DVD Playback</title>
                                <para>Currently there is no legal way
to play DVDs on Linux using free packages. To enable DVD playback,
read DVD-video at <ulink
url="&restricted-formats;">&restricted-formats;</ulink>
                                </para>
                </sect2>

... which looks, to me, like good XML and nearly identical in
structure to existing areas of common-tasks.xml. However, running it
thru Yelp got me a bunch of errors:

brian at warbard:~/ubuntu-doc$ yelp ubuntu/desktopguide/C/desktopguide.xml
I/O warning : failed to load external entity
"/home/brian/.gnome2/yelp-bookmarks .xbel"

(yelp:32107): Gtk-CRITICAL **: gtk_stock_lookup: assertion `stock_id
!= NULL' fa iled
/home/brian/ubuntu-doc/ubuntu/desktopguide/C/common-tasks.xml:240:
parser error : Opening and ending tag mismatch: sect1 line 91 and
qandaset
                </qandaset>
                           ^
/home/brian/ubuntu-doc/ubuntu/desktopguide/C/common-tasks.xml:241:
parser error : Opening and ending tag mismatch: chapter line 15 and
sect1
           </sect1>
                   ^
/home/brian/ubuntu-doc/ubuntu/desktopguide/C/common-tasks.xml:242:
parser error : Extra content at the end of the document
                <sect1 id="codecs-and-dvds" status="writing">
                ^
/home/brian/ubuntu-doc/ubuntu/desktopguide/C/desktopguide.xml:22:
element includ e: XInclude error : could not load
/home/brian/ubuntu-doc/ubuntu/desktopguide/C/ common-tasks.xml, and no
fallback was found
Unmatched element: include
No cross reference formatter found for legalnotice elements
runtime error: file
/usr/share/xml/gnome/xslt/docbook/html/db2html-inline.xsl li ne 97
element attribute
xsl:attribute : node already has children
brian at warbard:~/ubuntu-doc$

There are a couple of very odd things about these error messages. For
starters, "<sect1 id="codecs-and-dvds" status="writing">" doesn't
exist anywhere, it's "<sect2 id="codecs-and-etc...>", so I'm not sure
what Yelp is talking about.

There are also no unmatched <qandaset> or </qandaset> tags that I can
see in the small part that I edited.

The final oddity is that with these changes, Yelp now refuses to load
common-tasks.xml at all - you can see that from the error reports
above - so Yelp has no listing at all for Common Tasks once launched.

What the heck is going on here, when this edit is nearly identical to
the Codecs edit I did last night, which worked flawlessly?

Brian/Madpilot