Documentation updates. Fixes a few formating bugs, adds various minor missing api documentation, fixes a few typos. Also fixes a few tiny code issues, mostly missing consts, etc

darcs-hash:20060617130708-ac50b-cc2ec5aa3e4bfb8e28d7b86441bfb4661f1dd7e7.gz

1 files changed, 6 insertions, 0 deletions

diff --git a/util.h b/util.h
index 300b15e1..e15c211b 100644
--- a/util.h
+++ b/util.h
@@ -1,5 +1,11 @@
 /** \file util.h
 	Generic utilities library.
+
+	All containers in this library except strinb_buffer_t are written
+	so that they don't allocate any memory until the first element is
+	inserted into them. That way it is known to be very cheap to
+	initialize various containers at startup, supporting the fish
+	notion of doing as much lazy initalization as possible.
 */
 
 #ifndef FISH_UTIL_H