Clarify status of example programs

(That is, add comments to say that dns-example and le-proxy are recent and
ugly; event-test is old and ugly.)

diff --git a/sample/dns-example.c b/sample/dns-example.c
index c5ecf7f69d9c4676f599b5e675b3af8d5cd2b54d..3d73d56db8e9bb695de8a300cac97e3e8e0c2a3d 100644 (file)
--- a/sample/dns-example.c
+++ b/sample/dns-example.c
@@ -1,3 +1,9 @@
+/*
+  This example code shows how to use the high-level, low-level, and
+  server-level interfaces of evdns.
+
+  XXX It's pretty ugly and should probably be cleaned up.
+ */
 
 #include <event-config.h>
 

diff --git a/sample/event-test.c b/sample/event-test.c
index b530e8fa1bd6dc434a7fead65e41e0a929738fc2..5b4b14c43907a18c2efb12a8f639c603bc4a437c 100644 (file)
--- a/sample/event-test.c
+++ b/sample/event-test.c
@@ -1,4 +1,9 @@
 /*
+ * XXX This sample code was once meant to show how to use the basic Libevent
+ * interfaces, but it never worked on non-Unix platforms, and some of the
+ * interfaces have changed since it was first written.  It should probably
+ * be removed or replaced with something better.
+ *
  * Compile with:
  * cc -I/usr/local/include -o event-test event-test.c -L/usr/local/lib -levent
  */

diff --git a/sample/le-proxy.c b/sample/le-proxy.c
index 84ed78ad2104d549dc1f5045ac522659b15a1ab2..78474a1248b0495eaf1ed9f5e1616f1271bbca3c 100644 (file)
--- a/sample/le-proxy.c
+++ b/sample/le-proxy.c
@@ -1,3 +1,9 @@
+/*
+  This example code shows how to write an (optionally encrypting) SSL proxy
+  with Libevent's bufferevent layer.
+
+  XXX It's a little ugly and should probably be cleaned up.
+ */
 
 #include <stdio.h>
 #include <assert.h>