From b496eba0721137ce9f02c5bd1b26ba1e2cf954a3 Mon Sep 17 00:00:00 2001 From: Zooko O'Whielacronx Date: Sat, 10 Jan 2009 14:56:01 -0700 Subject: [PATCH] trivial: minor changes to in-line comments -- mark plaintext-hash-tree as obsolete --- src/allmydata/immutable/upload.py | 2 +- src/allmydata/interfaces.py | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/src/allmydata/immutable/upload.py b/src/allmydata/immutable/upload.py index 41b338e3..5c3c759a 100644 --- a/src/allmydata/immutable/upload.py +++ b/src/allmydata/immutable/upload.py @@ -683,7 +683,7 @@ class CHKUploader: return d def abort(self): - """Call this is the upload must be abandoned before it completes. + """Call this if the upload must be abandoned before it completes. This will tell the shareholders to delete their partial shares. I return a Deferred that fires when these messages have been acked.""" if not self._encoder: diff --git a/src/allmydata/interfaces.py b/src/allmydata/interfaces.py index 98553ab1..18b30071 100644 --- a/src/allmydata/interfaces.py +++ b/src/allmydata/interfaces.py @@ -1330,7 +1330,7 @@ class IEncryptedUploadable(Interface): plaintext hashes, but don't need the redundant encrypted data).""" def get_plaintext_hashtree_leaves(first, last, num_segments): - """Get the leaf nodes of a merkle hash tree over the plaintext + """OBSOLETE; Get the leaf nodes of a merkle hash tree over the plaintext segments, i.e. get the tagged hashes of the given segments. The segment size is expected to be generated by the IEncryptedUploadable before any plaintext is read or ciphertext produced, so that the @@ -1350,7 +1350,7 @@ class IEncryptedUploadable(Interface): """ def get_plaintext_hash(): - """Get the hash of the whole plaintext. + """OBSOLETE; Get the hash of the whole plaintext. This returns a Deferred which fires with a tagged SHA-256 hash of the whole plaintext, obtained from hashutil.plaintext_hash(data). -- 2.45.2