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,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 D8C341F45E for ; Sun, 16 Feb 2020 10:24:35 +0000 (UTC) From: Eric Wong To: meta@public-inbox.org Subject: [PATCH] doc: design_www: document solver endpoint Date: Sun, 16 Feb 2020 10:24:35 +0000 Message-Id: <20200216102435.1514-1-e@yhbt.net> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit List-Id: The blob regeneration (solving) part has been stable and performant for over a year with no problems, even with web crawlers constantly hitting it without needing rate limits. All the other stuff is open to bikeshedding (as long as my crappy hardware supports it :P) --- Documentation/design_www.txt | 12 +++++++++++- Documentation/txt2pre | 1 + 2 files changed, 12 insertions(+), 1 deletion(-) diff --git a/Documentation/design_www.txt b/Documentation/design_www.txt index f15a5562..240fa504 100644 --- a/Documentation/design_www.txt +++ b/Documentation/design_www.txt @@ -7,7 +7,7 @@ URL and anchor naming /$INBOX/?r=$GIT_COMMIT -> HTML only /$INBOX/new.atom -> Atom feed -#### Optional, relies on Search::Xapian +#### Optional, relies on Search::Xapian (or Xapian SWIG binding) /$INBOX/$MESSAGE_ID/t/ -> HTML content of thread (nested) /$INBOX/$MESSAGE_ID/T/ -> HTML content of thread (flat) anchors: @@ -21,6 +21,16 @@ URL and anchor naming /$INBOX/$MESSAGE_ID/t.atom -> Atom feed for thread /$INBOX/$MESSAGE_ID/t.mbox.gz -> gzipped mbox of thread +/$INBOX/$GIT_OID/s/ -> "git show" (via "git apply") + This endpoint requires "coderepo" entries configured for + a given inbox. It can recreate ("solve") blobs from + patch emails using Xapian and git-apply(1). It can also + display non-blob content, but that remains a + work-in-progress. + +/$INBOX/$GIT_OID/s/$FILENAME -> "git show", raw output + As above, but shows the raw (usually text/plain) output. + ### Stable endpoints /$INBOX/$MESSAGE_ID/ -> HTML content anchors: diff --git a/Documentation/txt2pre b/Documentation/txt2pre index dcef4b6c..c3a7657e 100755 --- a/Documentation/txt2pre +++ b/Documentation/txt2pre @@ -46,6 +46,7 @@ for (qw[flock(2) setrlimit(2) vfork(2)]) { for (qw[git(1) git-am(1) + git-apply(1) git-config(1) git-daemon(1) git-fetch(1)