about summary refs log tree commit homepage
path: root/examples
DateCommit message (Collapse)
2016-05-28examples: config no longer supports atomUrl
We build the atomUrl from url, which can change dynamically depending on what PSGI environment it is called under.
2016-05-23http: chunk in the server, not middleware
Since PSGI does not require Transfer-Encoding: chunked or Content-Length, we cannot expect random apps we host to chunk their responses. Thus, to improve interoperability, chunk at the HTTP layer like other PSGI servers do. I'm chosing a more syscall-intensive method (via multiple send(...MSG_MORE) for now to reduce copy + packet overhead.
2016-04-06examples/public-inbox.psgi: add note for our httpd
Default to maximizing compatibility in the example, but document the potential improvement if possible. Of course, using public-inbox-httpd out-of-the-box without a user-specified config file already enables chunked encoding by default.
2016-03-12examples: disable Chunked response in PSGI example
It seems incompatible with Starman and probably confuses other HTTP/1.0-only servers, too. Our -httpd will respect it and requires it for persistent connections.
2016-02-29fixup Plack-related requires
We do not need to load Plack::Request outside of WWW anymore.
2016-02-28examples/public-inbox.psgi: relax license to GPL-3.0+
Using the AGPL for server config files is probably overkill. GPL-3.0+ still requires appliance vendors to disclose configurations which seems desirable for end users.
2016-02-28examples: various Apache-related doc updates
Plack::Handler::Apache2 exists and seems to work very well.
2016-02-28examples/cgi-webrick.rb: set CGIPathEnv, update comments
webrick clears PATH otherwise, and we rely on git commands.
2016-02-28examples/: PSGI example updates
Users wanting to customize their installation should know to about the usability of STDOUT for logging. (and we still need manpages for -nntpd and -httpd)
2016-02-28httpd: allow running if ReverseProxy is missing
Not everybody will be running this behind a ReverseProxy; but it's probably the likely configuration. Anyways, warn about this and also about Deflater being missing.
2016-02-26psgi: enable ReverseProxy middleware by default
ReverseProxy is the common way to run Perl applications, so enable it by default and don't care too much about fake requests because we don't handle any sensitive information or rely on authentication (everything is read-only from the WWW interface and will remain so).
2016-02-25www: make interface more OO
This allows multiple instances the WWW app from running within the same process space
2016-02-13examples/public-inbox.psgi: document ReverseProxy
Running behind a ReverseProxy is a popular deployment, so document it for users.
2016-01-03examples/public-inbox.psgi: shorten to simplify
Enable deflater using a shorter string as we do with other middlewares, and use single quotes to denote we do not need interpolation.
2015-12-25examples/public-inbox.psgi: make output chunky by default
HTTP/1.1 clients will want persistent connections and need to know response terminations.
2015-09-15add cgit commit-filter example
public-inbox has search functionality, so take advantage of good commit messages with proper titles to lookup discussion.
2015-09-11examples/public-inbox.psgi: optional deflater
The deflater middleware isn't standard Plack, so don't require potential users install it.
2015-09-06update copyright headers and email addresses
In the future, it should be possible to use this: git ls-files | UPDATE_COPYRIGHT_HOLDER='all contributors' \ UPDATE_COPYRIGHT_USE_INTERVALS=2 \ xargs /path/to/gnulib/build-aux/update-copyright
2015-09-03examples/public-inbox.psgi: update with middlewares
HTML, text, and probably Atom feeds should be compressed.
2014-10-26examples/public-inbox.psgi: add usage to comments
I often forget how to run this
2014-05-05examples/apache2_perl.conf: set PI_CONFIG
This is easier and lower-impact than setting HOME anywhere.
2014-05-01split out WWW package and CGI/PSGI-specific parts
This should allow us to more-easily test with Plack.
2014-04-30examples: make web configs consistent and add README
Hopefully this is enough to get some folks started.
2014-04-30add example configs for Apache2 mod_perl and CGI
These are probably still popular configurations in some settings, so include sample configurations to get folks started. These are trickier than an average CGI script to setup because we rely on pretty URLs from PATH_INFO and not ugly query parameters.
2014-04-21config: use description file for gitweb
Do not repeat ourselves, just use the same description file gitweb uses to avoid surprising users.
2014-04-17add example for CGI with Ruby WEBrick
Some people like old-fashioned Ruby and WEBrick is in the Ruby standard library, so widely available.
2014-04-14rename list from "bugs" to "meta"
"bugs" might confuse and limit the discussion, so "meta" it is!
2014-04-11config: support multiple addresses for a inbox
This makes it possible to gradually migrate to new address in case of list name changes, and is one step closer to operating in "stealth hijack mode" :)
2014-04-05remove failrepo config
We will just use the fallback in Email::Filter to reduce configuration knobs. Failed messages are failed messages, do not classify them beyond that.
2014-03-28config: revamp API and implement lookup