lei-config - Man Page

git-config wrapper for lei configuration file

Synopsis

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

lei config -l | --list

lei config -e | --edit

Description

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

All imap and 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

Variables

external.*

Managed by lei-add-external(1) and lei-forget-external(1)

imap.proxy
nntp.proxy

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

imap.starttls
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.

imap.compress
nntp.compress

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

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

imap.debug
nntp.debug

Enable debugging output of underlying IMAP and NNTP libraries, currently Mail::IMAPClient and Net::NNTP, respectively. If using imap.proxy or nntp.proxy point to a SOCKS proxy, debugging output for IO::Socket::Socks will be enabled, as well.

Disabling imap.compress may be required for readability.

imap.timeout
nntp.timeout

The read timeout for responses.

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

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

color.SLOT

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

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

Options

Most git-config(1) command-line switches are accepted by lei config as-is.  The most-frequently-used options are expected to be:

-e
--edit

Opens an editor to edit the lei config file

-l
--list

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

Contact

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

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

Referenced By

lei(1), lei-import(1).

1993-10-02 public-inbox.git public-inbox user manual