From 258bad35c0d7e79c1392cc6d2d143e5c1e3b4825 Mon Sep 17 00:00:00 2001
From: dockes <none@none>
Date: Tue, 5 Sep 2006 08:04:36 +0000
Subject: [PATCH] comments only

---
 src/utils/mimeparse.cpp | 14 +++++++-------
 src/utils/mimeparse.h   |  4 +++-
 2 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/src/utils/mimeparse.cpp b/src/utils/mimeparse.cpp
index 7901d7b8..d7d1d94b 100644
--- a/src/utils/mimeparse.cpp
+++ b/src/utils/mimeparse.cpp
@@ -1,5 +1,5 @@
 #ifndef lint
-static char rcsid[] = "@(#$Id: mimeparse.cpp,v 1.10 2006-01-23 13:32:28 dockes Exp $ (C) 2004 J.F.Dockes";
+static char rcsid[] = "@(#$Id: mimeparse.cpp,v 1.11 2006-09-05 08:04:36 dockes Exp $ (C) 2004 J.F.Dockes";
 #endif
 /*
  *   This program is free software; you can redistribute it and/or modify
@@ -32,14 +32,14 @@ static char rcsid[] = "@(#$Id: mimeparse.cpp,v 1.10 2006-01-23 13:32:28 dockes E
 using namespace std;
 #endif /* NO_NAMESPACES */
 
-// Parsing a header value. Only content-type has parameters, but
-// others are compatible with content-type syntax, only, parameters
-// are not used. So we can parse all like content-type:
+// Parsing a header value. Only content-type and content-disposition
+// have parameters, but others are compatible with content-type
+// syntax, only, parameters are not used. So we can parse all like
+// content-type:
 //    headertype: value [; paramname=paramvalue] ...
 // Value and paramvalues can be quoted strings, and there can be
-// comments in there
-
-
+// comments too
+// Ref: RFC2045/6/7 (MIME) RFC1806 (content-disposition)
 
 // The lexical token returned by find_next_token
 class Lexical {
diff --git a/src/utils/mimeparse.h b/src/utils/mimeparse.h
index 148b85a2..b4e79ab2 100644
--- a/src/utils/mimeparse.h
+++ b/src/utils/mimeparse.h
@@ -16,7 +16,7 @@
  */
 #ifndef _MIME_H_INCLUDED_
 #define _MIME_H_INCLUDED_
-/* @(#$Id: mimeparse.h,v 1.5 2006-01-30 11:15:28 dockes Exp $  (C) 2004 J.F.Dockes */
+/* @(#$Id: mimeparse.h,v 1.6 2006-09-05 08:04:36 dockes Exp $  (C) 2004 J.F.Dockes */
 
 #include <string>
 #include <map>
@@ -44,6 +44,8 @@ extern bool qp_decode(const std::string& in, std::string &out);
 /** Decode an Internet mail header value encoded according to rfc2047 
  *
  * Example input:  =?iso-8859-1?Q?RE=A0=3A_Smoke_Tests?=
+ * The input normally comes from parseMimeHeaderValue() output
+ * and no comments or quoting are expected.
  * @param in input string, ascii with rfc2047 markup
  * @return out output string encoded in utf-8
  */