diff options
| author | Eric Wong <e@80x24.org> | 2023-02-15 08:01:09 +0000 |
|---|---|---|
| committer | Eric Wong <e@80x24.org> | 2023-02-16 04:16:49 +0000 |
| commit | e4ebfd7f9679a2e28a6eb26db45eda772a55acda (patch) | |
| tree | 6e44195a6eecf76c6a895c24c31ef57c2845c80c | |
| parent | bc54a149d08e9eac58a14c77b3df29fdb2f07fb8 (diff) | |
| download | public-inbox-e4ebfd7f9679a2e28a6eb26db45eda772a55acda.tar.gz | |
-netd is strictly more powerful and a gateway drug for imapd/nntpd/pop3d instances :>
| -rw-r--r-- | Documentation/public-inbox.cgi.pod | 14 | ||||
| -rw-r--r-- | lib/PublicInbox/WWW.pod | 16 |
2 files changed, 17 insertions, 13 deletions
diff --git a/Documentation/public-inbox.cgi.pod b/Documentation/public-inbox.cgi.pod index 71f8a6f5..0f93fa5a 100644 --- a/Documentation/public-inbox.cgi.pod +++ b/Documentation/public-inbox.cgi.pod @@ -4,7 +4,7 @@ public-inbox.cgi - CGI wrapper for PublicInbox::WWW =head1 SYNOPSIS -You generally want to run public-inbox-httpd, instead +You generally want to run public-inbox-netd or public-inbox-httpd, instead =head1 DESCRIPTION @@ -12,9 +12,10 @@ public-inbox.cgi provides a CGI interface wrapper on top of the PSGI/Plack L<PublicInbox::WWW> module. It is only provided for compatibility reasons and NOT recommended. -CGI with Perl is slow due to code loading overhead and web servers lack -the scheduling fairness of L<public-inbox-httpd(1)> for handling git -clones and streaming large mbox downloads. +CGI with Perl is slow due to code loading overhead and +web servers lack the scheduling fairness of L<public-inbox-netd(1)> +and L<public-inbox-httpd(1)> for handling git clones and +streaming large mbox downloads. =head1 CONTACT @@ -25,10 +26,11 @@ L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/> =head1 COPYRIGHT -Copyright 2019-2021 all contributors L<mailto:meta@public-inbox.org> +Copyright all contributors L<mailto:meta@public-inbox.org> License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt> =head1 SEE ALSO -L<public-inbox-httpd(1)>, L<PublicInbox::WWW>, L<public-inbox-daemon(8)>, +L<public-inbox-netd(1)>, L<public-inbox-httpd(1)>, +L<PublicInbox::WWW>, L<public-inbox-daemon(8)>, diff --git a/lib/PublicInbox/WWW.pod b/lib/PublicInbox/WWW.pod index 9f6ba466..b55f010e 100644 --- a/lib/PublicInbox/WWW.pod +++ b/lib/PublicInbox/WWW.pod @@ -20,13 +20,14 @@ The PSGI web interface for public-inbox. Using this directly is not needed unless you wish to customize your public-inbox PSGI deployment or are using a PSGI server -other than L<public-inbox-httpd(1)>. +other than L<public-inbox-netd(1)> (C<-netd>) / +L<public-inbox-httpd(1)> (C<-httpd>) -While this PSGI application works with all PSGI/Plack web +While this PSGI application should work with all PSGI/Plack web servers such as L<starman(1)>, L<starlet(1)> or L<twiggy(1)>; -PublicInbox::WWW takes advantage of currently-undocumented APIs -of L<public-inbox-httpd(1)> to improve fairness when serving -large responses for thread views and git clones. +PublicInbox::WWW takes advantage of internal APIs of C<-netd> +and C<-httpd> to improve fairness when serving large responses +for thread views, mbox downloads, and git clones. =head1 ENVIRONMENT @@ -47,10 +48,11 @@ and L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta =head1 COPYRIGHT -Copyright (C) 2016-2021 all contributors L<mailto:meta@public-inbox.org> +Copyright (C) all contributors L<mailto:meta@public-inbox.org> License: AGPL-3.0+ L<http://www.gnu.org/licenses/agpl-3.0.txt> =head1 SEE ALSO -L<http://plackperl.org/>, L<Plack>, L<public-inbox-httpd(1)> +L<http://plackperl.org/>, L<Plack>, L<public-inbox-netd(1)>, +L<public-inbox-httpd(1)> |