From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <kyle@kyleam.com>
X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net
X-Spam-Level: 
X-Spam-ASN: AS16276 94.23.0.0/16
X-Spam-Status: No, score=-3.7 required=3.0 tests=AWL,BAYES_00,DKIM_SIGNED,
	DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_LOW,
	RCVD_IN_MSPIKE_H2,SPF_HELO_NONE,SPF_PASS shortcircuit=no autolearn=ham
	autolearn_force=no version=3.4.2
Received: from out0.migadu.com (out0.migadu.com [94.23.1.103])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(No client certificate requested)
	by dcvr.yhbt.net (Postfix) with ESMTPS id F158E1F8C8
	for <meta@public-inbox.org>; Sat,  2 Oct 2021 00:19:39 +0000 (UTC)
X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers.
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kyleam.com; s=key1;
	t=1633133977;
	h=from:from:reply-to:subject:subject:date:date:message-id:message-id:
	 to:to:cc:cc:mime-version:mime-version:content-type:content-type:
	 in-reply-to:in-reply-to:references:references;
	bh=RdPaU9+yi3rZ/NvdJZcVTuXYrUBHZ9sElHUu9vUPUr8=;
	b=t67TOlgnWwNSv3KP4dTPX6j5ip1hdh3rz85yBGzBFoP39wJ8TLufG831E3bE0F4eNRJ+JV
	3ct5+bkEgRLTdLuDrCigFTzntlNlTRaW2iwqitgr//TrTztF+Q1MmjbmPLvHCzi6xnS5c7
	XEccPRArsBtCl8OXsC9op6P2N08IQO+K5MJrGM6yXOjJmmji3YkciAmFMZoHg8D2Gmycov
	KoFOgfrGRRnRKZtUbLIzFVY0RCcIiC2dd4Ig6GMFqMfBCnXy7W5bnwn2qar6YQUILA2lXE
	mAekonqECuVUVt+4wlnTlk6FmnRIK6+L8fVw/HTV7c1oSNx1MFRk1NEQibyC0A==
From: Kyle Meyer <kyle@kyleam.com>
To: Eric Wong <e@80x24.org>
Cc: meta@public-inbox.org
Subject: Re: [PATCH 9/9] doc: lei-daemon: new manpage
In-Reply-To: <20211001095445.9326-10-e@80x24.org>
References: <20211001095445.9326-1-e@80x24.org>
 <20211001095445.9326-10-e@80x24.org>
Date: Fri, 01 Oct 2021 20:19:29 -0400
Message-ID: <87tui0p9bi.fsf@kyleam.com>
MIME-Version: 1.0
Content-Type: text/plain
X-Migadu-Flow: FLOW_OUT
X-Migadu-Auth-User: kyle@kyleam.com
List-Id: <meta.public-inbox.org>

Eric Wong writes:

> In case users see "lei-daemon" in ps(1) or syslog and wonder.

Thanks, this is very helpful/informative.

> diff --git a/Documentation/lei-daemon.pod b/Documentation/lei-daemon.pod
[...]
> +=head2 SOCK_SEQPACKET
> +
> +SOCK_SEQPACKET sockets are used for both communicating with
> +L<lei(1)> and to internal workers.  SOCK_SEQPACKET is guarantee
> +reliability (unlike SOCK_DGRAM), allows easy load distribution,

s/is guarantee/guarantees/ ?

> +and saves developers the trouble of maintaining stream parsers.
> +
> +=head2 File monitoring

Obviously unimportant, but this casing is inconsistent with some of the
titles above (e.g., "file descriptor passing").

> +Inotify or EVFILT_VNODE is used depending on the platform
> +to monitor Maildirs of changes and track keyword changes.

s/of changes/for changes/ ?

> +The listen socket at (default: C<$XDG_RUNTIME_DIR/lei/5.seq.sock>)

I stumbled parsing this because target of "at" is parenthesized.  At
least in my head, it'd read fine dropping the "at".

> +is also monitored, and the daemon will automatically shutdown
> +if it is unlinked.