From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: X-Spam-Status: No, score=-4.0 required=3.0 tests=ALL_TRUSTED,AWL,BAYES_00 shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from localhost (dcvr.yhbt.net [127.0.0.1]) by dcvr.yhbt.net (Postfix) with ESMTP id 906281F5AD for ; Wed, 1 Apr 2020 06:04:41 +0000 (UTC) From: Eric Wong 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 Message-Id: <20200401060441.1750-3-e@yhbt.net> In-Reply-To: <20200401060441.1750-1-e@yhbt.net> References: <20200401060441.1750-1-e@yhbt.net> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit List-Id: 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 ----------