From 140d836e9cd54fb67b969fd82ef7ed19ba574d40 Mon Sep 17 00:00:00 2001 From: Luca Falavigna Date: Sat, 26 Apr 2014 15:11:58 +0200 Subject: Imported Upstream version 2.3.1 --- doc/man/sconsign.xml | 267 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 267 insertions(+) create mode 100644 doc/man/sconsign.xml (limited to 'doc/man/sconsign.xml') diff --git a/doc/man/sconsign.xml b/doc/man/sconsign.xml new file mode 100644 index 0000000..7989566 --- /dev/null +++ b/doc/man/sconsign.xml @@ -0,0 +1,267 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +SCONSIGN +1 +March 2014 + + +sconsign +print SCons .sconsign file information + + + + + sconsign + options + file + ... + + + + +DESCRIPTION +The +sconsign +command +displays the contents of one or more +.sconsign +files specified by the user. + +By default, +sconsign +dumps the entire contents of the +specified file(s). +Each entry is printed in the following format: + + file: signature timestamp length + implicit_dependency_1: signature timestamp length + implicit_dependency_2: signature timestamp length + action_signature [action string] + +None +is printed +in place of any missing timestamp, bsig, or csig +values for +any entry +or any of its dependencies. +If the entry has no implicit dependencies, +or no build action, +the lines are simply omitted. + +By default, +sconsign +assumes that any +file +arguments that end with a +.dbm +suffix contains +signature entries for +more than one directory +(that is, +was specified by the +SConsignFile () +function). +Any +file +argument that does not end in +.dbm +is assumed to be a traditional +.sconsign +file containing the signature entries +for a single directory. +An explicit format +may be specified using the + +or + +options. + + + +OPTIONS +Various options control what information is printed +and the format: + + + + -a, --act, --action + +Prints the build action information +for all entries or the specified entries. + + + + + -c, --csig + +Prints the content signature (csig) information +for all entries or the specified entries. + + + + + -d DIRECTORY, --dir=DIRECTORY + +When the signatures are being +read from a +.dbm +file, or the + +or + +options are used, +prints information about +only the signatures +for entries in the specified +DIRECTORY. + + + + + -e ENTRY, --entry=ENTRY + +Prints information about only the specified +ENTRY. +Multiple -e options may be used, +in which case information about each +ENTRY +is printed in the order in which the +options are specified on the command line. + + + + + -f FORMAT, --format=FORMAT + +The file(s) to be printed +are in the specified +FORMAT. +Legal values are +dbm +(the DBM format used +when the +SConsignFile() +function is used) +or +sconsign +(the default format +used for an individual +.sconsign +file in each directory). + + + + + -h, --help + +Prints a help message and exits. + + + + + -i, --implicit + +Prints the list of cached implicit dependencies +for all entries or the the specified entries. + + + + + --raw + +Prints a pretty-printed representation +of the raw Python dictionary that holds +build information about individual entry +(both the entry itself or its implicit dependencies). +An entry's build action is still printed in its usual format. + + + + + -r, --readable + +Prints timestamps in a human-readable string, +enclosed in single quotes. + + + + + -t, --timestamp + +Prints the timestamp information +for all entries or the specified entries. + + + + + -v, --verbose + +Prints labels identifying each field being printed. + + + + + + +ENVIRONMENT + + + SCONS_LIB_DIR + +Specifies the directory that contains the SCons Python module directory +(e.g. /home/aroach/scons-src-0.01/src/engine). +on the command line. + + + + + + +SEE ALSO +scons, +scons +User Manual, +scons +Design Document, +scons +source code. + + + +AUTHORS +Steven Knight <knight at baldmt dot com> + + + -- cgit v1.2.3