* patchid: prefix search support added to WWW and lei for
"git patch-id --stable" support
- * text inside base-85 binary patches are no longer indexed
+ * text inside base-85 binary patches is no longer indexed
to avoid false positives
* for lei users, "lei reindex" now exists and is required
* compatibility with SQLite <3.8.3 on CentOS 7.x
- * fix `lei q -tt' on locally-indexed messages (still broken for remotes:
+ * fix `lei q -tt' on locally indexed messages (still broken for remotes:
https://public-inbox.org/meta/20230226170931.M947721@dcvr/ )
* `lei import' now sets labels+keywords consistently on all
- already-imported messages
+ already imported messages
solver (used by lei (rediff|blob), and PublicInbox::WWW)
Search improvements (lei and PublicInbox::WWW)
- * quoted text inside base-85 binary patches are no longer indexed
+ * quoted text inside base-85 binary patches is no longer indexed
Thanks to all the bug reporters and users who made this release
possible.
Enable debugging output of underlying IMAP and NNTP libraries,
currently L<Mail::IMAPClient> and L<Net::NNTP>, respectively.
-If using L<imap.proxy> or L<nntp.proxy> point to a SOCKS proxy,
-debugging output for L<IO::Socket::Socks> will be enabled, as
+If L<imap.proxy> or L<nntp.proxy> points to a SOCKS proxy,
+debugging output for L<IO::Socket::Socks> will be enabled as
well.
Disabling L<imap.compress> may be required for readability.
=head1 OPTIONS
Most L<git-config(1)> command-line switches are accepted by C<lei config>
-as-is. The most-frequently-used options are expected to be:
+as is. The most frequently used options are expected to be:
=over 4
=item --edit
-Opens an editor to edit the lei config file
+Open an editor to edit the lei config file.
=item -l
=back
=for comment
-SIGQUIT and SIGINT currently do what SIGTERM do, may change...
+SIGQUIT and SIGINT currently do what SIGTERM does, may change...
=head1 CONTACT
=item --pretty
-Pretty print output. If stdout is opened to a tty, C<--pretty> is
+Pretty-print output. If stdout is opened to a tty, C<--pretty> is
enabled by default.
=item -
=head1 COPYRIGHT
-Copyright 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>
Most commonly C<text> (the default) or C<reply> to
display the message(s) in a format suitable for trimming
-and sending as a email reply.
+and sending as an email reply.
=item --stdin
=item --pretty
-Pretty print JSON output. If stdout is opened to a tty, C<--pretty>
+Pretty-print JSON output. If stdout is opened to a tty, C<--pretty>
is enabled by default.
=item --ascii
=item --pretty
-Pretty print C<json> or C<concatjson> output. If stdout is opened to
+Pretty-print C<json> or C<concatjson> output. If stdout is opened to
a tty and used as the C<--output> destination, C<--pretty> is enabled
by default.
# dump "inbox" labeled files from the past week to a Maildir
lei q L:inbox rt:last.week.. -o /tmp/results
- # open /tmp/results in your favorite mail agent. If inotify or kevent
+ # Open /tmp/results in your favorite mail agent. If inotify or kevent
# works, keyword changes (e.g. marking messages as `seen') are
# synchronized automatically.
=item --pretty
-Pretty print C<json> or C<concatjson> output. If stdout is opened to
+Pretty-print C<json> or C<concatjson> output. If stdout is opened to
a tty and used as the C<--output> destination, C<--pretty> is enabled
by default.
=item -n NUMBER
-Fuzzy limit the number of matches per-local external and lei/store.
+Fuzzy-limit the number of matches per local external and lei/store.
Messages added by the L<--threads> switch do not count towards this
limit, and there is no limit on remote externals.
=head1 SYNOPSIS
-L<lei(1)> is intended for use with both publicly-archived
+L<lei(1)> is intended for use with both publicly archived
and "private" mail in personal mailboxes. This document is
intended to give an overview of security implications and
lower^Wmanage user expectations.
=head1 CORE DUMPS
-In case any process crashes, a core dumps may contain passwords or
+In case any process crashes, a core dump may contain passwords or
contents of sensitive messages. Please report these so they can be
fixed (see L</CONTACT>).
lei currently uses the L<curl(1)> and L<git(1)> executables in
C<$PATH> for HTTP and HTTPS network access. Interactive
-authentication for HTTP and HTTPS is not-yet-supported since all
+authentication for HTTP and HTTPS is not yet supported since all
currently supported HTTP/HTTPS sources are L<PublicInbox::WWW>
instances.
L<Mail::IMAPClient> and L<Net::NNTP> will use L<IO::Socket::SSL>
for TLS if available. In turn, L<IO::Socket::SSL> uses the
-widely-installed OpenSSL library.
+widely installed OpenSSL library.
STARTTLS will be attempted if advertised by the server
unless IMAPS or NNTPS are used. C<-c imap.starttls=0>
=head2 mail_sync.sqlite3
-This SQLite database maintained for bidirectional mapping of
+This SQLite database is maintained for bidirectional mapping of
git blobs to IMAP UIDs, Maildir file names, and NNTP article numbers.
It is also used for retrieving messages from Maildirs indexed by
The time(s) of the last successful queries are the C<lastresult>
values visible from L<lei-edit-search(1)>.
-Date formats understood by L<git-rev-parse(1)> may be used.
-e.g C<1.hour> or C<3.days>
+Date formats understood by L<git-rev-parse(1)> may be used,
+e.g., C<1.hour> or C<3.days>.
Default: 2.days
archive locations to avoid SPOF.
* optional Cache::FastMmap support so production deployments won't
- need Varnish (Varnish doesn't protect NNTP nor IMAP, either)
+ need Varnish (Varnish doesn't protect NNTP or IMAP, either)
* dogfood and take advantage of new kernel APIs (while maintaining
portability to older Linux, free BSDs and maybe Hurd).
seek($err, 0, SEEK_SET) or die "seek: $!";
$err = do { local $/; <$err> };
die <<EOM;
-@$cmd failed: Xapian devlopment files missing? (\$?=$?)
+@$cmd failed: Xapian development files missing? (\$?=$?)
$err
EOM
}
projects / thirdparty / public-inbox.git / commitdiff
