examples/*.psgi: add examples for -httpd

public-inbox-httpd should work with any PSGI files, so make
it more apparent to people reading .psgi examples.

diff --git a/examples/cgit.psgi b/examples/cgit.psgi
index 3aaa4515243946266cbbacf55bd50e6ff7833200..e72e832d03be09b9c5aeedbc9620a2e1a40c4681 100644 (file)
--- 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 fd653b187a4612560ea0e37b1c6d93080317a083..23ec7861c59795389326bef37911641238fb39be 100644 (file)
--- 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 4753a5013593552eba493fb9b9ffd0c1019e9aa5..3cce7191da827518a6544c7db5f0d6aed2ecd9e9 100644 (file)
--- 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 b9817e83a064be0d404704bceafbb63b74fdef00..9891a1f03e747a6a5cf92a1aec51789c40e5243b 100644 (file)
--- 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;