From b90f239791e87e4ef8a816eb402f654ed9ba9d52 Mon Sep 17 00:00:00 2001
From: Richard Sent <richard@freakingpenguin.com>
Date: Sat, 13 Jan 2024 23:38:09 -0500
Subject: atom/rss: Allow passing last updated date for reproducibility.

---
 doc/haunt.texi | 12 ++++++++++++
 1 file changed, 12 insertions(+)

(limited to 'doc')

diff --git a/doc/haunt.texi b/doc/haunt.texi
index d19cf71..6be2fb5 100644
--- a/doc/haunt.texi
+++ b/doc/haunt.texi
@@ -997,6 +997,7 @@ The default theme is intended only for testing purposes.
 
 @deffn {Procedure} atom-feed [#:file-name "feed.xml"] [#:subtitle "Recent Posts"] @
                              [#:filter posts/reverse-chronological] @
+                             [#:last-updated (current-date)] @
                              [#:max-entries 20] [#:blog-prefix ""]
 Return a builder procedure that renders a site's posts as an Atom
 feed.  All arguments are optional:
@@ -1012,6 +1013,9 @@ The feed subtitle.
 @item filter
 The procedure called to manipulate the posts list before rendering.
 
+@item last-updated
+The feed last updated date.  Defaults to the current date.
+
 @item max-entries
 The maximum number of posts to render in the feed.
 
@@ -1025,6 +1029,7 @@ prefix and post prefix.  @xref{Blog} for more information.
 
 @deffn {Procedure} atom-feeds-by-tag [#:prefix "feeds/tags"] @
                                      [#:filter posts/reverse-chronological] @
+                                     [#:last-updated (current-date)] @
                                      [#: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:
@@ -1037,6 +1042,9 @@ The directory in which to write the feeds.
 @item filter
 The procedure called to manipulate the posts list before rendering.
 
+@item last-updated
+The feed last updated date.  Defaults to the current date.
+
 @item max-entries
 The maximum number of posts to render in each feed.
 
@@ -1057,6 +1065,7 @@ prefix and post prefix.  @xref{Blog} for more information.
 
 @deffn {Procedure} rss-feed [#:file-name "rss-feed.xml"] [#:subtitle "Recent Posts"] @
                             [#:filter posts/reverse-chronological] @
+                            [#:publication-date (current-date)] @
                             [#:max-entries 20] [#:blog-prefix ""]
 Return a builder procedure that renders a list of posts as an RSS
 feed.  All arguments are optional:
@@ -1072,6 +1081,9 @@ The feed subtitle.
 @item filter
 The procedure called to manipulate the posts list before rendering.
 
+@item publication-date
+The feed publication date.  Defaults to the current date.
+
 @item max-entries
 The maximum number of posts to render in the feed.
 
-- 
cgit v1.2.3