[Scons-dev] Building docs

[Russel Winder]

On Fri, 2017-04-21 at 11:21 +0200, Dirk Baechle wrote:
> Hi Russel, 
> 
> this is where the DocBook DSL saves the day for you. It should be
> sufficient to validate your / all docs by using the provided script
> in 'bin' of the source tree. 
> Please follow the instructions/links in the DeveloperGuide intro
> (wiki) if you need more infos about this. 
> 

I still prefer Asciidoctor, but I can cope with DocBook/XML. Just. :-)

I see that docs-validate.py is not set up as a command, perhaps it
could be as it is in the bin directory. Also it assumes you start the
process from the project root directory, I wonder if it might be better
to get the Python script to sort out paths?

My three tool .xml files all pass the  docs-validate.py  test (using
Python 3 obviously :-) so I shall commit them and add them to the pull
request Bill is mentoring me on.

-- 
Russel.
=============================================================================
Dr Russel Winder      t: +44 20 7585 2200   voip: sip:russel.winder at ekiga.net
41 Buckmaster Road    m: +44 7770 465 077   xmpp: russel at winder.org.uk
London SW11 1EN, UK   w: www.russel.org.uk  skype: russel_winder
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: This is a digitally signed message part
URL: <https://pairlist2.pair.net/pipermail/scons-dev/attachments/20170421/18d850f6/attachment-0001.pgp>