summaryrefslogtreecommitdiff
path: root/src/engine/SCons/Tool/tar.xml
blob: 95e8418170256151404a08eab2a8f2ded5a6080b (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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2001 - 2019 The SCons Foundation

This file is processed by the bin/SConsDoc.py module.
See its __doc__ string for a discussion of the format.
-->

<!DOCTYPE sconsdoc [
<!ENTITY % scons SYSTEM '../../../../doc/scons.mod'>
%scons;
<!ENTITY % builders-mod SYSTEM '../../../../doc/generated/builders.mod'>
%builders-mod;
<!ENTITY % functions-mod SYSTEM '../../../../doc/generated/functions.mod'>
%functions-mod;
<!ENTITY % tools-mod SYSTEM '../../../../doc/generated/tools.mod'>
%tools-mod;
<!ENTITY % variables-mod SYSTEM '../../../../doc/generated/variables.mod'>
%variables-mod;
]>

<sconsdoc 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">

<tool name="tar">
<summary>
<para>
Sets construction variables for the &tar; archiver.
</para>
</summary>
<sets>
<item>TAR</item>
<item>TARFLAGS</item>
<item>TARCOM</item>
<item>TARSUFFIX</item>
</sets>
<uses>
<item>TARCOMSTR</item>
</uses>
</tool>

<builder name="Tar">
<summary>
<para>
Builds a tar archive of the specified files
and/or directories.
Unlike most builder methods,
the
&b-Tar;
builder method may be called multiple times
for a given target;
each additional call
adds to the list of entries
that will be built into the archive.
Any source directories will
be scanned for changes to
any on-disk files,
regardless of whether or not
&scons;
knows about them from other Builder or function calls.
</para>

<example_commands>
env.Tar('src.tar', 'src')

# Create the stuff.tar file.
env.Tar('stuff', ['subdir1', 'subdir2'])
# Also add "another" to the stuff.tar file.
env.Tar('stuff', 'another')

# Set TARFLAGS to create a gzip-filtered archive.
env = Environment(TARFLAGS = '-c -z')
env.Tar('foo.tar.gz', 'foo')

# Also set the suffix to .tgz.
env = Environment(TARFLAGS = '-c -z',
                  TARSUFFIX = '.tgz')
env.Tar('foo')
</example_commands>
</summary>
</builder>

<cvar name="TAR">
<summary>
<para>
The tar archiver.
</para>
</summary>
</cvar>

<cvar name="TARCOM">
<summary>
<para>
The command line used to call the tar archiver.
</para>
</summary>
</cvar>

<cvar name="TARCOMSTR">
<summary>
<para>
The string displayed when archiving files
using the tar archiver.
If this is not set, then &cv-link-TARCOM; (the command line) is displayed.
</para>

<example_commands>
env = Environment(TARCOMSTR = "Archiving $TARGET")
</example_commands>
</summary>
</cvar>

<cvar name="TARFLAGS">
<summary>
<para>
General options passed to the tar archiver.
</para>
</summary>
</cvar>

<cvar name="TARSUFFIX">
<summary>
<para>
The suffix used for tar file names.
</para>
</summary>
</cvar>

</sconsdoc>