builder: atom: Clarify #:blog-prefix parameter.

1 files changed, 20 insertions, 13 deletions

diff --git a/doc/haunt.texi b/doc/haunt.texi
index 178565a..9ba21ed 100644
--- a/doc/haunt.texi
+++ b/doc/haunt.texi
@@ -929,47 +929,54 @@ The default theme is intended only for testing purposes.
 (use-modules (haunt builder atom))
 @end example
 
-@deffn {Procedure} atom-feed [#:file-name #:subtitle #:filter #:max-entries #:blog-prefix]
+@deffn {Procedure} atom-feed [#:file-name "feed.xml"] [#:subtitle "Recent Posts"] @
+                             [#:filter posts/reverse-chronological] @
+                             [#:max-entries 20] [#:blog-prefix ""]
 Return a builder procedure that renders a site's posts as an Atom
 feed.  All arguments are optional:
 
 @table @var
 
 @item file-name:
-The page file name.  The default is @file{feed.xml}.
+The page file name.
 
 @item subtitle
-The feed subtitle.  The default is ``Recent Posts''.
+The feed subtitle.
 
 @item filter
 The procedure called to manipulate the posts list before rendering.
-The default is to keep all posts and sort them in reverse
-chronological order.
 
 @item max-entries
-The maximum number of posts to render in the feed.  The default is 20.
+The maximum number of posts to render in the feed.
+
+@item blog-prefix
+The prefix for all post URLs, which is the combination of the blog's
+prefix and post prefix.  @xref{Blog} for more information.
+
 @end table
 
 @end deffn
 
-@deffn {Procedure} atom-feeds-by-tag [#:prefix #:filter #:max-entries #:blog-prefix]
+@deffn {Procedure} atom-feeds-by-tag [#:prefix "feeds/tags"] @
+                                     [#:filter posts/reverse-chronological] @
+                                     [#:max-entries 20] [#:blog-prefix ""]
 Return a builder procedure that renders an atom feed for every tag
 used in a post.  All arguments are optional:
 
 @table @var
 
 @item prefix
-The directory in which to write the feeds.  The default is
-@file{feeds/tags}.
+The directory in which to write the feeds.
 
 @item filter
 The procedure called to manipulate the posts list before rendering.
-The default is to keep all posts and sort them in reverse
-chronological order.
 
 @item max-entries
-The maximum number of posts to render in each feed.  The default is
-20.
+The maximum number of posts to render in each feed.
+
+@item blog-prefix
+The prefix for all post URLs, which is the combination of the blog's
+prefix and post prefix.  @xref{Blog} for more information.
 
 @end table