user/dev discussion of public-inbox itself
 help / color / mirror / code / Atom feed
From: Eric Wong <e@yhbt.net>
To: meta@public-inbox.org
Subject: [PATCH 2/2] doc: update notes and HACKING ahead of 1.4 release
Date: Wed,  1 Apr 2020 01:04:41 -0500	[thread overview]
Message-ID: <20200401060441.1750-3-e@yhbt.net> (raw)
In-Reply-To: <20200401060441.1750-1-e@yhbt.net>

There will probably be a 1.4 release in a few days...
---
 Documentation/RelNotes/v1.4.0.eml | 57 +++++++++++++++++++++++++++++++
 HACKING                           |  3 ++
 2 files changed, 60 insertions(+)

diff --git a/Documentation/RelNotes/v1.4.0.eml b/Documentation/RelNotes/v1.4.0.eml
index 0ebf8d65..b8f6c9b0 100644
--- a/Documentation/RelNotes/v1.4.0.eml
+++ b/Documentation/RelNotes/v1.4.0.eml
@@ -4,11 +4,68 @@ Subject: [WIP] public-inbox 1.4.0
 MIME-Version: 1.0
 Content-Type: text/plain; charset=utf-8
 
+This release focuses on reproducibility improvements and
+bugfixes for corner-cases.  Busy instances of PublicInbox::WWW
+may also notice memory usage reductions.
+
+Rare messages lacking Date and/or Received headers, mirrors now
+fallback to using the git author/commit times to reindex those
+messages to ensure search and filtering queries behave the same
+in mirrors as they do on the original machine.
+
+"altid" SQLite dumps are now accessible to all over the WWW
+interface via `POST /$INBOX/$ALTID.sql.gz'.
+
+Busy instances of PublicInbox::WWW (whether via
+public-inbox-httpd or another PSGI server) may notice
+significant memory usage reductions from the single message
+"permalink" lifetime optimization.  There also ongoing work to
+improve memory lifetime management to reduce the potential for
+memory fragmentation in daemons.
+
+* general changes:
+
+  - `include.*' directives in the public-inbox-config(5) file
+    are now honored as documented in git-config(1),
+    thanks to Andreas Rottmann.
+
+  - `+0000' is assumed for dates missing TZ offsets;
+    thanks to Leah Neukirchen for spotting this regression from
+    v1.2.0.
+
+  - `<' and `>' characters are dropped to avoid errors in git
+    in addresses for git, thanks again to Leah for noticing
+    this long-standing bug.
+
 * PublicInbox::WWW:
+
   - reduced memory use for single message "permalink" view
+  - code preload improved to reduce memory fragmentation
   - remove redundant "a=" parameter in links to solver
   - escape '&' in hrefs properly
   - fix optional address obfuscation in search results
+  - `POST /$INBOX/$ALTID.sql.gz' endpoint to retrieve SQLite dumps
+
+* public-inbox-httpd + public-inbox-nntpd:
+
+  - fix SIGUSR2 upgrade in worker-less instances (-W0)
+
+* public-inbox-httpd:
+
+  - fix RFC 7230 conformance when Content-Length and "chunked"
+    are both specified
+
+* public-inbox-index:
+
+  - reproduce original date and time stamps in mirrors for messages
+    lacking Date: and/or Received: headers
+
+  - new `--compact' (or `-c') switch to perform the equivalent of
+    public-inbox-compact(1) after indexing each inbox
+
+* documentation:
+
+  - Documentation/technical/data_structures.txt add for new hackers.
 
 Please report bugs via plain-text mail to: meta@public-inbox.org
 
diff --git a/HACKING b/HACKING
index 5e02302c..cceb686f 100644
--- a/HACKING
+++ b/HACKING
@@ -56,6 +56,9 @@ requirements.
 See design_www.txt and design_notes.txt in the Documentation/
 directory for design decisions made during development.
 
+See Documentation/technical/ in the source tree for more details
+on specific topics, in particular data_structures.txt
+
 Perl notes
 ----------
 

      parent reply	other threads:[~2020-04-01  6:04 UTC|newest]

Thread overview: 9+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-04-01  6:04 [PATCH 0/2] doc: pre-release doc updates Eric Wong
2020-04-01  6:04 ` [PATCH 1/2] README: expand on the GUI non-requirement Eric Wong
2020-04-01 15:30   ` Kyle Meyer
2020-04-01 20:34     ` Eric Wong
2020-04-01 21:33       ` Kyle Meyer
2020-04-01 23:40         ` Eric Wong
2020-04-02  0:26           ` Kyle Meyer
2020-04-02  5:54             ` [PATCH] README: add a missing "be" Eric Wong
2020-04-01  6:04 ` Eric Wong [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://public-inbox.org/README

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20200401060441.1750-3-e@yhbt.net \
    --to=e@yhbt.net \
    --cc=meta@public-inbox.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://80x24.org/public-inbox.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).