From 140d836e9cd54fb67b969fd82ef7ed19ba574d40 Mon Sep 17 00:00:00 2001
From: Luca Falavigna <dktrkranz@debian.org>
Date: Sat, 26 Apr 2014 15:11:58 +0200
Subject: Imported Upstream version 2.3.1

---
 doc/design/main.xml | 116 +++++++++++-----------------------------------------
 1 file changed, 23 insertions(+), 93 deletions(-)

(limited to 'doc/design/main.xml')

diff --git a/doc/design/main.xml b/doc/design/main.xml
index e991b36..fb6469b 100644
--- a/doc/design/main.xml
+++ b/doc/design/main.xml
@@ -2,7 +2,7 @@
 
 <!--
 
-  Copyright (c) 2001, 2002, 2003 Steven Knight
+  Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014 The SCons Foundation
 
   Permission is hereby granted, free of charge, to any person obtaining
   a copy of this software and associated documentation files (the
@@ -25,53 +25,28 @@
 
 -->
 
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
-"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
-[
+<!DOCTYPE sconsdoc [
 
-    <!--
-    We haven't updated the design document in ages.
-    Rather than fool people into thinking that it's
-    actually up-to-date and reflects the current design,
-    hard-code the version from back when we last updated it.
     <!ENTITY % version SYSTEM "../version.xml">
     %version;
-    -->
-    <!ENTITY builddate "2001/12/13 20:55:46">
-    <!ENTITY buildversion "0.91">
-    <!ENTITY buildrevision "0.01.D177">
-
-    <!--
-    Also freeze the scons.mod DTD extensions
-    to what they were way back when.
+
     <!ENTITY % scons SYSTEM "../scons.mod">
-    -->
-    <!ENTITY % scons SYSTEM "scons.mod">
     %scons;
 
-    <!ENTITY acks SYSTEM "acks.xml">
-    <!ENTITY bground SYSTEM "bground.xml">
-    <!ENTITY copyright SYSTEM "copyright.xml">
-    <!ENTITY engine SYSTEM "engine.xml">
-    <!ENTITY goals SYSTEM "goals.xml">
-    <!ENTITY install SYSTEM "install.xml">
-    <!ENTITY intro SYSTEM "intro.xml">
-    <!ENTITY issues SYSTEM "issues.xml">
-    <!ENTITY native SYSTEM "native.xml">
-    <!ENTITY overview SYSTEM "overview.xml">
-
 ]>
 
-<book>
+<book xmlns="http://www.scons.org/dbxsd/v1.0"
+      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+      xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">
   <bookinfo>
-    <title>SCons Design version &buildversion;</title>
-
+    <title>SCons &buildversion;</title>
+    <subtitle>Design</subtitle>
     <author>
       <firstname>Steven</firstname>
       <surname>Knight</surname>
     </author>
 
-    <edition>Revision &buildrevision; (&builddate;)</edition>
+    <corpauthor>Steven Knight</corpauthor>
 
     <pubdate>2001</pubdate>
 
@@ -80,79 +55,34 @@
       <holder>Steven Knight</holder>
     </copyright>
 
-    <legalnotice>
-      &copyright;
-    </legalnotice>
+    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="copyright.xml"/>
 
     <releaseinfo>version &buildversion;</releaseinfo>
 
   </bookinfo>
 
-  <chapter id="chap-intro">
-    <title>Introduction</title>
-    &intro;
-  </chapter>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="intro.xml"/>
 
-  <chapter id="chap-goals">
-    <title>Goals</title>
-    &goals;
-  </chapter>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="goals.xml"/>
 
-  <chapter id="chap-overview">
-    <title>Overview</title>
-    &overview;
-  </chapter>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="overview.xml"/>
 
-  <chapter id="chap-engine">
-    <title>Build Engine API</title>
-    &engine;
-  </chapter>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="engine.xml"/>
 
-  <chapter id="chap-native">
-    <title>Native Python Interface</title>
-    &native;
-  </chapter>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="native.xml"/>
 
   <!--
 
-  <chapter id="chap-install">
-    <title>Installation</title>
-    &install;
-  </chapter>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="install.xml"/>
 
   -->
 
-  <chapter id="chap-issues">
-    <title>Other Issues</title>
-    &issues;
-  </chapter>
-
-  <chapter id="chap-background">
-    <title>Background</title>
-    &bground;
-  </chapter>
-
-  <chapter id="chap-summary">
-    <title>Summary</title>
-    <para>
-
-      &SCons; offers a robust and feature-rich design for an SC-build
-      tool.  With a Build Engine based on the proven design of
-      the &Cons; utility, it offers increased simplification of the
-      user interface for unsophisticated users with the addition
-      of the "do-the-right-thing" <function>env.Make</function>
-      method, increased flexibility for sophisticated users with the
-      addition of &Builder; and &Scanner; objects, a mechanism to
-      allow tool-masters (and users) to share working construction
-      environments, and embeddability to provide reliable dependency
-      management in a variety of environments and interfaces.
-
-    </para>
-  </chapter>
-
-  <chapter id="chap-acks">
-    <title>Acknowledgements</title>
-    &acks;
-  </chapter>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="issues.xml"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="bground.xml"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="summary.xml"/>
+
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="acks.xml"/>
 
 </book>
-- 
cgit v1.2.3