xml changed file validation

[Tom Bullock]

  John,

What you say makes sense.  Thanks for answering my question.  Now for 
another.

You answer assumes I know how to generate the file gnucash-guide.xml.  I 
likely have read past it in the various documents available, but, sad to 
say, as of now I don't recognize the command, script or process that 
generates that file.

Can you point me to it?

Thanks.

Tom

On 7/24/2010 10:54 AM, John Ralls wrote:
> On Jul 24, 2010, at 3:04 PM, Frank H. Ellenberger wrote:
>
>> Am Samstag, 24. Juli 2010 um 14:30:52 schrieb Tom Bullock:
>>> In the wiki for translating the GnuCash Guide&  Help files there is the
>>> instruction to that "xml file has no syntax errors"  and it indicates
>>> using the command:  "xmllint --valid --noout  gnucash-guide.xml"
>>>
>>> This instruction assumes the reader knows the context of that command
>>> and how it is setup and works.
>> The program xmllint is part of the package libxml.
>> As usual "xmllint --help" shows you the options and "man xmllint" some
>> explainations.
>>
>>> When I google 'xmllint' I get lots of
>>> references.  Since I want to validate just my changes, I should replace
>>> 'gnucash-guide.xml' with the name of my changed module, correct?  I
>>> don't need to validate what I am not changing, correct?
>> Yes, I believe so.
>>
>> Feel free to add your experience to the wiki.
> "Validation" is an XML term meaning to ensure that the XML document is well-formed (is syntactically correct) and that it complies with the DTDs or schemas listed in its header.
>
> Gnucash-guide.xml is the only file which has an XML header (it includes the other files by declaring them as ENTITIES in the local part of the DTD, so validation *should* fail on any of the other files (no DOCTYPE header); but if xmllint is OK with that, they will pass perhaps spuriously because they have no reference to the DocBook DTD and so won't be validated.
>
> Since XML parsers are required to be completely intolerant of errors, it's important that the whole document passes validation before it's checked in; similarly, since the current document parses correctly, it is likely valid.
>
> Bottom Line: You have to validate gnucash-guide.xml.  If you're feeling defensive, run xmllint --valid before you make any changes.
>
> Regards,
> John Ralls
>