+;; This is a library for creating an Atom feed from a Lisp program.
+;; The normal usage is to create a feed with `atom-create', giving it
+;; a title and a Web address. Once the feed has been created, entries
+;; may be added to the feed, by specifying (at the minimum) a title, a
+;; permanent link and the content of the entry. Text-only, HTML and
+;; XHTML entries are supported.
+
+;; A feed is really a Lisp structure as used by the `xml.el' package,
+;; without the parent `feed' element.
+
+;; A typical usage would look like this:
+
+;; (let ((my-atom-feed (atom-create "My feed" "http://example.org")))
+;; ; 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>")
+;; (atom-print my-atom-feed))