On Mon, Nov 26, 2012 at 07:50:13PM +0100, Kacper Perschke wrote:
> On 20 October 2012 11:13, Osamu Aoki <os...@debian.org> wrote:
> > On Thu, Oct 18, 2012 at 10:54:04PM +0900, Hideki Yamane wrote:
> > > [...]
> > I guess you used --skip-validation since it did not build.
> 
> After getting main-guide source by 'apt-get source main-guide'
> I did try to validate 'xmlstarlet val -e maint-guide.en.dbk'
> and got warnings about unexpanded keys '&docversion;' and '&docisodate;'

I see.  

I never used xmlstarlet but it needs to be configured to understand 
entity references:

<!ENTITY % common   SYSTEM "common.ent">   %common;
<!ENTITY % version  SYSTEM "version.ent">  %version;

You need to do "make version.ent" first.

> I suppose that they are expanded while compiling
> but don't know how to reproduce it in my system yet.

Why not just build source simply by "debuild".

It will call debian/rules after few actions.

debian/rules script will eventually run "make" via following:

override_dh_auto_build:
        dh_auto_build -- html txt pdf "MANUAL=$(MANUAL)" \
                "LANGS_EN=$(LANGS_EN)" "LANGS_PO=$(LANGS_PO)" "LANGS=$(LANGS)" \
                "LANGS_NOPDF=$(LANGS_NOPDF)"

This is essentially the same as 
        make html txt pdf "MANUAL=$(MANUAL)" \
                "LANGS_EN=$(LANGS_EN)" "LANGS_PO=$(LANGS_PO)" "LANGS=$(LANGS)" \
                "LANGS_NOPDF=$(LANGS_NOPDF)"

> > But it is better to validate.  I am fixing wrong markups first :-)

It is almost as good to do "make html" :-) 

If you insist on validating, "make validate" should work ...oops except
for English.  For english, fix script or run it manually.

