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 CD6C81F619 for ; Thu, 19 Mar 2020 23:55:50 +0000 (UTC) From: Eric Wong To: meta@public-inbox.org Subject: [PATCH] examples/*.psgi: add examples for -httpd Date: Thu, 19 Mar 2020 23:55:50 +0000 Message-Id: <20200319235550.10401-1-e@yhbt.net> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit List-Id: public-inbox-httpd should work with any PSGI files, so make it more apparent to people reading .psgi examples. --- examples/cgit.psgi | 5 ++++- examples/highlight.psgi | 4 ++++ examples/newswww.psgi | 5 ++++- examples/public-inbox.psgi | 5 +++++ 4 files changed, 17 insertions(+), 2 deletions(-) diff --git a/examples/cgit.psgi b/examples/cgit.psgi index 3aaa4515..e72e832d 100644 --- a/examples/cgit.psgi +++ b/examples/cgit.psgi @@ -4,8 +4,11 @@ # # PublicInbox::Cgit may be used independently of WWW. # -# Usage: +# Usage (development, with auto-reload): # plackup -I lib -o 127.0.0.1 -R lib -r examples/cgit.psgi +# +# Usage (production, with public-inbox-httpd(1)): +# public-inbox-httpd [OPTIONS] /path/to/examples/cgit.psgi use strict; use warnings; use Plack::Builder; diff --git a/examples/highlight.psgi b/examples/highlight.psgi index fd653b18..23ec7861 100644 --- a/examples/highlight.psgi +++ b/examples/highlight.psgi @@ -5,6 +5,10 @@ # Usage: plackup [OPTIONS] /path/to/this/file # A startup command for development which monitors changes: # plackup -I lib -o 127.0.0.1 -R lib -r examples/highlight.psgi +# +# .psgi paths may also be passed to public-inbox-httpd(1) for +# production deployments: +# public-inbox-httpd [OPTIONS] /path/to/examples/highlight.psgi use strict; use warnings; use PublicInbox::WwwHighlight; diff --git a/examples/newswww.psgi b/examples/newswww.psgi index 4753a501..3cce7191 100644 --- a/examples/newswww.psgi +++ b/examples/newswww.psgi @@ -8,8 +8,11 @@ # inbox. NewsWWW exists because people (or software) can mishandle # "nntp://" or "news://" URLs as "http://" (or "https://") # -# Usage: +# Usage (development, with auto-reload): # plackup -I lib -o 127.0.0.1 -R lib -r examples/newswww.psgi +# +# Usage (production, with public-inbox-httpd(1)): +# public-inbox-httpd [OPTIONS] /path/to/examples/newsww.psgi use strict; use warnings; use Plack::Builder; diff --git a/examples/public-inbox.psgi b/examples/public-inbox.psgi index b9817e83..9891a1f0 100644 --- a/examples/public-inbox.psgi +++ b/examples/public-inbox.psgi @@ -3,8 +3,13 @@ # License: GPL-3.0+ # Note: this is part of our test suite, update t/plack.t if this changes # Usage: plackup [OPTIONS] /path/to/this/file +# # A startup command for development which monitors changes: # plackup -I lib -o 127.0.0.1 -R lib -r examples/public-inbox.psgi +# +# .psgi paths may also be passed to public-inbox-httpd(1) for +# production deployments: +# public-inbox-httpd [OPTIONS] /path/to/examples/public-inbox.psgi use strict; use warnings; use PublicInbox::WWW;