lei-config(1)

LEI-CONFIG(1)

public-inbox user manual

LEI-CONFIG(1)

NAME

lei-config - 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 imap.proxy or nntp.proxy points 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: Open 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/>

COPYRIGHT

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

1993-10-02

public-inbox.git