Re: Building docs

Russel Winder <[email protected]> Fri, 21 Apr 2017 11:10:58 +0100

Newsgroups	gmane.comp.programming.tools.scons.devel
Message-ID	<[email protected]>

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:[email protected]
41 Buckmaster Road    m: +44 7770 465 077   xmpp: [email protected]
London SW11 1EN, UK   w: www.russel.org.uk  skype: russel_winder

_______________________________________________
Scons-dev mailing list
[email protected]
https://pairlist2.pair.net/mailman/listinfo/scons-dev

signature.asc (application/pgp-signature, 833 B)