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,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 0FABC1F5AE
	for <meta@public-inbox.org>; Thu, 29 Apr 2021 01:39:35 +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=1619660372;
	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=cSD9uiSjQnskjSUaTzPoGQhw0KBWvdzLxYmnkpA0hrU=;
	b=w0S2sqQldFzA0CLNo+ylzbP7bWSFPpa7KHQAXmSOBylE0bbUx6EB0MQ/QvW9PvAe3LcX++
	pQ64L3GJ0fEZBd+ZjwTWZTXeWGfW4aUiUnMBGLO1YbRm9sldSqhYazotIFFAa4B/q0TUOB
	PNMR0aYszqc9ydtZOj0dnOZnQ6U7u8af6cOTHK21/wMm5dPetkaVMg4ZnLl4cOCswZkAK2
	TFYVTcdVI3bVRilJRv89v9TSERlUqFz8E/HrHphlINuN1g0+yi2Qj5Eq9TXJ6nz7ILv+QE
	/Q2v/U35gi+hDnjDCutGI0nkxWe0crHOV6acgkJj/7fR5HsouZOu/MM2I7SVqA==
From: Kyle Meyer <kyle@kyleam.com>
To: Eric Wong <e@80x24.org>
Cc: meta@public-inbox.org
Subject: Re: [PATCH 2/3] doc: lei q: split =item aliases onto separate lines
In-Reply-To: <20210428045107.9699-3-e@80x24.org>
References: <20210428045107.9699-1-e@80x24.org>
 <20210428045107.9699-3-e@80x24.org>
Date: Wed, 28 Apr 2021 21:39:31 -0400
Message-ID: <87o8dxg97w.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:

> It makes L</--augment> look nicer without resorting to
> L<--augment|/-a, --augment> and similarly verbose nastiness.
>
> Having each option as a separate =item (with a blank line in
> between each =item) seems to be the preferred style used within
> Perl core documentation (I used perlrun.pod as an example),
> so we'll follow Perl core style, here.

Okay, thanks providing a rationale for using separate lines.  I went
with the single line style based on some combination of a subjective
visual preference and looking at other manpages (presumably git's).

> This needs to be done for other manpages, at some point...

I should be able to get to another round of lei doc updates this
weekend.