examples/cgit.psgi | 5 ++++- examples/highlight.psgi | 4 ++++ examples/newswww.psgi | 5 ++++- examples/public-inbox.psgi | 5 +++++ diff --git a/examples/cgit.psgi b/examples/cgit.psgi index 3aaa4515243946266cbbacf55bd50e6ff7833200..e72e832d03be09b9c5aeedbc9620a2e1a40c4681 100644 --- a/examples/cgit.psgi +++ b/examples/cgit.psgi @@ -4,8 +4,11 @@ # License: GPL-3.0+ # # 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 --- 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 --- a/examples/newswww.psgi +++ b/examples/newswww.psgi @@ -8,8 +8,11 @@ # to redirect users to the proper HTTP/HTTPS endpoint for a given # 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 --- a/examples/public-inbox.psgi +++ b/examples/public-inbox.psgi @@ -3,8 +3,13 @@ # Copyright (C) 2014-2020 all contributors # 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;