[Scons-dev] User Guide generation questions

2014-08-29 Thread William Blevins
I am trying to make some misc updates to the User Guide, and I am having
some issues. I thought it might be a problem with a document do I tried
docs-validate and there were two errors:

python bin/docs-validate.py
 0.46% (1/217) src/engine/SCons/Defaults.xml
 0.92% (2/217) src/engine/SCons/Environment.xml
 1.38% (3/217) src/engine/SCons/Action.xml
 1.84% (4/217) src/engine/SCons/Subst.xml
 2.30% (5/217) src/engine/SCons/Platform/sunos.xml
 2.76% (6/217) src/engine/SCons/Platform/posix.xml
 3.23% (7/217) src/engine/SCons/Platform/win32.xml
 3.69% (8/217) src/engine/SCons/Platform/__init__.xml
 4.15% (9/217) src/engine/SCons/Tool/jar.xml
 4.61% (10/217) src/engine/SCons/Tool/sunc++.xml
 5.07% (11/217) src/engine/SCons/Tool/aixc++.xml
 5.53% (12/217) src/engine/SCons/Tool/tlib.xml
 5.99% (13/217) src/engine/SCons/Tool/textfile.xml
 6.45% (14/217) src/engine/SCons/Tool/ifl.xml
 6.91% (15/217) src/engine/SCons/Tool/msginit.xml
 7.37% (16/217) src/engine/SCons/Tool/swig.xml
 7.83% (17/217) src/engine/SCons/Tool/g++.xml
 8.29% (18/217) src/engine/SCons/Tool/tex.xml
 8.76% (19/217) src/engine/SCons/Tool/default.xml
 9.22% (20/217) src/engine/SCons/Tool/javac.xml
 9.68% (21/217) src/engine/SCons/Tool/ifort.xml
 10.14% (22/217) src/engine/SCons/Tool/ilink32.xml
 10.60% (23/217) src/engine/SCons/Tool/midl.xml
 11.06% (24/217) src/engine/SCons/Tool/cvf.xml
 11.52% (25/217) src/engine/SCons/Tool/ar.xml
 11.98% (26/217) src/engine/SCons/Tool/sunf95.xml
 12.44% (27/217) src/engine/SCons/Tool/tar.xml
 12.90% (28/217) src/engine/SCons/Tool/SCCS.xml
 13.36% (29/217) src/engine/SCons/Tool/sgilink.xml
 13.82% (30/217) src/engine/SCons/Tool/sunar.xml
 14.29% (31/217) src/engine/SCons/Tool/ldc.xml
 14.75% (32/217) src/engine/SCons/Tool/aixlink.xml
 15.21% (33/217) src/engine/SCons/Tool/zip.xml
 15.67% (34/217) src/engine/SCons/Tool/ilink.xml
 16.13% (35/217) src/engine/SCons/Tool/hpcc.xml
 16.59% (36/217) src/engine/SCons/Tool/intelc.xml
 17.05% (37/217) src/engine/SCons/Tool/qt.xml
 17.51% (38/217) src/engine/SCons/Tool/dvi.xml
 17.97% (39/217) src/engine/SCons/Tool/gfortran.xml
 18.43% (40/217) src/engine/SCons/Tool/rpcgen.xml
 18.89% (41/217) src/engine/SCons/Tool/mslib.xml
 19.35% (42/217) src/engine/SCons/Tool/dmd.xml
 19.82% (43/217) src/engine/SCons/Tool/latex.xml
 20.28% (44/217) src/engine/SCons/Tool/javah.xml
 20.74% (45/217) src/engine/SCons/Tool/f90.xml
 21.20% (46/217) src/engine/SCons/Tool/mwcc.xml
 21.66% (47/217) src/engine/SCons/Tool/msgmerge.xml
 22.12% (48/217) src/engine/SCons/Tool/gas.xml
 22.58% (49/217) src/engine/SCons/Tool/gcc.xml
 23.04% (50/217) src/engine/SCons/Tool/mslink.xml
 23.50% (51/217) src/engine/SCons/Tool/suncc.xml
 23.96% (52/217) src/engine/SCons/Tool/xgettext.xml
 24.42% (53/217) src/engine/SCons/Tool/cc.xml
 24.88% (54/217) src/engine/SCons/Tool/mssdk.xml
 25.35% (55/217) src/engine/SCons/Tool/m4.xml
 25.81% (56/217) src/engine/SCons/Tool/linkloc.xml
 26.27% (57/217) src/engine/SCons/Tool/gdc.xml
 26.73% (58/217) src/engine/SCons/Tool/gnulink.xml
 27.19% (59/217) src/engine/SCons/Tool/sgicc.xml
 27.65% (60/217) src/engine/SCons/Tool/sunf77.xml
 28.11% (61/217) src/engine/SCons/Tool/packaging.xml
 28.57% (62/217) src/engine/SCons/Tool/masm.xml
 29.03% (63/217) src/engine/SCons/Tool/f03.xml
 29.49% (64/217) src/engine/SCons/Tool/msgfmt.xml
 29.95% (65/217) src/engine/SCons/Tool/lex.xml
 30.41% (66/217) src/engine/SCons/Tool/pdflatex.xml
 30.88% (67/217) src/engine/SCons/Tool/sunlink.xml
 31.34% (68/217) src/engine/SCons/Tool/yacc.xml
 31.80% (69/217) src/engine/SCons/Tool/aixf77.xml
 32.26% (70/217) src/engine/SCons/Tool/icl.xml
 32.72% (71/217) src/engine/SCons/Tool/Subversion.xml
 33.18% (72/217) src/engine/SCons/Tool/386asm.xml
 33.64% (73/217) src/engine/SCons/Tool/g77.xml
 34.10% (74/217) src/engine/SCons/Tool/c++.xml
 34.56% (75/217) src/engine/SCons/Tool/gettext.xml
 35.02% (76/217) src/engine/SCons/Tool/fortran.xml
 35.48% (77/217) src/engine/SCons/Tool/RCS.xml
 35.94% (78/217) src/engine/SCons/Tool/rmic.xml
 36.41% (79/217) src/engine/SCons/Tool/f95.xml
 36.87% (80/217) src/engine/SCons/Tool/msvc.xml
 37.33% (81/217) src/engine/SCons/Tool/applelink.xml
 37.79% (82/217) src/engine/SCons/Tool/install.xml
 38.25% (83/217) src/engine/SCons/Tool/as.xml
 38.71% (84/217) src/engine/SCons/Tool/Perforce.xml
 39.17% (85/217) src/engine/SCons/Tool/link.xml
 39.63% (86/217) src/engine/SCons/Tool/pdf.xml
 40.09% (87/217) src/engine/SCons/Tool/dvips.xml
 40.55% (88/217) src/engine/SCons/Tool/bcc32.xml
 41.01% (89/217) src/engine/SCons/Tool/__init__.xml
 41.47% (90/217) src/engine/SCons/Tool/pdftex.xml
 41.94% (91/217) src/engine/SCons/Tool/sgiar.xml
 42.40% (92/217) src/engine/SCons/Tool/hpc++.xml
 42.86% (93/217) src/engine/SCons/Tool/BitKeeper.xml
 43.32% (94/217) src/engine/SCons/Tool/sunf90.xml
 43.78% (95/217) src/engine/SCons/Tool/icc.xml
 44.24% (96/217) src/engine/SCons/Tool/sgic++.xml
 44.70% (97/217) src/engine/SCons/Tool/CVS.xml
 45.16% (98/217) src/engine/SCons/Tool/mingw.xml
 

