Anonymous avatar Anonymous committed 35150bb

Add an outline for a User's Guide.

Comments (0)

Files changed (22)

     		'html'	=> 'scons.html',
 		'text'	=> 1,
 	},
+    'user' => {
+    		'html'	=> 'book1.html',
+	},
 );
 
 # Find internal dependencies in .sgml files:
 
 <!--
 
-  Methods and functions.  This includes both functions from both
+  Methods and functions.  This includes 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 Cache "<function>Cache</function>">
 <!ENTITY Clean "<function>Clean</function>">
+<!ENTITY Clone "<function>Clone</function>">
 <!ENTITY Command "<function>Command</function>">
 <!ENTITY Copy "<function>Copy</function>">
 <!ENTITY Default "<function>Default</function>">
+<!ENTITY DefaultRules "<function>DefaultRules</function>">
+<!ENTITY Depends "<function>Depends</function>">
 <!ENTITY Environment "<function>Environment</function>">
 <!ENTITY Export "<function>Export</function>">
 <!ENTITY Help "<function>Help</function>">
+<!ENTITY Ignore "<function>Ignore</function>">
+<!ENTITY Install "<function>Install</function>">
+<!ENTITY InstallAs "<function>InstallAs</function>">
 <!ENTITY Link "<function>Link</function>">
 <!ENTITY Local "<function>Local</function>">
+<!ENTITY Module "<function>Module</function>">
+<!ENTITY Objects "<function>Objects</function>">
 <!ENTITY Precious "<function>Precious</function>">
 <!ENTITY Repository "<function>Repository</function>">
+<!ENTITY RuleSet "<function>RuleSet</function>">
+<!ENTITY Salt "<function>Salt</function>">
+<!ENTITY SourceSignature "<function>SourceSignature</function>">
 <!ENTITY Task "<function>Task</function>">
 
 
 
 <!--
 
+  Environment variables.
+
+-->
+
+<!ENTITY SCONSFLAGS "<varname>SCONSFLAGS</varname>">
+
+
+
+<!--
+
   Builder and Scanner objects.
 
 -->

doc/user/.aeignore

+*,D
+.*.swp
+.consign

doc/user/builders.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+ <para>
+
+   X
+
+ </para>
+
+ <section>
+ <title>Builders That Execute External Commands</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>Builders That Execute Python Functions</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>

doc/user/caching.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+ <para>
+
+   X
+
+ </para>
+
+ <section>
+ <title>The &Cache; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>

doc/user/cons.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+ <para>
+
+   X
+
+ </para>
+
+ <section>
+ <title>X</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>

doc/user/depends.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+ <para>
+
+   X
+
+ </para>
+
+ <section>
+ <title>MD5 Signatures</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>Time Stamps</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &Depends; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &Ignore; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &Salt; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &SourceSignature; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>

doc/user/environments.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+ <para>
+
+   X
+
+ </para>
+
+ <section>
+ <title>The &Environment; Constructor</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &Clone; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &Copy; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>

doc/user/errors.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+ <para>
+
+   X
+
+ </para>
+
+ <section>
+ <title>X</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>

doc/user/example.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+ <para>
+
+   X
+
+ </para>
+
+ <section>
+ <title>X</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>

doc/user/hierarchy.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+ <para>
+
+   X
+
+ </para>
+
+ <section>
+ <title>&SConscript; Files</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>X</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>

