[tor-commits] [tor/maint-0.2.2] make nickm's proposed convention from 2003 be gospel

arma at torproject.org arma at torproject.org
Tue Mar 8 20:00:10 UTC 2011


commit 95edd51116c17327f314bc132a0a5f86499e410a
Author: Roger Dingledine <arma at torproject.org>
Date:   Tue Mar 8 14:59:30 2011 -0500

    make nickm's proposed convention from 2003 be gospel
---
 doc/HACKING |   10 +++++-----
 1 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/doc/HACKING b/doc/HACKING
index 486fe6d..bdb86c0 100644
--- a/doc/HACKING
+++ b/doc/HACKING
@@ -312,11 +312,11 @@ operation.
 If a library function is currently called such that failure always means ERR,
 then the library function should log WARN and let the caller log ERR.
 
-[XXX Proposed convention: every message of severity INFO or higher should
-either (A) be intelligible to end-users who don't know the Tor source; or (B)
-somehow inform the end-users that they aren't expected to understand the
-message (perhaps with a string like "internal error").  Option (A) is to be
-preferred to option (B). -NM]
+Every message of severity INFO or higher should either (A) be intelligible
+to end-users who don't know the Tor source; or (B) somehow inform the
+end-users that they aren't expected to understand the message (perhaps
+with a string like "internal error"). Option (A) is to be preferred to
+option (B).
 
 Doxygen
 ~~~~~~~~



More information about the tor-commits mailing list