Re: [Scons-dev] User Guide generation questions

2014-08-29 Thread Dirk Bächle

On 30.08.2014 00:12, William Blevins wrote:
I am trying to make some misc updates to the User Guide, and I am 
having some issues. I thought it might be a problem with a document do 
I tried docs-validate and there were two errors:


[...]




81.11% (176/217) doc/user/scons_ex.xml
ERROR: doc/user/scons_ex.xml fails to validate:
Element 'programlisting': This element is not expected. Expected
is one of ( {http://www.scons.org/dbxsd/v1.0}refentry.class
http://www.scons.org/dbxsd/v1.0%7Drefentry.class,
{http://www.scons.org/dbxsd/v1.0}refentry
http://www.scons.org/dbxsd/v1.0%7Drefentry,
{http://www.scons.org/dbxsd/v1.0}section.class
http://www.scons.org/dbxsd/v1.0%7Dsection.class,
{http://www.scons.org/dbxsd/v1.0}section
http://www.scons.org/dbxsd/v1.0%7Dsection,
{http://www.scons.org/dbxsd/v1.0}toc
http://www.scons.org/dbxsd/v1.0%7Dtoc,
{http://www.scons.org/dbxsd/v1.0}lot
http://www.scons.org/dbxsd/v1.0%7Dlot,
{http://www.scons.org/dbxsd/v1.0}index
http://www.scons.org/dbxsd/v1.0%7Dindex,
{http://www.scons.org/dbxsd/v1.0}glossary
http://www.scons.org/dbxsd/v1.0%7Dglossary,
{http://www.scons.org/dbxsd/v1.0}bibliography
http://www.scons.org/dbxsd/v1.0%7Dbibliography,
{http://www.scons.org/dbxsd/v1.0}simplesect
http://www.scons.org/dbxsd/v1.0%7Dsimplesect )., line 4116
81.57% (177/217) doc/user/sconf.xml
[...]




92.63% (201/217) doc/user/scons_exi.xml
ERROR: doc/user/scons_exi.xml fails to validate:
Element 'programlisting': This element is not expected. Expected
is one of ( {http://www.scons.org/dbxsd/v1.0}refentry.class
http://www.scons.org/dbxsd/v1.0%7Drefentry.class,
{http://www.scons.org/dbxsd/v1.0}refentry
http://www.scons.org/dbxsd/v1.0%7Drefentry,
{http://www.scons.org/dbxsd/v1.0}section.class
http://www.scons.org/dbxsd/v1.0%7Dsection.class,
{http://www.scons.org/dbxsd/v1.0}section
http://www.scons.org/dbxsd/v1.0%7Dsection,
{http://www.scons.org/dbxsd/v1.0}toc
http://www.scons.org/dbxsd/v1.0%7Dtoc,
{http://www.scons.org/dbxsd/v1.0}lot
http://www.scons.org/dbxsd/v1.0%7Dlot,
{http://www.scons.org/dbxsd/v1.0}index
http://www.scons.org/dbxsd/v1.0%7Dindex,
{http://www.scons.org/dbxsd/v1.0}glossary
http://www.scons.org/dbxsd/v1.0%7Dglossary,
{http://www.scons.org/dbxsd/v1.0}bibliography
http://www.scons.org/dbxsd/v1.0%7Dbibliography,
{http://www.scons.org/dbxsd/v1.0}simplesect
http://www.scons.org/dbxsd/v1.0%7Dsimplesect )., line 4367
Validation failed! Please correct the errors above and try again.


Can I remove those sections? I'm not that familiar with the schema.

The failing files scons_ex.xml and scons_exi.xml are generated 
during the actual build process. Remove them by hand, or do a scons -c 
before trying to validate...


Regards,

Dirk

___
Scons-dev mailing list
Scons-dev@scons.org
http://two.pairlist.net/mailman/listinfo/scons-dev