$ xmllint --nonet --noout --postvalid --xinclude maint-guide.en.dbk
maint-guide.en.dbk:38: element author: validity error : Element author content 
does not follow the DTD, expecting ((personname | (honorific | firstname | 
surname | lineage | othername | affiliation | authorblurb | contrib)+) , 
(personblurb | email | address)*), got (personname email contrib )
maint-guide.en.dbk:38: element personname: validity error : Element personname 
content does not follow the DTD, expecting (honorific | firstname | surname | 
lineage | othername)+, got (CDATA)
maint-guide.en.dbk:39: element author: validity error : Element author content 
does not follow the DTD, expecting ((personname | (honorific | firstname | 
surname | lineage | othername | affiliation | authorblurb | contrib)+) , 
(personblurb | email | address)*), got (personname email contrib )
maint-guide.en.dbk:39: element personname: validity error : Element personname 
content does not follow the DTD, expecting (honorific | firstname | surname | 
lineage | othername)+, got (CDATA)
maint-guide.en.dbk:610: element listitem: validity error : Element listitem 
content does not follow the DTD, expecting (calloutlist | glosslist | 
bibliolist | itemizedlist | orderedlist | segmentedlist | simplelist | 
variablelist | caution | important | note | tip | warning | literallayout | 
programlisting | programlistingco | screen | screenco | screenshot | synopsis | 
cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | 
constructorsynopsis | destructorsynopsis | methodsynopsis | formalpara | para | 
simpara | address | blockquote | graphic | graphicco | mediaobject | 
mediaobjectco | informalequation | informalexample | informalfigure | 
informaltable | equation | example | figure | table | msgset | procedure | 
sidebar | qandaset | task | anchor | bridgehead | remark | highlights | 
abstract | authorblurb | epigraph | indexterm | beginpage)+, got (literal)
maint-guide.en.dbk:621: element listitem: validity error : Element listitem 
content does not follow the DTD, expecting (calloutlist | glosslist | 
bibliolist | itemizedlist | orderedlist | segmentedlist | simplelist | 
variablelist | caution | important | note | tip | warning | literallayout | 
programlisting | programlistingco | screen | screenco | screenshot | synopsis | 
cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | 
constructorsynopsis | destructorsynopsis | methodsynopsis | formalpara | para | 
simpara | address | blockquote | graphic | graphicco | mediaobject | 
mediaobjectco | informalequation | informalexample | informalfigure | 
informaltable | equation | example | figure | table | msgset | procedure | 
sidebar | qandaset | task | anchor | bridgehead | remark | highlights | 
abstract | authorblurb | epigraph | indexterm | beginpage)+, got (literal)
maint-guide.en.dbk:622: element listitem: validity error : Element listitem 
content does not follow the DTD, expecting (calloutlist | glosslist | 
bibliolist | itemizedlist | orderedlist | segmentedlist | simplelist | 
variablelist | caution | important | note | tip | warning | literallayout | 
programlisting | programlistingco | screen | screenco | screenshot | synopsis | 
cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | 
constructorsynopsis | destructorsynopsis | methodsynopsis | formalpara | para | 
simpara | address | blockquote | graphic | graphicco | mediaobject | 
mediaobjectco | informalequation | informalexample | informalfigure | 
informaltable | equation | example | figure | table | msgset | procedure | 
sidebar | qandaset | task | anchor | bridgehead | remark | highlights | 
abstract | authorblurb | epigraph | indexterm | beginpage)+, got (literal 
footnote)
maint-guide.en.dbk:626: element listitem: validity error : Element listitem 
content does not follow the DTD, expecting (calloutlist | glosslist | 
bibliolist | itemizedlist | orderedlist | segmentedlist | simplelist | 
variablelist | caution | important | note | tip | warning | literallayout | 
programlisting | programlistingco | screen | screenco | screenshot | synopsis | 
cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | 
constructorsynopsis | destructorsynopsis | methodsynopsis | formalpara | para | 
simpara | address | blockquote | graphic | graphicco | mediaobject | 
mediaobjectco | informalequation | informalexample | informalfigure | 
informaltable | equation | example | figure | table | msgset | procedure | 
sidebar | qandaset | task | anchor | bridgehead | remark | highlights | 
abstract | authorblurb | epigraph | indexterm | beginpage)+, got (literal)
maint-guide.en.dbk:634: element listitem: validity error : Element listitem 
content does not follow the DTD, expecting (calloutlist | glosslist | 
bibliolist | itemizedlist | orderedlist | segmentedlist | simplelist | 
variablelist | caution | important | note | tip | warning | literallayout | 
programlisting | programlistingco | screen | screenco | screenshot | synopsis | 
cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | 
constructorsynopsis | destructorsynopsis | methodsynopsis | formalpara | para | 
simpara | address | blockquote | graphic | graphicco | mediaobject | 
mediaobjectco | informalequation | informalexample | informalfigure | 
informaltable | equation | example | figure | table | msgset | procedure | 
sidebar | qandaset | task | anchor | bridgehead | remark | highlights | 
abstract | authorblurb | epigraph | indexterm | beginpage)+, got (literal)
maint-guide.en.dbk:671: element listitem: validity error : Element listitem 
content does not follow the DTD, expecting (calloutlist | glosslist | 
bibliolist | itemizedlist | orderedlist | segmentedlist | simplelist | 
variablelist | caution | important | note | tip | warning | literallayout | 
programlisting | programlistingco | screen | screenco | screenshot | synopsis | 
cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | 
constructorsynopsis | destructorsynopsis | methodsynopsis | formalpara | para | 
simpara | address | blockquote | graphic | graphicco | mediaobject | 
mediaobjectco | informalequation | informalexample | informalfigure | 
informaltable | equation | example | figure | table | msgset | procedure | 
sidebar | qandaset | task | anchor | bridgehead | remark | highlights | 
abstract | authorblurb | epigraph | indexterm | beginpage)+, got (literal)
maint-guide.en.dbk:672: element listitem: validity error : Element listitem 
content does not follow the DTD, expecting (calloutlist | glosslist | 
bibliolist | itemizedlist | orderedlist | segmentedlist | simplelist | 
variablelist | caution | important | note | tip | warning | literallayout | 
programlisting | programlistingco | screen | screenco | screenshot | synopsis | 
cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | 
constructorsynopsis | destructorsynopsis | methodsynopsis | formalpara | para | 
simpara | address | blockquote | graphic | graphicco | mediaobject | 
mediaobjectco | informalequation | informalexample | informalfigure | 
informaltable | equation | example | figure | table | msgset | procedure | 
sidebar | qandaset | task | anchor | bridgehead | remark | highlights | 
abstract | authorblurb | epigraph | indexterm | beginpage)+, got (literal)
maint-guide.en.dbk:680: element listitem: validity error : Element listitem 
content does not follow the DTD, expecting (calloutlist | glosslist | 
bibliolist | itemizedlist | orderedlist | segmentedlist | simplelist | 
variablelist | caution | important | note | tip | warning | literallayout | 
programlisting | programlistingco | screen | screenco | screenshot | synopsis | 
cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis | 
constructorsynopsis | destructorsynopsis | methodsynopsis | formalpara | para | 
simpara | address | blockquote | graphic | graphicco | mediaobject | 
mediaobjectco | informalequation | informalexample | informalfigure | 
informaltable | equation | example | figure | table | msgset | procedure | 
sidebar | qandaset | task | anchor | bridgehead | remark | highlights | 
abstract | authorblurb | epigraph | indexterm | beginpage)+, got (literal)
Document maint-guide.en.dbk does not validate


Hmmm... somethng to think about :-)

> Of course. I do agree.
> 
> KAcper


-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org

Reply via email to