diff --git a/doc.go b/doc.go
index c1304bc..d0e6bd3 100644
--- a/doc.go
+++ b/doc.go
@@ -43,6 +43,14 @@
 //   key = val\
 //         ue
 //
+// Properties stores all comments preceding a key and provides
+// GetComments() and SetComments() methods to retrieve and
+// update them. The convenience functions GetComment() and
+// SetComment() allow access to the last comment. The
+// WriteComment() method writes properties files including
+// the comments and with the keys in the original order.
+// This can be used for sanitizing properties files.
+//
 // Property expansion is recursive and circular references
 // and malformed expressions are not allowed and cause an
 // error. Expansion of environment variables is supported.