From 9c04223086bf606eaac6dc2848af80518210d823 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= <debian@jff-webhosting.net>
Date: Tue, 23 Jul 2019 13:30:08 +0200
Subject: New upstream version 3.1.0

---
 sconsign.1 | 54 ++++++++++++++++++++++++++++++++++++------------------
 1 file changed, 36 insertions(+), 18 deletions(-)

(limited to 'sconsign.1')

diff --git a/sconsign.1 b/sconsign.1
index 34d417b..596da26 100644
--- a/sconsign.1
+++ b/sconsign.1
@@ -2,12 +2,12 @@
 .\"     Title: SCONSIGN
 .\"    Author: [see the "AUTHORS" section]
 .\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
-.\"      Date: 03/26/2019
-.\"    Manual: SCons 3.0.5
-.\"    Source: SCons 3.0.5
+.\"      Date: 07/20/2019
+.\"    Manual: SCons 3.1.0
+.\"    Source: SCons 3.1.0
 .\"  Language: English
 .\"
-.TH "SCONSIGN" "1" "03/26/2019" "SCons 3\&.0\&.5" "SCons 3\&.0\&.5"
+.TH "SCONSIGN" "1" "07/20/2019" "SCons 3\&.1\&.0" "SCons 3\&.1\&.0"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -28,26 +28,36 @@
 .\" * MAIN CONTENT STARTS HERE *
 .\" -----------------------------------------------------------------
 .SH "NAME"
-sconsign \- print SCons \&.sconsign file information
+sconsign \- print SCons signature file information
 .SH "SYNOPSIS"
 .HP \w'\fBsconsign\fR\ 'u
-\fBsconsign\fR [\fIoptions\fR...] \fIfile\fR [\fI\&.\&.\&.\fR]
+\fBsconsign\fR [\fIoptions\fR...] [\fIfile\fR...]
 .SH "DESCRIPTION"
 .PP
 The
 \fBsconsign\fR
-command displays the contents of one or more
-\fB\&.sconsign\fR
-files specified by the user\&.
+command displays the contents of one or more signature ("\fBsconsign\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]
+dumps the entire contents of the specified file(s)\&. Without the verbose option, each entry is printed in the following format:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+file: signature timestamp length
+        implicit_dependency_1: signature timestamp length
+        implicit_dependency_2: signature timestamp length
+        \&.\&.\&.
+        action_signature [action string]
+.fi
+.if n \{\
+.RE
+.\}
 .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\&.
+is printed in place of any missing timestamp, build signature ("bsig"), or content signature ("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\&. The verbose option expands the display into a more human readable format\&.
 .PP
 By default,
 \fBsconsign\fR
@@ -56,7 +66,7 @@ assumes that any
 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
+\fBSConsignFile\fR
 function)\&. Any
 \fIfile\fR
 argument that ends in
@@ -70,6 +80,12 @@ attempts to guess the format\&. If that does not work, an explicit format may be
 or
 \fB\-\-format=\fR
 options\&.
+.PP
+If there are no
+\fIfile\fR
+arguments, the name
+\&.sconsign\&.dblite
+is assumed\&.
 .SH "OPTIONS"
 .PP
 Various options control what information is printed and the format:
@@ -110,7 +126,8 @@ 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
+\fBSConsignFile\fR
+function is used) or
 \fBsconsign\fR
 (the default format used for an individual
 \fB\&.sconsign\fR
@@ -124,12 +141,12 @@ Prints a help message and exits\&.
 .PP
 \-i, \-\-implicit
 .RS 4
-Prints the list of cached implicit dependencies for all entries or the the specified entries\&.
+Prints the list of cached implicit dependencies for all entries or for 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\&.
+Prints a pretty\-printed representation of the raw Python dictionary that holds build information about individual entries (both the entry itself and its implicit dependencies)\&. An entry\*(Aqs build action is still printed in its usual format\&.
 .RE
 .PP
 \-r, \-\-readable
@@ -150,7 +167,8 @@ Prints labels identifying each field being printed\&.
 .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\&.
+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
-- 
cgit v1.2.3