[Scons-dev] User Guide generation questions
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
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