Updated documentation.
diff --git a/doc.go b/doc.go
index c140a35..7a403ea 100644
--- a/doc.go
+++ b/doc.go
@@ -11,9 +11,9 @@
// literals can be used in UTF-8 encoded properties files but
// aren't necessary.
//
-// All of the different key/value delimiters " :=" are supported
-// as well as the comment characters '!' and '#' and multi-line
-// values.
+// All of the different key/value delimiters ' ', ':' and '=' are
+// supported as well as the comment characters '!' and '#' and
+// multi-line values.
//
// ! this is a comment
// # and so is this
@@ -27,8 +27,8 @@
// key = val\
// ue
//
-// Property expansion is recursive and circular references
-// and malformed expressions are not allowed and cause an
+// Property expansion is recursive and circular references
+// and malformed expressions are not allowed and cause an
// error.
//
// # standard property
@@ -37,7 +37,7 @@
// # property expansion: key2 = value
// key2 = ${key}
//
-// # recursive property expansion: key3 = value
+// # recursive expansion: key3 = value
// key3 = ${key2}
//
// # circular reference (error)
@@ -54,6 +54,22 @@
// p.Prefix = "#["
// p.Postfix = "]#"
//
+// Properties provides convenience functions for getting typed
+// values with default values if the key does not exist or the
+// type conversion failed.
+//
+// # Returns true if the value is either "1", "on", "yes" or "true"
+// # Returns false for every other value and the default value if
+// # the key does not exist.
+// v = p.GetBool("key", false)
+//
+// # Returns the value if the key exists and the format conversion
+// # was successful. Otherwise, the default value is returned.
+// v = p.GetInt64("key", 999)
+// v = p.GetUint64("key", 999)
+// v = p.GetFloat64("key", 123.0)
+// v = p.GetString("key", "def")
+//
// The following documents provide a description of the properties
// file format.
//
