=head1 NAME

lei-config - git-config wrapper for lei configuration file

=head1 SYNOPSIS

lei config <name> [[<value>] [<value-pattern>]]

lei config -l | --list

lei config -e | --edit

=head1 DESCRIPTION

Call L<git-config(1)> with C<$XDG_CONFIG_HOME/lei/config> as the
configuration file.  All C<OPTIONS> are passed through, but those that
override the configuration file are not permitted.

All C<imap> and C<nntp> options may be specified per-host or
(if using git 2.26+) with wildcards:

	[imap "imap://*.onion"]
		proxy = socks5h://127.0.0.1:9050

	[nntp "nntp://example.com"]
		proxy = socks5h://127.0.0.1:1080

=head2 VARIABLES

=over 8

=item external.*

Managed by L<lei-add-external(1)> and L<lei-forget-external(1)>

=item imap.proxy

=item nntp.proxy

The C<socks5h://> proxy address.  Older versions of SOCKS may
be supported if there is user demand.

=item imap.starttls

=item nntp.starttls

Enable or disable STARTTLS on non-imaps:// and non-nntps://
hosts.  By default, STARTTLS is enabled if available unless
connecting to a Tor .onion or localhost.

=item imap.compress

=item nntp.compress

Enable protocol-level compression.  This may be incompatible
or broken with some servers.

Note: L<Net::NNTP> compression support is pending:
L<https://rt.cpan.org/Ticket/Display.html?id=129967>

=item imap.debug

=item nntp.debug

Enable debugging output of underlying IMAP and NNTP libraries,
currently L<Mail::IMAPClient> and L<Net::NNTP>, respectively.
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.

=item imap.timeout

=item nntp.timeout

The read timeout for responses.

Default: 600 seconds (IMAP); 120 seconds (NNTP)

=item imap.fetchBatchSize

Number of full messages to fetch at once.  Larger values reduce
network round trips at the cost of higher memory use, especially
when retrieving large messages.

Small responses for IMAP flags are fetched at 10000 times this value.

Default: 1

=item color.SLOT

C<quoted>, C<hdrdefault>, C<status>, C<attachment> color slots
are supported for the C<-f text> and C<-f reply> output formats
of L<lei-lcat(1)> and L<lei-q(1)>.

Any per-project .git/config, and global ~/.gitconfig files
will also be parsed for diff coloring.  git diff color slots
(C<color.diff.SLOT>) supported are C<new>, C<old>, C<meta>,
C<frag>, C<func>, and C<context>.

=back

=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:

=over 4

=item -e

=item --edit

Open an editor to edit the lei config file.

=item -l

=item --list

List all variables set in config file, along with their values.

=back

=head1 CONTACT

Feedback welcome via plain-text mail to L<mailto:meta@public-inbox.org>

The mail archives are hosted at L<https://public-inbox.org/meta/> and
L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>

=head1 COPYRIGHT

Copyright all contributors L<mailto:meta@public-inbox.org>

License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt>