From: Eric Wong <e@yhbt.net>
Date: Tue, 21 Apr 2020 20:30:06 +0000 (+0000)
Subject: doc: note some changes for 1.5
X-Git-Tag: v1.5.0~40
X-Git-Url: http://www.git.stargrave.org/?p=public-inbox.git;a=commitdiff_plain;h=693361aed909049cef8e47a6147cbf12d44f21c8

doc: note some changes for 1.5

As an established project (:P), it's important to document when
new features appear in manpages.   Users may be reading new
documentation online which doesn't reflect an older version they
have installed.
---

diff --git a/Documentation/RelNotes/v1.5.0.eml b/Documentation/RelNotes/v1.5.0.eml
index 4b01eef2..c9108c15 100644
--- a/Documentation/RelNotes/v1.5.0.eml
+++ b/Documentation/RelNotes/v1.5.0.eml
@@ -5,7 +5,20 @@ MIME-Version: 1.0
 Content-Type: text/plain; charset=utf-8
 Content-Disposition: inline
 
-TBD
+* public-inbox-index
+
+  - `--max-size=SIZE' CLI switch and `publicinbox.indexMaxSize'
+     config file option added
+
+* public-inbox-watch
+
+  - multiple values of `publicinbox.<name>.watchheader' are
+    supported, thanks to Kyle Meyer
+
+* PublicInbox::WWW
+
+  - $INBOX_DIR/description and $INBOX_DIR/cloneurl are not
+    memoized if missing
 
 Please report bugs via plain-text mail to: meta@public-inbox.org
 
diff --git a/Documentation/public-inbox-config.pod b/Documentation/public-inbox-config.pod
index f3b6c8b7..e6108c35 100644
--- a/Documentation/public-inbox-config.pod
+++ b/Documentation/public-inbox-config.pod
@@ -87,9 +87,11 @@ Default: none; only for L<public-inbox-watch(1)> users
 	[publicinbox "test"]
 		watchheader = List-Id:<test.example.com>
 
-If specified, L<public-inbox-watch(1)> will only process mail matching
-the given header.  If specified multiple times, mail will be processed
-if it matches any of the values.
+If specified, L<public-inbox-watch(1)> will only process mail
+matching the given header.  If specified multiple times in
+public-inbox 1.5 or later, mail will be processed if it matches
+any of the values.  Only the last value was used in public-inbox
+1.4 and earlier.
 
 Default: none; only for L<public-inbox-watch(1)> users
 
diff --git a/Documentation/public-inbox-index.pod b/Documentation/public-inbox-index.pod
index 398ac516..8a37580c 100644
--- a/Documentation/public-inbox-index.pod
+++ b/Documentation/public-inbox-index.pod
@@ -94,6 +94,7 @@ supported, thus the value of C<1m> to prevents indexing of
 messages larger than one megabyte.
 
 This is useful for avoiding memory exhaustion in mirrors.
+This option is only available in public-inbox 1.5 or later.
 
 Default: none