.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "LEI-CONFIG 1" .TH LEI-CONFIG 1 1993-10-02 public-inbox.git "public-inbox user manual" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NAME lei\-config \- git\-config wrapper for lei configuration file .SH SYNOPSIS .IX Header "SYNOPSIS" lei config [[] []] .PP lei config \-l | \-\-list .PP lei config \-e | \-\-edit .SH DESCRIPTION .IX Header "DESCRIPTION" Call \fBgit\-config\fR\|(1) with \f(CW\*(C`$XDG_CONFIG_HOME/lei/config\*(C'\fR as the configuration file. All \f(CW\*(C`OPTIONS\*(C'\fR are passed through, but those that override the configuration file are not permitted. .PP All \f(CW\*(C`imap\*(C'\fR and \f(CW\*(C`nntp\*(C'\fR options may be specified per\-host or (if using git 2.26+) with wildcards: .PP .Vb 2 \& [imap "imap://*.onion"] \& proxy = socks5h://127.0.0.1:9050 \& \& [nntp "nntp://example.com"] \& proxy = socks5h://127.0.0.1:1080 .Ve .SS VARIABLES .IX Subsection "VARIABLES" .IP external.* 8 .IX Item "external.*" Managed by \fBlei\-add\-external\fR\|(1) and \fBlei\-forget\-external\fR\|(1) .IP imap.proxy 8 .IX Item "imap.proxy" .PD 0 .IP nntp.proxy 8 .IX Item "nntp.proxy" .PD The \f(CW\*(C`socks5h://\*(C'\fR proxy address. Older versions of SOCKS may be supported if there is user demand. .IP imap.starttls 8 .IX Item "imap.starttls" .PD 0 .IP nntp.starttls 8 .IX Item "nntp.starttls" .PD 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. .IP imap.compress 8 .IX Item "imap.compress" .PD 0 .IP nntp.compress 8 .IX Item "nntp.compress" .PD Enable protocol\-level compression. This may be incompatible or broken with some servers. .Sp Note: Net::NNTP compression support is pending: .IP imap.debug 8 .IX Item "imap.debug" .PD 0 .IP nntp.debug 8 .IX Item "nntp.debug" .PD 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. .Sp Disabling imap.compress may be required for readability. .IP imap.timeout 8 .IX Item "imap.timeout" .PD 0 .IP nntp.timeout 8 .IX Item "nntp.timeout" .PD The read timeout for responses. .Sp Default: 600 seconds (IMAP); 120 seconds (NNTP) .IP imap.fetchBatchSize 8 .IX 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. .Sp Small responses for IMAP flags are fetched at 10000 times this value. .Sp Default: 1 .IP color.SLOT 8 .IX Item "color.SLOT" \&\f(CW\*(C`quoted\*(C'\fR, \f(CW\*(C`hdrdefault\*(C'\fR, \f(CW\*(C`status\*(C'\fR, \f(CW\*(C`attachment\*(C'\fR color slots are supported for the \f(CW\*(C`\-f text\*(C'\fR and \f(CW\*(C`\-f reply\*(C'\fR output formats of \fBlei\-lcat\fR\|(1) and \fBlei\-q\fR\|(1). .Sp Any per\-project .git/config, and global ~/.gitconfig files will also be parsed for diff coloring. git diff color slots (\f(CW\*(C`color.diff.SLOT\*(C'\fR) supported are \f(CW\*(C`new\*(C'\fR, \f(CW\*(C`old\*(C'\fR, \f(CW\*(C`meta\*(C'\fR, \&\f(CW\*(C`frag\*(C'\fR, \f(CW\*(C`func\*(C'\fR, and \f(CW\*(C`context\*(C'\fR. .SH OPTIONS .IX Header "OPTIONS" Most \fBgit\-config\fR\|(1) command\-line switches are accepted by \f(CW\*(C`lei config\*(C'\fR as is. The most frequently used options are expected to be: .IP \-e 4 .IX Item "-e" .PD 0 .IP \-\-edit 4 .IX Item "--edit" .PD Open an editor to edit the lei config file. .IP \-l 4 .IX Item "-l" .PD 0 .IP \-\-list 4 .IX Item "--list" .PD List all variables set in config file, along with their values. .SH CONTACT .IX Header "CONTACT" Feedback welcome via plain\-text mail to .PP The mail archives are hosted at and .SH COPYRIGHT .IX Header "COPYRIGHT" Copyright all contributors .PP License: AGPL\-3.0+