From 4b095ab61f16696b757e510e6c245871c527abcb Mon Sep 17 00:00:00 2001
From: Dick Hollenbeck <dick@softplc.com>
Date: Tue, 9 Jul 2013 00:22:08 -0500
Subject: [PATCH] comment improvements

---
 common/dsnlexer.cpp |  2 +-
 include/dsnlexer.h  | 12 +++++-------
 2 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/common/dsnlexer.cpp b/common/dsnlexer.cpp
index 42a9f2bb9c..11d8b0452e 100644
--- a/common/dsnlexer.cpp
+++ b/common/dsnlexer.cpp
@@ -396,7 +396,7 @@ static bool isSpace( char cc )
     // Treat negative as large positive to exclude rapidly.
     if( (unsigned char) cc <= ' ' )
     {
-        switch( cc )
+        switch( (unsigned char) cc )
         {
         case ' ':
         case '\n':
diff --git a/include/dsnlexer.h b/include/dsnlexer.h
index 896a8bf2f4..c85a6bd982 100644
--- a/include/dsnlexer.h
+++ b/include/dsnlexer.h
@@ -136,15 +136,13 @@ protected:
 
     /**
      * Function findToken
-     * takes a string and looks up the string in the list of expected
-     * tokens.
+     * takes aToken string and looks up the string in the keywords table.
      *
-     * @param tok A string holding the token text to lookup, in an
-     *   unpredictable case: uppercase or lowercase
-     * @return int - DSN_T matching the keyword text, or DSN_SYMBOL if argument
-     *   string is not a recognized token.
+     * @param aToken is a string to lookup in the keywords table.
+     * @return int - with a value from the enum DSN_T matching the keyword text,
+     *         or DSN_SYMBOL if @a aToken is not in the kewords table.
      */
-    int findToken( const std::string& tok );
+    int findToken( const std::string& aToken );
 
     bool isStringTerminator( char cc )
     {