[Scons-dev] User Guide generation questions

Fri Aug 29 18:12:18 EDT 2014

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
> 45.62% (99/217) src/engine/SCons/Tool/aixcc.xml
> 46.08% (100/217) src/engine/SCons/Tool/f77.xml
> 46.54% (101/217) src/engine/SCons/Tool/msvs.xml
> 47.00% (102/217) src/engine/SCons/Tool/hplink.xml
> 47.47% (103/217) src/engine/SCons/Tool/dvipdf.xml
> 47.93% (104/217) src/engine/SCons/Tool/mwld.xml
> 48.39% (105/217) src/engine/SCons/Tool/gs.xml
> 48.85% (106/217) src/engine/SCons/Tool/nasm.xml
> 49.31% (107/217) src/engine/SCons/Tool/packaging/__init__.xml
> 49.77% (108/217) src/engine/SCons/Tool/docbook/__init__.xml
> 50.23% (109/217) src/engine/SCons/Script/Main.xml
> 50.69% (110/217) src/engine/SCons/Script/SConscript.xml
> 51.15% (111/217) src/engine/SCons/Scanner/__init__.xml
> 51.61% (112/217) doc/design/intro.xml
> 52.07% (113/217) doc/design/goals.xml
> 52.53% (114/217) doc/design/acks.xml
> 53.00% (115/217) doc/design/native.xml
> 53.46% (116/217) doc/design/summary.xml
> 53.92% (117/217) doc/design/issues.xml
> 54.38% (118/217) doc/design/overview.xml
> 54.84% (119/217) doc/design/engine.xml
> 55.30% (120/217) doc/design/main.xml
> 55.76% (121/217) doc/design/copyright.xml
> 56.22% (122/217) doc/design/bground.xml
> 56.68% (123/217) doc/design/install.xml
> 57.14% (124/217) doc/developer/cycle.xml
> 57.60% (125/217) doc/developer/branches.xml
> 58.06% (126/217) doc/developer/packaging.xml
> 58.53% (127/217) doc/developer/main.xml
> 58.99% (128/217) doc/developer/copyright.xml
> 59.45% (129/217) doc/developer/preface.xml
> 59.91% (130/217) doc/developer/sourcetree.xml
> 60.37% (131/217) doc/developer/testing.xml
> 60.83% (132/217) doc/developer/architecture.xml
> 61.29% (133/217) doc/man/scons.xml
> 61.75% (134/217) doc/man/sconsign.xml
> 62.21% (135/217) doc/man/scons-time.xml
> 62.67% (136/217) doc/python10/process.xml
> 63.13% (137/217) doc/python10/intro.xml
> 63.59% (138/217) doc/python10/acks.xml
> 64.06% (139/217) doc/python10/abstract.xml
> 64.52% (140/217) doc/python10/future.xml
> 64.98% (141/217) doc/python10/summary.xml
> 65.44% (142/217) doc/python10/main.xml
> 65.90% (143/217) doc/python10/copyright.xml
> 66.36% (144/217) doc/python10/design.xml
> 66.82% (145/217) doc/python10/install.xml
> 67.28% (146/217) doc/reference/Alias.xml
> 67.74% (147/217) doc/reference/PostScript.xml
> 68.20% (148/217) doc/reference/StaticLibrary.xml
> 68.66% (149/217) doc/reference/CFile.xml
> 69.12% (150/217) doc/reference/Object.xml
> 69.59% (151/217) doc/reference/Program.xml
> 70.05% (152/217) doc/reference/PDF.xml
> 70.51% (153/217) doc/reference/InstallAs.xml
> 70.97% (154/217) doc/reference/Command.xml
> 71.43% (155/217) doc/reference/main.xml
> 71.89% (156/217) doc/reference/errors.xml
> 72.35% (157/217) doc/reference/SharedLibrary.xml
> 72.81% (158/217) doc/reference/copyright.xml
> 73.27% (159/217) doc/reference/CXXFile.xml
> 73.73% (160/217) doc/reference/preface.xml
> 74.19% (161/217) doc/reference/RES.xml
> 74.65% (162/217) doc/reference/Library.xml
> 75.12% (163/217) doc/reference/Install.xml
> 75.58% (164/217) doc/reference/StaticObject.xml
> 76.04% (165/217) doc/reference/PCH.xml
> 76.50% (166/217) doc/reference/SharedObject.xml
> 76.96% (167/217) doc/user/sideeffect.xml
> 77.42% (168/217) doc/user/file-removal.xml
> 77.88% (169/217) doc/user/example.xml
> 78.34% (170/217) doc/user/build-install.xml
> 78.80% (171/217) doc/user/misc.xml
> 79.26% (172/217) doc/user/add-method.xml
> 79.72% (173/217) doc/user/parseflags.xml
> 80.18% (174/217) doc/user/functions.xml
> 80.65% (175/217) doc/user/mergeflags.xml
> 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}refentry, {
> http://www.scons.org/dbxsd/v1.0}section.class, {
> http://www.scons.org/dbxsd/v1.0}section, {
> http://www.scons.org/dbxsd/v1.0}toc, {http://www.scons.org/dbxsd/v1.0}lot,
> {http://www.scons.org/dbxsd/v1.0}index, {
> http://www.scons.org/dbxsd/v1.0}glossary, {
> http://www.scons.org/dbxsd/v1.0}bibliography, {
> http://www.scons.org/dbxsd/v1.0}simplesect )., line 4116
> 81.57% (177/217) doc/user/sconf.xml
> 82.03% (178/217) doc/user/builders-built-in.xml
> 82.49% (179/217) doc/user/troubleshoot.xml
> 82.95% (180/217) doc/user/actions.xml
> 83.41% (181/217) doc/user/factories.xml
> 83.87% (182/217) doc/user/tasks.xml
> 84.33% (183/217) doc/user/repositories.xml
> 84.79% (184/217) doc/user/depends.xml
> 85.25% (185/217) doc/user/ant.xml
> 85.71% (186/217) doc/user/main.xml
> 86.18% (187/217) doc/user/errors.xml
> 86.64% (188/217) doc/user/simple.xml
> 87.10% (189/217) doc/user/hierarchy.xml
> 87.56% (190/217) doc/user/caching.xml
> 88.02% (191/217) doc/user/tools.xml
> 88.48% (192/217) doc/user/copyright.xml
> 88.94% (193/217) doc/user/variables.xml
> 89.40% (194/217) doc/user/java.xml
> 89.86% (195/217) doc/user/run.xml
> 90.32% (196/217) doc/user/nodes.xml
> 90.78% (197/217) doc/user/make.xml
> 91.24% (198/217) doc/user/gettext.xml
> 91.71% (199/217) doc/user/python.xml
> 92.17% (200/217) doc/user/scanners.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}refentry, {
> http://www.scons.org/dbxsd/v1.0}section.class, {
> http://www.scons.org/dbxsd/v1.0}section, {
> http://www.scons.org/dbxsd/v1.0}toc, {http://www.scons.org/dbxsd/v1.0}lot,
> {http://www.scons.org/dbxsd/v1.0}index, {
> http://www.scons.org/dbxsd/v1.0}glossary, {
> http://www.scons.org/dbxsd/v1.0}bibliography, {
> http://www.scons.org/dbxsd/v1.0}simplesect )., line 4367
> 93.09% (202/217) doc/user/preface.xml
> 93.55% (203/217) doc/user/install.xml
> 94.01% (204/217) doc/user/sourcecode.xml
> 94.47% (205/217) doc/user/builders.xml
> 94.93% (206/217) doc/user/command-line.xml
> 95.39% (207/217) doc/user/parseconfig.xml
> 95.85% (208/217) doc/user/output.xml
> 96.31% (209/217) doc/user/separate.xml
> 96.77% (210/217) doc/user/builders-writing.xml
> 97.24% (211/217) doc/user/scons_xi.xml
> 97.70% (212/217) doc/user/libraries.xml
> 98.16% (213/217) doc/user/environments.xml
> 98.62% (214/217) doc/user/less-simple.xml
> 99.08% (215/217) doc/user/builders-commands.xml
> 99.54% (216/217) doc/user/alias.xml
> 100.00% (217/217) doc/user/variants.xml
> Validation failed! Please correct the errors above and try again.
>

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

V/R,
William
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://two.pairlist.net/pipermail/scons-dev/attachments/20140829/21253dfa/attachment.html>