From: Eric Wong <e@yhbt.net>
To: meta@public-inbox.org
Subject: [PATCH] examples/*.psgi: add examples for -httpd
Date: Thu, 19 Mar 2020 23:55:50 +0000 [thread overview]
Message-ID: <20200319235550.10401-1-e@yhbt.net> (raw)
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+ <https://www.gnu.org/licenses/gpl-3.0.txt>
# 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;
reply other threads:[~2020-03-19 23:55 UTC|newest]
Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
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=20200319235550.10401-1-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).