doc/user/main.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+
+<!doctype book PUBLIC "-//OASIS//DTD DocBook V4.1//EN"
+[
+
+    <!ENTITY % version SYSTEM "../version.sgml">
+    %version;
+
+    <!ENTITY % scons SYSTEM "../scons.mod">
+    %scons;
+
+    <!ENTITY preface SYSTEM "preface.sgml">
+    <!ENTITY simple SYSTEM "simple.sgml">
+    <!ENTITY environments SYSTEM "environments.sgml">
+    <!ENTITY depends SYSTEM "depends.sgml">
+    <!ENTITY more SYSTEM "more.sgml">
+    <!ENTITY hierarchy SYSTEM "hierarchy.sgml">
+    <!ENTITY variants SYSTEM "variants.sgml">
+    <!ENTITY builders SYSTEM "builders.sgml">
+    <!ENTITY scanners SYSTEM "scanners.sgml">
+    <!ENTITY repositories SYSTEM "repositories.sgml">
+    <!ENTITY caching SYSTEM "caching.sgml">
+    <!ENTITY run SYSTEM "run.sgml">
+    <!ENTITY troubleshoot SYSTEM "troubleshoot.sgml">
+    <!ENTITY reference SYSTEM "reference.sgml">
+    <!ENTITY errors SYSTEM "errors.sgml">
+    <!ENTITY example SYSTEM "example.sgml">
+    <!ENTITY make SYSTEM "make.sgml">
+    <!ENTITY cons SYSTEM "cons.sgml">
+
+]>
+
+<book>
+  <bookinfo>
+    <title>SCons User Guide &build_version;</title>
+
+    <author>
+      <firstname>Steven</firstname>
+      <surname>Knight</surname>
+    </author>
+
+    <edition>Revision &build_revision; (&build_date;)</edition>
+
+    <pubdate>2001</pubdate>
+
+    <copyright>
+      <year>2001</year>
+      <holder>Steven Knight</holder>
+    </copyright>
+
+    <legalnotice>
+      &copyright;
+    </legalnotice>
+
+    <releaseinfo>version &build_version;</releaseinfo>
+
+  </bookinfo>
+
+  <chapter id="chap-preface">
+    <title>Preface</title>
+    &preface;
+  </chapter>
+
+  <chapter id="chap-simple">
+    <title>Simple Builds</title>
+    &simple;
+  </chapter>
+
+  <chapter id="chap-environments">
+    <title>Construction Environments</title>
+    &environments;
+  </chapter>
+
+  <chapter id="chap-depends">
+    <title>Dependencies</title>
+    &depends;
+  </chapter>
+
+  <chapter id="chap-more">
+    <title>More Things to Do With Builds</title>
+    &more;
+  </chapter>
+
+  <chapter id="chap-hierarchical">
+    <title>Hierarchial Builds</title>
+    &hierarchy;
+  </chapter>
+
+  <chapter id="chap-variant">
+    <title>Variant Builds</title>
+    &variants;
+  </chapter>
+
+  <chapter id="chap-builders">
+    <title>Writing Builders</title>
+    &builders;
+  </chapter>
+
+  <chapter id="chap-scanners">
+    <title>Writing Scanners</title>
+    &scanners;
+  </chapter>
+
+  <chapter id="chap-repositories">
+    <title>Building From Code Repositories</title>
+    &repositories;
+  </chapter>
+
+  <chapter id="chap-caching">
+    <title>Caching Built Files</title>
+    &caching;
+  </chapter>
+
+  <chapter id="chap-run">
+    <title>How to Run &SCons;</title>
+    &run;
+  </chapter>
+
+  <chapter id="chap-troubleshooting">
+    <title>Troubleshooting</title>
+    &troubleshoot;
+  </chapter>
+
+  <appendix id="app-quick">
+    <title>Quick Reference</title>
+    &reference;
+  </appendix>
+
+  <appendix id="app-errors">
+    <title>Errors Generated by &SCons;</title>
+    &errors;
+  </appendix>
+
+  <appendix id="app-example">
+    <title>Complex &SCons; Example</title>
+    &example;
+  </appendix>
+
+  <appendix id="app-make">
+    <title>Converting From Make</title>
+    &make;
+  </appendix>
+
+  <appendix id="app-cons">
+    <title>Converting From Cons</title>
+    &cons;
+  </appendix>
+
+</book>

doc/user/make.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+ <para>
+
+   X
+
+ </para>
+
+ <section>
+ <title>X</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>

doc/user/more.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+ <para>
+
+   X
+
+ </para>
+
+ <section>
+ <title>The &InstallAs; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &Precious; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &Command; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &Objects; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &Program; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &Library; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &Module; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &RuleSet; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &DefaultRules; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>

doc/user/preface.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+ <para>
+
+   X
+
+ </para>
+
+ <section>
+ <title>Why &SCons;?</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>History</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>Conventions</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>Acknowledgements</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>Contact</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>

doc/user/reference.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+ <para>
+
+   X
+
+ </para>
+
+ <section>
+ <title>Command-Line Options</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>Default Builders</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>X</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>

doc/user/repositories.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+ <para>
+
+   X
+
+ </para>
+
+ <section>
+ <title>The &Repository; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>X</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>

doc/user/run.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+ <para>
+
+   X
+
+ </para>
+
+ <section>
+ <title>Command-line Target Aliases</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>Selective Builds</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>Build Pruning</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>Overriding Construction Variables</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &SCONSFLAGS; Environment Variable</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>

doc/user/scanners.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+ <para>
+
+   X
+
+ </para>
+
+ <section>
+ <title>X</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>

doc/user/simple.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+ <para>
+
+   X
+
+ </para>
+
+ <section>
+ <title>The &SConstruct; File</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &Program; Builder</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &Library; Builder</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &Install; Builder</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>Running &SCons;</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &Default; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
+
+ <section>
+ <title>The &Help; Method</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>

doc/user/troubleshoot.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+ <para>
+
+   X
+
+ </para>
+
+ <section>
+ <title>X</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>

doc/user/variants.sgml

+<!--
+
+  Copyright 2001 Steven Knight
+
+-->
+ <para>
+
+   X
+
+ </para>
+
+ <section>
+ <title>X</title>
+
+   <para>
+
+   X
+
+   </para>
+
+ </section>
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.