summaryrefslogtreecommitdiff
path: root/sconsign.1
diff options
context:
space:
mode:
Diffstat (limited to 'sconsign.1')
-rw-r--r--sconsign.1164
1 files changed, 0 insertions, 164 deletions
diff --git a/sconsign.1 b/sconsign.1
index bd879e3..e69de29 100644
--- a/sconsign.1
+++ b/sconsign.1
@@ -1,164 +0,0 @@
-'\" t
-.\" Title: SCONSIGN
-.\" Author: [see the "AUTHORS" section]
-.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
-.\" Date: 09/27/2014
-.\" Manual: September 2014
-.\" Source: September 2014
-.\" Language: English
-.\"
-.TH "SCONSIGN" "1" "09/27/2014" "September 2014" "September 2014"
-.\" -----------------------------------------------------------------
-.\" * Define some portability stuff
-.\" -----------------------------------------------------------------
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" http://bugs.debian.org/507673
-.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.ie \n(.g .ds Aq \(aq
-.el .ds Aq '
-.\" -----------------------------------------------------------------
-.\" * set default formatting
-.\" -----------------------------------------------------------------
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.\" -----------------------------------------------------------------
-.\" * MAIN CONTENT STARTS HERE *
-.\" -----------------------------------------------------------------
-.SH "NAME"
-sconsign \- print SCons \&.sconsign file information
-.SH "SYNOPSIS"
-.HP \w'\fBsconsign\fR\ 'u
-\fBsconsign\fR [\fIoptions\fR...] \fIfile\fR [\fI\&.\&.\&.\fR]
-.SH "DESCRIPTION"
-.PP
-The
-\fBsconsign\fR
-command displays the contents of one or more
-\fB\&.sconsign\fR
-files specified by the user\&.
-.PP
-By default,
-\fBsconsign\fR
-dumps the entire contents of the specified file(s)\&. Each entry is printed in the following format:
-.PP
-file: signature timestamp length implicit_dependency_1: signature timestamp length implicit_dependency_2: signature timestamp length action_signature [action string]
-.PP
-\fBNone\fR
-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\&.
-.PP
-By default,
-\fBsconsign\fR
-assumes that any
-\fIfile\fR
-arguments that end with a
-\fB\&.dbm\fR
-suffix contains signature entries for more than one directory (that is, was specified by the
-\fBSConsignFile ()\fR
-function)\&. Any
-\fIfile\fR
-argument that does not end in
-\fB\&.dbm\fR
-is assumed to be a traditional
-\fB\&.sconsign\fR
-file containing the signature entries for a single directory\&. An explicit format may be specified using the
-\fB\-f\fR
-or
-\fB\-\-file=\fR
-options\&.
-.SH "OPTIONS"
-.PP
-Various options control what information is printed and the format:
-.PP
-\-a, \-\-act, \-\-action
-.RS 4
-Prints the build action information for all entries or the specified entries\&.
-.RE
-.PP
-\-c, \-\-csig
-.RS 4
-Prints the content signature (csig) information for all entries or the specified entries\&.
-.RE
-.PP
-\-d DIRECTORY, \-\-dir=DIRECTORY
-.RS 4
-When the signatures are being read from a
-\fB\&.dbm\fR
-file, or the
-\fB\-f dbm\fR
-or
-\fB\-\-format=dbm\fR
-options are used, prints information about only the signatures for entries in the specified
-\fIDIRECTORY\fR\&.
-.RE
-.PP
-\-e ENTRY, \-\-entry=ENTRY
-.RS 4
-Prints information about only the specified
-\fIENTRY\fR\&. Multiple \-e options may be used, in which case information about each
-\fIENTRY\fR
-is printed in the order in which the options are specified on the command line\&.
-.RE
-.PP
-\-f FORMAT, \-\-format=FORMAT
-.RS 4
-The file(s) to be printed are in the specified
-\fIFORMAT\fR\&. Legal values are
-\fBdbm\fR
-(the DBM format used when the
-\fBSConsignFile\fR() function is used) or
-\fBsconsign\fR
-(the default format used for an individual
-\fB\&.sconsign\fR
-file in each directory)\&.
-.RE
-.PP
-\-h, \-\-help
-.RS 4
-Prints a help message and exits\&.
-.RE
-.PP
-\-i, \-\-implicit
-.RS 4
-Prints the list of cached implicit dependencies for all entries or the the specified entries\&.
-.RE
-.PP
-\-\-raw
-.RS 4
-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\*(Aqs build action is still printed in its usual format\&.
-.RE
-.PP
-\-r, \-\-readable
-.RS 4
-Prints timestamps in a human\-readable string, enclosed in single quotes\&.
-.RE
-.PP
-\-t, \-\-timestamp
-.RS 4
-Prints the timestamp information for all entries or the specified entries\&.
-.RE
-.PP
-\-v, \-\-verbose
-.RS 4
-Prints labels identifying each field being printed\&.
-.RE
-.SH "ENVIRONMENT"
-.PP
-SCONS_LIB_DIR
-.RS 4
-Specifies the directory that contains the SCons Python module directory (e\&.g\&. /home/aroach/scons\-src\-0\&.01/src/engine)\&. on the command line\&.
-.RE
-.SH "SEE ALSO"
-.PP
-\fBscons\fR,
-\fBscons\fR
-User Manual,
-\fBscons\fR
-Design Document,
-\fBscons\fR
-source code\&.
-.SH "AUTHORS"
-.PP
-Steven Knight <knight at baldmt dot com>