summaryrefslogtreecommitdiffstats
path: root/doc/man
diff options
context:
space:
mode:
authorMats Wichmann <mats@linux.com>2018-11-10 16:41:28 (GMT)
committerMats Wichmann <mats@linux.com>2018-12-01 16:28:01 (GMT)
commit1519a7d40f5e65c1c1c896c9c96456f8364c6907 (patch)
treef418622ec8e37ac6dce1a37d99081c279a9154c1 /doc/man
parentb4d710b768da3f17d57ad2aade009ac8affee9e2 (diff)
downloadSCons-1519a7d40f5e65c1c1c896c9c96456f8364c6907.zip
SCons-1519a7d40f5e65c1c1c896c9c96456f8364c6907.tar.gz
SCons-1519a7d40f5e65c1c1c896c9c96456f8364c6907.tar.bz2
Some fixes to sconsign
Two locations which attempt to directly print an item tipped over on py3, so they now decode(). There seem to be cases where implicit dependencies do not have signatures, so instead of looping through the dep list and indexing into the signature list (IndexError), the two lists are now zipped, which means nothing is printed, but sconsign does not die (the zip technique is used in FS.py in the engine). Minor PEP8 changes: spaces around operators; shorter lines; two-blanks rule around classes/functions. Also unused args changed to _ to show it was intentional. Manpage updated slightly - the internal whichdb function explicitly looks for the .dblite suffix, so the claim that if it's not .dbm it is assumed to be dblite was not true. sconsign still will not work on a dblite file which is not suffixed .dblite, but that is an existing problem, not a newly introduced one. Signed-off-by: Mats Wichmann <mats@linux.com>
Diffstat (limited to 'doc/man')
-rw-r--r--doc/man/sconsign.xml16
1 files changed, 10 insertions, 6 deletions
diff --git a/doc/man/sconsign.xml b/doc/man/sconsign.xml
index 44a1e5f..75eeaf1 100644
--- a/doc/man/sconsign.xml
+++ b/doc/man/sconsign.xml
@@ -25,7 +25,7 @@
-->
<!-- lifted from troff+man by doclifter -->
-<refentry id='sconsign1'
+<refentry id='sconsign1'
xmlns="http://www.scons.org/dbxsd/v1.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0 http://www.scons.org/dbxsd/v1.0/scons.xsd">
@@ -42,7 +42,7 @@
<!-- body begins here -->
<refsynopsisdiv id='synopsis'>
<cmdsynopsis>
- <command>sconsign</command>
+ <command>sconsign</command>
<arg choice='opt' rep='repeat'><replaceable>options</replaceable></arg>
<arg choice='plain'><replaceable>file</replaceable></arg>
<arg choice='opt'><replaceable>...</replaceable></arg>
@@ -51,7 +51,7 @@
<refsect1 id='description'><title>DESCRIPTION</title>
-<para>The
+<para>The
<command>sconsign</command>
command
displays the contents of one or more
@@ -94,17 +94,21 @@ was specified by the
function).
Any
<emphasis>file</emphasis>
-argument that does not end in
-<markup>.dbm</markup>
+argument that ends in
+<markup>.dblite</markup>
is assumed to be a traditional
<markup>.sconsign</markup>
file containing the signature entries
for a single directory.
+If neither of those is true,
+<command>sconsign</command>
+attempts to guess the format (but will
+probably get it wrong).
An explicit format
may be specified using the
<option>-f</option>
or
-<option>--file=</option>
+<option>--format=</option>
options.</para>
</refsect1>