[tor-commits] [tor/maint-0.2.4] Fix a couple of documentation issues.

[nickm at torproject.org]

commit e1128d905c7eae33d099e4287823fbd18f3c876e
Author: Nick Mathewson <nickm at torproject.org>
Date:   Mon Mar 18 15:00:52 2013 -0400

    Fix a couple of documentation issues.
---
 src/common/crypto.c  |    3 ++-
 src/or/routerparse.c |    7 ++++++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/src/common/crypto.c b/src/common/crypto.c
index aeef1e3..b9829ec 100644
--- a/src/common/crypto.c
+++ b/src/common/crypto.c
@@ -1635,7 +1635,8 @@ crypto_digest_assign(crypto_digest_t *into,
 /** Given a list of strings in <b>lst</b>, set the <b>len_out</b>-byte digest
  * at <b>digest_out</b> to the hash of the concatenation of those strings,
  * plus the optional string <b>append</b>, computed with the algorithm
- * <b>alg</b>. */
+ * <b>alg</b>.
+ * <b>out_len</b> must be \<= DIGEST256_LEN. */
 void
 crypto_digest_smartlist(char *digest_out, size_t len_out,
                         const smartlist_t *lst, const char *append,
diff --git a/src/or/routerparse.c b/src/or/routerparse.c
index 63f8fab..87dc608 100644
--- a/src/or/routerparse.c
+++ b/src/or/routerparse.c
@@ -683,7 +683,12 @@ router_get_extrainfo_hash(const char *s, size_t s_len, char *digest)
                               "\nrouter-signature",'\n', DIGEST_SHA1);
 }
 
-/** DOCDOC */
+/** Helper: used to generate signatures for routers, directories and
+ * network-status objects.  Given a <b>digest_len</b>-byte digest in
+ * <b>digest</b> and a secret <b>private_key</b>, generate an PKCS1-padded
+ * signature, BASE64-encode it, surround it with -----BEGIN/END----- pairs,
+ * and return the new signature on success or NULL on failure.
+ */
 char *
 router_get_dirobj_signature(const char *digest,
                             size_t digest_len,