Re: [docbook] An <appendix> that contains only a <glossary> is not valid

Subject: Re: [docbook] An <appendix> that contains only a <glossary> is not valid (db5_rc7)

Following excerpt is not valid (unfinished element):

<?xml version="1.0" encoding="UTF-8"?>
<appendix xmlns="http://docbook.org/ns/docbook "
              version="5.0"
              xml:id="glossary"
              xreflabel="Glossary">

<title>Glossary</title>

<glossary></glossary>

</appendix>

While this one is valid:

<?xml version="1.0" encoding="UTF-8"?>
<appendix xmlns="http://docbook.org/ns/docbook "
              version="5.0"
              xml:id="glossary"
              xreflabel="Glossary">

<title>Glossary</title>

<glossary></glossary>
<para></para>

</appendix>

Bug?

Morning Francesco

I think it's because a glossary can be used at the same level (in the document 'hierarchy') as an appendix. If it's inside an appendix the schema requires something more to be there. If it's the only thing inside your glossary then perhaps you don't need the appendix element.

That's purely opinion of course but it's what we tell our data converters to do.

cheers

nic

Thanks,
Francesco

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-help@lists.oasis-open.org

docbook message