From 9253dc860de52360d3bc60710422783457143e3d Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Thu, 19 Mar 2020 23:55:50 +0000 Subject: [PATCH] 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. --- 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; -- 2.44.0