.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
.\" ========================================================================
.\"
.IX Title "LEI-LCAT 1"
.TH LEI-LCAT 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\-lcat \- display local copy of messages(s)
.SH SYNOPSIS
.IX Header "SYNOPSIS"
lei lcat [OPTIONS] MSGID_OR_URL [MSGID_OR_URL...]
.PP
lei lcat [OPTIONS] (\-\-stdin|\-)
.SH DESCRIPTION
.IX Header "DESCRIPTION"
lcat (local cat) is a wrapper around \fBlei\-q\fR\|(1) that displays local
messages by Message-ID.  It is able to extract Message-IDs from URLs
as well as from common formats such as \f(CW\*(C`<$MSGID>\*(C'\fR and
\&\f(CW\*(C`id:$MSGID\*(C'\fR.  When reading from stdin, input that isn't understood is
discarded, so the caller doesn't have to bother extracting the
Message-ID or link from surrounding text (e.g., a "Link: \f(CW$URL\fR" line).
.SH OPTIONS
.IX Header "OPTIONS"
The following options, described in \fBlei\-q\fR\|(1), are supported.
One deviation from \fBlei\-q\fR\|(1) is the default output format is
\&\f(CW\*(C`\-f text\*(C'\fR when writing to stdout.
.IP \-\-format=FORMAT 4
.IX Item "--format=FORMAT"
.PD 0
.IP "\-f FORMAT" 4
.IX Item "-f FORMAT"
.PD
Most commonly \f(CW\*(C`text\*(C'\fR (the default) or \f(CW\*(C`reply\*(C'\fR to
display the message(s) in a format suitable for trimming
and sending as a email reply.
.IP \-\-stdin 4
.IX Item "--stdin"
.PD 0
.IP \- 4
.PD
\&\f(CW\*(C`lei lcat\*(C'\fR implicitly reads from stdin if it is a \fBpipe\fR\|(7)
or regular file.  This is handy for invoking \f(CW\*(C`lei lcat\*(C'\fR from
inside an \f(CW$EDITOR\fR session (assuming you use an \f(CW$EDITOR\fR
which lets you pipe arbitrary lines to arbitrary commands).
.IP \-\-[no\-]remote 4
.IX Item "--[no-]remote"
.PD 0
.IP \-\-no\-local 4
.IX Item "--no-local"
.IP \-\-no\-external 4
.IX Item "--no-external"
.IP \-\-no\-import\-remote 4
.IX Item "--no-import-remote"
.IP "\-\-torsocks=auto|no|yes, \-\-no\-torsocks" 4
.IX Item "--torsocks=auto|no|yes, --no-torsocks"
.IP \-\-proxy=PROTOCOL://HOST[:PORT] 4
.IX Item "--proxy=PROTOCOL://HOST[:PORT]"
.IP "\-o MFOLDER, \-\-output=MFOLDER" 4
.IX Item "-o MFOLDER, --output=MFOLDER"
.IP "\-d STRATEGY, \-\-dedupe=STRATEGY" 4
.IX Item "-d STRATEGY, --dedupe=STRATEGY"
.IP "\-t, \-\-threads" 4
.IX Item "-t, --threads"
.IP "\-s KEY, \-\-sort=KEY" 4
.IX Item "-s KEY, --sort=KEY"
.IP "\-r, \-\-reverse" 4
.IX Item "-r, --reverse"
.IP \-\-offset=NUMBER 4
.IX Item "--offset=NUMBER"
.IP "\-g, \-\-globoff" 4
.IX Item "-g, --globoff"
.IP "\-a, \-\-augment" 4
.IX Item "-a, --augment"
.IP \-\-lock=METHOD 4
.IX Item "--lock=METHOD"
.IP \-\-alert=COMMAND 4
.IX Item "--alert=COMMAND"
.IP \-\-mua=COMMAND 4
.IX Item "--mua=COMMAND"
.IP \-\-no\-color 4
.IX Item "--no-color"
.PD
.SH CONTACT
.IX Header "CONTACT"
Feedback welcome via plain-text mail to <mailto:meta@public\-inbox.org>
.PP
The mail archives are hosted at <https://public\-inbox.org/meta/>
and <http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright 2021 all contributors <mailto:meta@public\-inbox.org>
.PP
License: AGPL\-3.0+ <https://www.gnu.org/licenses/agpl\-3.0.txt>
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBlei\-q\fR\|(1), \fBlei\-blob\fR\|(1)