From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <e@80x24.org>
X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net
X-Spam-Level: 
X-Spam-ASN:  
X-Spam-Status: No, score=-4.0 required=3.0 tests=ALL_TRUSTED,BAYES_00,
	T_SCC_BODY_TEXT_LINE shortcircuit=no autolearn=ham autolearn_force=no
	version=3.4.2
Received: from localhost (dcvr.yhbt.net [127.0.0.1])
	by dcvr.yhbt.net (Postfix) with ESMTP id 85D111F8C4;
	Tue, 22 Mar 2022 09:07:51 +0000 (UTC)
Date: Tue, 22 Mar 2022 09:07:51 +0000
From: Eric Wong <e@80x24.org>
To: Uwe =?utf-8?Q?Kleine-K=C3=B6nig?= <u.kleine-koenig@pengutronix.de>
Cc: meta@public-inbox.org
Subject: Re: dependency Socket::MsgHdr undocumented
Message-ID: <20220322090751.GA11365@dcvr>
References: <20220311133808.22jnjv2b6eplerq5@pengutronix.de>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <20220311133808.22jnjv2b6eplerq5@pengutronix.de>
List-Id: <meta.public-inbox.org>

Uwe Kleine-König <u.kleine-koenig@pengutronix.de> wrote:
> Hello,
> 
> while packaging public-inbox 1.7.0 for Debian I noticed that the
> (optional) dependency on Socket::MsgHdr isn't described in the INSTALL
> document.

Right, I've been debating whether it's worth making INSTALL larger
for performance-only things, especially since it mainly affects
lei users.

Inline::C covers more functionality (at the expense of slow startup time);
I'm working on supporting this via pure-Perl for Linux users (the vast
majority), here, too.

Having too much in the INSTALL can be too intimidating, so I'm
trying to balance that out.  It's already in lei-overview(7);
and IIRC it only affects lei, atm.

> The Debian package is called libsocket-msghdr-perl, don't know about the
> others.

Yup, AFAIK Debian + derivatives are the only distros with it.

> Just a quick note to let you know ...

Thanks.  I do worry about the quantity of documentation + dependencies
being too intimidating to new users, especially for dependencies with
a narrow scope of usefulness and availability.

*shrug*