fixup Plack-related requires

[public-inbox.git] / examples / public-inbox.psgi

diff --git a/examples/public-inbox.psgi b/examples/public-inbox.psgi
index 0d11c19fb8395e95097ad4d0bc443971860e3648..55c113e425ae0010e77c392f04a733c3d9485f20 100644 (file)
--- a/examples/public-inbox.psgi
+++ b/examples/public-inbox.psgi
@@ -1,13 +1,14 @@
 #!/usr/bin/perl -w
-# Copyright (C) 2014-2015 all contributors <meta@public-inbox.org>
-# License: AGPLv3 or later (https://www.gnu.org/licenses/agpl-3.0.txt)
+# Copyright (C) 2014-2016 all contributors <meta@public-inbox.org>
+# 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
 use strict;
 use warnings;
 use PublicInbox::WWW;
 PublicInbox::WWW->preload;
-use Plack::Request;
 use Plack::Builder;
 my $www = PublicInbox::WWW->new;
 builder {
@@ -22,6 +23,7 @@ builder {
        };
        $@ and warn
 "Plack::Middleware::Deflater missing, bandwidth will be wasted\n";
+
        # Enable to ensure redirects and Atom feed URLs are generated
        # properly when running behind a reverse proxy server which
        # sets X-Forwarded-For and X-Forwarded-Proto request headers.
@@ -31,6 +33,13 @@ builder {
 "Plack::Middleware::ReverseProxy missing,\n",
 "URL generation for redirects may be wrong if behind a reverse proxy\n";
 
+       # Optional: Log timing information for requests to track performance.
+       # Logging to STDOUT is recommended since public-inbox-httpd knows
+       # how to reopen it via SIGUSR1 after log rotation.
+       # enable 'AccessLog::Timed',
+       #       logger => sub { syswrite(STDOUT, $_[0]) },
+       #       format => '%t "%r" %>s %b %D';
+
        enable 'Head';
        sub { $www->call(@_) };
 }