[or-cvs] [metrics-utils/master] Add a deprecation warning to the bridge descriptor sanitizer.

[karsten at torproject.org]

commit 3803e70f00edb7504880bff11285d70fa2bef1b7
Author: Karsten Loesing <karsten.loesing at gmx.net>
Date:   Wed Jan 19 13:58:33 2011 +0100

    Add a deprecation warning to the bridge descriptor sanitizer.
---
 bridge-desc-sanitizer/ConvertBridgeDescs.java |    9 +++++++++
 bridge-desc-sanitizer/HOWTO                   |   11 +++++++++++
 2 files changed, 20 insertions(+), 0 deletions(-)

diff --git a/bridge-desc-sanitizer/ConvertBridgeDescs.java b/bridge-desc-sanitizer/ConvertBridgeDescs.java
index 6a6c5bf..a088695 100644
--- a/bridge-desc-sanitizer/ConvertBridgeDescs.java
+++ b/bridge-desc-sanitizer/ConvertBridgeDescs.java
@@ -7,6 +7,15 @@ public class ConvertBridgeDescs {
 
   public static void main(String[] args) throws Exception {
 
+    System.out.println("\n                       THIS SOFTWARE IS "
+        + "DEPRECATED !\n\nThere is at least one known issue in this "
+        + "software:  Bridge IP addresses\ncontained in reject lines are "
+        + "not rewritten as 127.0.0.1.  There may be\nfurther issues.  "
+        + "Please use the bridge descriptor sanitizer that is part\nof "
+        + "metrics-db instead of this software:\n\n"
+        + "  https://gitweb.torproject.org/metrics-db.git\n");
+    System.exit(1);
+
     long started = System.currentTimeMillis();
 
     if (args.length < 5) {
diff --git a/bridge-desc-sanitizer/HOWTO b/bridge-desc-sanitizer/HOWTO
index b84d5ce..418dc5f 100644
--- a/bridge-desc-sanitizer/HOWTO
+++ b/bridge-desc-sanitizer/HOWTO
@@ -2,6 +2,17 @@ Bridge descriptor sanitizer
 
 ---------------------------------------------------------------------------
 
+                       THIS SOFTWARE IS DEPRECATED !
+
+There is at least one known issue in this software:  Bridge IP addresses
+contained in reject lines are not rewritten as 127.0.0.1.  There may be
+further issues.  Please use the bridge descriptor sanitizer that is part
+of metrics-db instead of this software:
+
+  https://gitweb.torproject.org/metrics-db.git
+
+---------------------------------------------------------------------------
+
 Introduction:
 
 The bridge authority Tonga keeps a list of bridges in order to serve bridge