-;; (atom-add-text-entry my-atom-feed
-;; "Hello world"
-;; "http://example.org/hello"
-;; "Hello the world!")
-;; (atom-add-xhtml-entry my-atom-feed
-;; "An XHTML example"
-;; "http://example.org/html-example"
-;; "<p>One can also use <acronym>XHTML</acronym> in the
-;; entries.</p>")
+;; ; A simple, text-only entry
+;; (atom-add-text-entry
+;; my-atom-feed
+;; "Hello world"
+;; "http://example.org/hello"
+;; "Hello the world!")
+;;
+;; ; A text-only entry, with all the optional pieces of data
+;; (atom-add-text-entry
+;; my-atom-feed
+;; "Bonjour"
+;; "http://example.org/bonjour"
+;; "Bonjour à tout le monde !"
+;; ;; optional: the last modification time
+;; (date-to-time "2011-01-30 23:40:12")
+;; ;; optional: an identifier for this entry; a common way to generate it is
+;; ;; to use the domain name and the creation date of the entry.
+;; (atom-generate-id "http://example.org"
+;; (date-to-time "2011-01-30 10:01:05"))
+;; ;; optional: a summary for this entry
+;; "Bonjour, monde.")
+;;
+;; (atom-add-xhtml-entry
+;; my-atom-feed
+;; "An XHTML example"
+;; "http://example.org/html-example"
+;; "<p>One can also use <acronym>XHTML</acronym> in the entries.</p>")