blob: 46491ac9c198a91aca761a767ad9bf167fcba10e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
<?xml version="1.0"?>
<!--
SPDX-FileCopyrightText: Copyright The SCons Foundation (https://scons.org)
SPDX-License-Identifier: MIT
SPDX-FileType: DOCUMENTATION
This file is processed by the bin/SConsDoc.py module.
-->
<!DOCTYPE sconsdoc [
<!ENTITY % version SYSTEM "../version.xml">
%version;
<!ENTITY % scons SYSTEM "../scons.mod">
%scons;
<!ENTITY % builders-mod SYSTEM "../generated/builders.mod">
%builders-mod;
<!ENTITY % functions-mod SYSTEM "../generated/functions.mod">
%functions-mod;
<!ENTITY % tools-mod SYSTEM "../generated/tools.mod">
%tools-mod;
<!ENTITY % variables-mod SYSTEM "../generated/variables.mod">
%variables-mod;
]>
<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 http://www.scons.org/dbxsd/v1.0/scons.xsd">
<bookinfo>
<title>SCons &buildversion;</title>
<subtitle>User Guide</subtitle>
<corpauthor>The SCons Development Team</corpauthor>
<pubdate>Released: Sun, 02 Mar 2025 18:13:57 -0700</pubdate>
<copyright>
<year>2004 - 2025</year>
<holder>The SCons Foundation</holder>
</copyright>
<releaseinfo>Version &buildversion;</releaseinfo>
<mediaobject role="cover"><imageobject><imagedata fileref="cover.jpg" format="JPG"/></imageobject></mediaobject>
</bookinfo>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="preface.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="build-install.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="simple.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="less-simple.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="libraries.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="nodes.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="depends.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="environments.xml"/>
<chapter id="chap-manip-options">
<title>Automatically Putting Command-line Options into their Construction Variables</title>
<!-- TODO: combine this into a chapter document.
This intro paragraph should describe at a high-level
what these things do. People are likely to use the intro as a
(brief) overview of *what* these functions do to decide if this
chapter is where they should read in more detail. -->
<para>
This chapter describes the &MergeFlags;, &ParseFlags;, and &ParseConfig;
methods of a &consenv;, as well as the <parameter>parse_flags</parameter>
keyword argument to methods that construct environments.
</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="mergeflags.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="parse_flags_arg.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="parseflags.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="parseconfig.xml"/>
</chapter>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="output.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="command-line.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="install.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="factories.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="file-removal.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="hierarchy.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="separate.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="repositories.xml"/>
<!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="builders-built-in.xml"/> -->
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="builders-writing.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="builders-commands.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="add-method.xml"/>
<!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="actions.xml"/> -->
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="scanners.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="sconf.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="caching.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="alias.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="java.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="gettext.xml"/>
<!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="run.xml"/> -->
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="misc.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="external.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="troubleshoot.xml"/>
<!-- Appendix below here -->
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="variables.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="builders.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="tools.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="functions.xml"/>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="tasks.xml"/>
<!-- These sections are only sekeletons: -->
<!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="python.xml"/> -->
<!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="example.xml"/> -->
<!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="make.xml"/> -->
<!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="ant.xml"/> -->
</book>
|
