1 .\" Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 The SCons Foundation
3 .\" Permission is hereby granted, free of charge, to any person obtaining
4 .\" a copy of this software and associated documentation files (the
5 .\" "Software"), to deal in the Software without restriction, including
6 .\" without limitation the rights to use, copy, modify, merge, publish,
7 .\" distribute, sublicense, and/or sell copies of the Software, and to
8 .\" permit persons to whom the Software is furnished to do so, subject to
9 .\" the following conditions:
11 .\" The above copyright notice and this permission notice shall be included
12 .\" in all copies or substantial portions of the Software.
14 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
15 .\" KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
16 .\" WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
17 .\" NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
18 .\" LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
19 .\" OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
20 .\" WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
22 .\" doc/man/sconsign.1 3842 2008/12/20 22:59:52 scons
24 .\" ES - Example Start - indents and turns off line fill
29 .\" EE - Example End - ends indent and turns line fill back on
34 .TH SCONSIGN 1 "December 2008"
36 sconsign \- print SCons .sconsign file information
49 displays the contents of one or more
51 files specified by the user.
55 dumps the entire contents of the
57 Each entry is printed in the following format:
59 file: signature timestamp length
60 implicit_dependency_1: signature timestamp length
61 implicit_dependency_2: signature timestamp length
62 action_signature [action string]
66 in place of any missing timestamp, bsig, or csig
69 or any of its dependencies.
70 If the entry has no implicit dependencies,
72 the lines are simply omitted.
78 arguments that end with a
82 more than one directory
89 argument that does not end in
91 is assumed to be a traditional
93 file containing the signature entries
94 for a single directory.
96 may be specified using the
104 Various options control what information is printed
109 Prints the build action information
110 for all entries or the specified entries.
114 Prints the content signature (csig) information
115 for all entries or the specified entries.
118 -d DIRECTORY, --dir=DIRECTORY
119 When the signatures are being
127 prints information about
129 for entries in the specified
133 -e ENTRY, --entry=ENTRY
134 Prints information about only the specified
136 Multiple -e options may be used,
137 in which case information about each
139 is printed in the order in which the
140 options are specified on the command line.
143 -f FORMAT, --format=FORMAT
144 The file(s) to be printed
156 used for an individual
158 file in each directory).
162 Prints a help message and exits.
166 Prints the list of cached implicit dependencies
167 for all entries or the the specified entries.
171 Prints a pretty-printed representation
172 of the raw Python dictionary that holds
173 build information about individual entry
174 (both the entry itself or its implicit dependencies).
175 An entry's build action is still printed in its usual format.
179 Prints timestamps in a human-readable string,
180 enclosed in single quotes.
184 Prints the timestamp information
185 for all entries or the specified entries.
189 Prints labels identifying each field being printed.
194 Specifies the directory that contains the SCons Python module directory
195 (e.g. /home/aroach/scons-src-0.01/src/engine).
208 Steven Knight <knight at baldmt dot com>