From f1a626728ee8be94ebb023c6cfb2f68684671450 Mon Sep 17 00:00:00 2001
From: Simon Ruderich <simon@ruderich.org>
Date: Tue, 6 Sep 2011 16:31:11 +0200
Subject: [PATCH] src/*.c: Minor documentation updates.

---
 src/connection.c | 11 ++++++-----
 src/log.c        |  2 +-
 src/tlsproxy.c   |  4 ++--
 3 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/src/connection.c b/src/connection.c
index ed8a594..bfdac1c 100644
--- a/src/connection.c
+++ b/src/connection.c
@@ -31,9 +31,10 @@
 #include <errno.h>
 
 
-/* Maximum line of a HTTP request line. Longer request lines are aborted with
- * an error. The standard doesn't specify a maximum line length but this
- * should be a good limit to make processing simpler. */
+/* Maximum length of a HTTP request line. Longer request lines are aborted
+ * with an error. The standard doesn't specify a maximum line length but this
+ * should be a good limit to make processing simpler. As HTTPS is used this
+ * doesn't limit long GET requests. */
 #define MAX_REQUEST_LINE 4096
 
 /* Format string used to send HTTP/1.0 error responses to the client.
@@ -216,7 +217,7 @@ void handle_connection(int client_socket) {
 
             goto out;
         }
-        /* server_certificate_path() may open the file, close it. */
+        /* server_certificate_path() may have opened the file, close it. */
         if (NULL != file) {
             fclose(file);
         }
@@ -257,7 +258,7 @@ void handle_connection(int client_socket) {
 
     /* Initialize TLS server credentials to talk to the client. */
     result = initialize_tls_session_client(client_socket,
-                                           /* use special host if the server
+                                           /* use a special host if the server
                                             * certificate was invalid */
                                            (validation_failed) ? "invalid"
                                                                : host,
diff --git a/src/log.c b/src/log.c
index 9cd3da4..23b90ee 100644
--- a/src/log.c
+++ b/src/log.c
@@ -22,7 +22,7 @@
 
 /* va_*() */
 #include <stdarg.h>
-/* pthread_*() */
+/* pthread_self() */
 #include <pthread.h>
 
 
diff --git a/src/tlsproxy.c b/src/tlsproxy.c
index 3fa03e3..b79e05d 100644
--- a/src/tlsproxy.c
+++ b/src/tlsproxy.c
@@ -109,11 +109,11 @@ int main(int argc, char **argv) {
         return EXIT_FAILURE;
     }
 
-    /* Setup our SIGINT signal handler which allows a "normal" termination of
-     * the server in DEBUG mode. */
     sigemptyset(&action.sa_mask);
     action.sa_flags   = 0;
 #ifdef DEBUG
+    /* Setup our SIGINT signal handler which allows a "normal" termination of
+     * the server in DEBUG mode. */
     action.sa_handler = sigint_handler;
     sigaction(SIGINT, &action, NULL);
 #endif
-- 
2.44.1