diff options
Diffstat (limited to 'sconsign.1')
| -rw-r--r-- | sconsign.1 | 164 |
1 files changed, 0 insertions, 164 deletions
@@ -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> |