Add design documentation.

1 files changed, 129 insertions, 0 deletions

diff --git a/doc/scons.mod b/doc/scons.mod
new file mode 100644
index 00000000..902149bf
--- /dev/null
+++ b/doc/scons.mod
@@ -0,0 +1,129 @@
+<!--
+
+  An SCons-specific DTD module, for use with SCons DocBook
+  documentation, that contains names, phrases, acronyms, etc. used
+  throughout the SCons documentation.
+
+-->
+
+
+
+<!ENTITY copyright SYSTEM "copyright.sgml">
+
+
+
+<!--
+
+  Other applications that we reference.
+
+-->
+
+<!ENTITY Autoconf "<application>Autoconf</application>">
+<!ENTITY Cons "<application>Cons</application>">
+<!ENTITY Make "<application>Make</application>">
+<!ENTITY Makepp "<application>Make++</application>">
+<!ENTITY SCons "<application>SCons</application>">
+
+
+
+<!--
+
+  Classes.
+
+-->
+
+<!ENTITY Builder "<classname>Builder</classname>">
+<!ENTITY Job "<classname>Job</classname>">
+<!ENTITY Node "<classname>Node</classname>">
+<!ENTITY Scanner "<classname>Scanner</classname>">
+<!ENTITY Signature "<classname>Signature</classname>">
+
+
+
+<!--
+
+  File names.
+
+-->
+
+<!ENTITY Makefile "<filename>Makefile</filename>">
+<!ENTITY SConscript "<filename>SConscript</filename>">
+<!ENTITY SConstruct "<filename>SConstruct</filename>">
+<!ENTITY sconsign "<filename>.consign</filename>">
+
+
+
+<!--
+
+  Methods and functions.  This includes both functions from both
+  the Build Engine and the Native Python Interface.
+
+-->
+
+<!ENTITY Alias "<function>Alias</function>">
+<!ENTITY Aliases "<function>Aliases</function>">
+<!ENTITY Build "<function>Build</function>">
+<!ENTITY Clean "<function>Clean</function>">
+<!ENTITY Command "<function>Command</function>">
+<!ENTITY Copy "<function>Copy</function>">
+<!ENTITY Default "<function>Default</function>">
+<!ENTITY Environment "<function>Environment</function>">
+<!ENTITY Export "<function>Export</function>">
+<!ENTITY Help "<function>Help</function>">
+<!ENTITY Link "<function>Link</function>">
+<!ENTITY Local "<function>Local</function>">
+<!ENTITY Precious "<function>Precious</function>">
+<!ENTITY Repository "<function>Repository</function>">
+<!ENTITY Task "<function>Task</function>">
+
+
+
+<!--
+
+  Construction variables.
+
+-->
+
+<!ENTITY BUILDERMAP "<varname>BUILDERMAP</varname>">
+<!ENTITY BUILDERS "<varname>BUILDERMAP</varname>">
+<!ENTITY SCANNERMAP "<varname>SCANNERMAP</varname>">
+<!ENTITY SCANNERS "<varname>SCANNERMAP</varname>">
+
+
+
+<!--
+
+  Builder and Scanner objects.
+
+-->
+
+<!ENTITY Object "<function>Object</function>">
+<!ENTITY Library "<function>Library</function>">
+<!ENTITY SharedLibrary "<function>SharedLibrary</function>">
+<!ENTITY Program "<function>Program</function>">
+<!ENTITY MakeBuilder "<function>Make</function>">
+
+
+
+<!--
+
+  Terms.  Define both singular and plural forms in various
+  case-sensitive combinations for use in titles, in-line, etc.
+
+-->
+
+<!ENTITY ConsEnv "<literal>Construction Environment</literal>">
+<!ENTITY ConsEnvs "<literal>Construction Environments</literal>">
+<!ENTITY Consenv "<literal>Construction environment</literal>">
+<!ENTITY Consenvs "<literal>Construction environments</literal>">
+<!ENTITY consenv "<literal>construction environment</literal>">
+<!ENTITY consenvs "<literal>construction environments</literal>">
+
+<!ENTITY ConsVar "<literal>Construction Variable</literal>">
+<!ENTITY ConsVars "<literal>Construction Variables</literal>">
+<!ENTITY Consvar "<literal>Construction variable</literal>">
+<!ENTITY Consvars "<literal>Construction variables</literal>">
+<!ENTITY consvar "<literal>construction variable</literal>">
+<!ENTITY consvars "<literal>construction variables</literal>">
+
+<!ENTITY Dictionary "<literal>Dictionary</literal>">