From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: AS53758 23.128.96.0/24 X-Spam-Status: No, score=-4.0 required=3.0 tests=AWL,BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI,SPF_HELO_PASS,SPF_PASS shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by dcvr.yhbt.net (Postfix) with ESMTP id A80671F5AE for ; Thu, 13 May 2021 20:23:16 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232802AbhEMUYY (ORCPT ); Thu, 13 May 2021 16:24:24 -0400 Received: from pb-smtp21.pobox.com ([173.228.157.53]:56703 "EHLO pb-smtp21.pobox.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232170AbhEMUYX (ORCPT ); Thu, 13 May 2021 16:24:23 -0400 Received: from pb-smtp21.pobox.com (unknown [127.0.0.1]) by pb-smtp21.pobox.com (Postfix) with ESMTP id 5997D11D3F6; Thu, 13 May 2021 16:23:13 -0400 (EDT) (envelope-from junio@pobox.com) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=pobox.com; h=from:to:cc :subject:references:date:in-reply-to:message-id:mime-version :content-type:content-transfer-encoding; s=sasl; bh=+stsvTh+ZiiZ d3hhRIXKXa2ligGvBX7W2XhXP5p//6Q=; b=KLpIl9pTzGyHpHYe3mx4qQGDZttR nkZY3uVjpPQ6KvCKji5YgqczJgRu5Ex0OVZQdv57iaqNhAvbmpl9w0doQRDBI/Xr T4uC125o/aslZIA5/0IF5QXM3Pkt/tEc4RU6sJMQ+JG3DEQ3tz1zpa/5eMYwk+SH S++LSs8FQkYvYZY= Received: from pb-smtp21.sea.icgroup.com (unknown [127.0.0.1]) by pb-smtp21.pobox.com (Postfix) with ESMTP id 44E9B11D3F5; Thu, 13 May 2021 16:23:13 -0400 (EDT) (envelope-from junio@pobox.com) Received: from pobox.com (unknown [34.74.119.39]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by pb-smtp21.pobox.com (Postfix) with ESMTPSA id 707D111D3F4; Thu, 13 May 2021 16:23:09 -0400 (EDT) (envelope-from junio@pobox.com) From: Junio C Hamano To: Martin =?utf-8?Q?=C3=85gren?= Cc: Felipe Contreras , Bagas Sanjaya , Git Mailing List , "brian m . carlson" , Jeff King Subject: Re: [PATCH] INSTALL: note about make man with Asciidoctor backend References: <20210512064128.15411-1-bagasdotme@gmail.com> <609b8e214e1b6_6e4e92087e@natae.notmuch> Date: Fri, 14 May 2021 05:23:07 +0900 In-Reply-To: ("Martin =?utf-8?Q?=C3=85gren=22's?= message of "Thu, 13 May 2021 15:41:11 +0200") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 X-Pobox-Relay-ID: 0888C160-B429-11EB-AD41-D609E328BF65-77302942!pb-smtp21.pobox.com Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Martin =C3=85gren writes: >> > Bagas Sanjaya writes: >> > >> > > + You can also do "make man" using Asciidoctor's manpage backend= in >> > > + place of xmlto by passing USE_ASCIIDOCTOR_MANPAGE=3DYesPlease.= Version >> > > + 2.0 or later is highly recommended, as these version properly = handle >> > > + apostrophes. >> ... > > Even early 2.0.x had some issues [1]. It's always debatable whether the= y're > significant or not, i.e., is a significant speed-up worth it if the > result is just-as-informative-but-a-bit-ugly-here-and-there? We should > provide some rough background here to help people and distros decide. What does "properly handle apostrophes" refer to exactly? I got an impression that it was the pretty-quoting that breaks cut-and-paste, which is a usability issue for manpages. > Maybe something like > > "This can be quite a bit faster and requires fewer dependencies, but > please note that this is early work: there are some typographical > issues we know of, and there might be others." > > but hopefully phrased better than that. That looks like a good starting point.