From 4eae1d4882fbfdf0368d4b3e1bae8145440883a6 Mon Sep 17 00:00:00 2001
From: Jonas Fonseca <fonseca@diku.dk>
Date: Thu, 22 Dec 2005 04:00:55 +0100
Subject: [PATCH] Add a few comment and remove an obsolete one

---
 src/document/dom/stack.c | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/document/dom/stack.c b/src/document/dom/stack.c
index 7ca7e1f1..798b0b68 100644
--- a/src/document/dom/stack.c
+++ b/src/document/dom/stack.c
@@ -341,6 +341,9 @@ walk_dom_nodes(struct dom_stack *stack, struct dom_node *root)
 /* DOM Stack Tracing: */
 
 #ifdef DOM_STACK_TRACE
+
+/* Compress a string to a single line with newlines etc. replaced with "\\n"
+ * sequence. */
 static inline unsigned char *
 compress_string(unsigned char *string, unsigned int length)
 {
@@ -364,7 +367,8 @@ compress_string(unsigned char *string, unsigned int length)
 	return buffer.source;
 }
 
-/* @codepage denotes how entity strings should be decoded. */
+/* Set @string to the value of the given @node, however, with strings
+ * compressed and entity references 'expanded'. */
 static void
 set_enhanced_dom_node_value(struct dom_string *string, struct dom_node *node)
 {