From owner-freebsd-doc@freebsd.org Tue Feb 16 14:16:21 2021 Return-Path: Delivered-To: freebsd-doc@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 93E9E53977F for ; Tue, 16 Feb 2021 14:16:21 +0000 (UTC) (envelope-from debdrup@freebsd.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2610:1c1:1:6074::16:84]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "freefall.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Dg31K3lMjz3w1t for ; Tue, 16 Feb 2021 14:16:21 +0000 (UTC) (envelope-from debdrup@freebsd.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1613484981; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=Ik5hgFb49+9FZdTVYa0k+2fW6IFBCz1W6dnGBAZm+oE=; b=xF8NKjqkXc8PIZeGGwrFkT4WRR0ukWB820b8zjswiZHPsc7dVL2EgO2oxlk8/yldEtU9Mi ld9P0HfMAjou8i4hqJOa70k8/xkJWXQ+C/4Ur+MDzYr5uH9w2zOirp7/cx4dnbpU8YKR94 1RMBywzGGVyStA+ONt3dZKt2ljkr7vakeiqYvMtoi9074jSedsWRxyMiIJLWeeHsuhFw1b VeK9PUhHeytskNW2vyEsE3fUBM6HFsqtEhfN8fc9/4LUQqPPSqgu0Wzg+co9WUyE7hsGxs X7s2iFfxGWKZULQTqQdRR2P9JGLeyOmuEt0pXEIVzZ+GUpv/x8X954eLKuAHnw== Received: by freefall.freebsd.org (Postfix, from userid 1471) id 74DD02ACD; Tue, 16 Feb 2021 14:16:21 +0000 (UTC) Date: Tue, 16 Feb 2021 15:16:20 +0100 From: Daniel Ebdrup Jensen To: freebsd-doc@freebsd.org Subject: Re: Regarding AsciiDoctor and long lines Message-ID: <20210216141620.k4rwqtvwfnhk7xty@nerd-thinkpad.local> Mail-Followup-To: Daniel Ebdrup Jensen , freebsd-doc@freebsd.org References: <20210210160348.xfy3un6bx5u7cqvj@nerd-thinkpad.local> <20210212170859.lzzj5qrriovjd2ux@nerd-thinkpad.local> <20210216074810.qwaotlonqdaulvk2@nerd-thinkpad.local> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="rsdh7ahyvm7qxe5e" Content-Disposition: inline In-Reply-To: ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1613484981; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=Ik5hgFb49+9FZdTVYa0k+2fW6IFBCz1W6dnGBAZm+oE=; b=Q1TpLqmFApbTPORwE4hDU6tEqpxGJoh0n9QXj2fP09W446MsBZVPSxLPg1jjndhgOMXckD A4693GjtcjiJUZtGWVs9eM4BZGraPsIUuzZ3V4T3vOqiSgLzbhr/9BVo9d9iitmvQlfCzd S5uvZcGHOcgO8Rh4F1Ph4ZJpo+bX4qHyzqSBbkG65T8/Lw5difYfoFPAxLMiYuw8QuZd8j bqDoIdFnfn/ALjQx/xcen1jOpq+P+TRiL9vwtYWK+hyLMDrpWSaMlPf5cdBDMy+oi4eVka Gh9Ni8Zfe1HlsVuUjrEomgwA3KpRxwn75tfsIDkC/gLREGBMWQr2jzVr4+6KEQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1613484981; a=rsa-sha256; cv=none; b=IqQMFMKWgsGjwh2AkB4G0+Jg9xvp7tA11dSX+4L2ZMZBToFzpPMEFl6FtzOgRfFLHzLVv+ e27gwUWnczCG7PcbO7vohFDwGdca1pTeTtGi+o/a7wduaMhRUBpM7+0SdPEpy8Ubc7twsX uMlAFAidqA9ADmXj/0ngvjgenbPfcn42DzVK0HiF9BbwLwqmaO0fMHFvAK/2WKvKMkdD2X dNBU/S+ySNFBL361oO28bUHsv2Hoy7rrd5SLarJzjxuuk+Lyf6w3p2j0RJhqvA2FXnAvZK k9Fu/D/R/PMIXbF07CrJI5nwxXSx/Kcgs4ydJF46zcPNvPDLzJXbshS9FU6cMw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 16 Feb 2021 14:16:21 -0000 --rsdh7ahyvm7qxe5e Content-Type: text/plain; charset=iso-8859-1; format=flowed Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Feb 16, 2021 at 01:01:45PM +0000, Ceri Davies wrote: >On Tue, 16 Feb 2021 at 07:48, Daniel Ebdrup Jensen >wrote: > >> On Mon, Feb 15, 2021 at 07:05:09PM +0100, Marc Fonvieille wrote: >> >Le 12.02.2021 18:24, Sergio Carlavilla a =E9crit : >> >> >> >> I think the doceng team should pronounce about this. >> >> >> >> IMHO, use the 72 characters per line would be a problem in the future. >> >> >> > >> >Why it would be a problem? >> > >> >-- >> >Marc >> >> Hi folks, >> >> Can we make a compromise where real paragraphs, ie. the only things >> which don't seem to need much in the way of AsciiDoctor markup, are kept >> at 72 columns, and headings, lists, images, include macros, variables >> and custom macros are allowed to go beyond the 72 columns? >> If they have to, there's always word-smithing options for trying to be >> as concise as possible (without, of course, making things too obtuse - >> it's a tough balance, admittedly? >> >> That seemed to work for DocBook, so is there a reason it won't work >> here? >> > > For HTML output it doesn't look like it's an issue; although whitespace >is preserved in the output, it's luckily irrelevant to HTML output. > >For other output formats such as PDF or mdoc then I can see that it is >problematic to hard wrap text but that suggests that there's a tooling >issue; Marc's need to be able to actually see what has changed is really >important. > >Butting out for another 9 years now :D > >Ceri I don't see how mdoc would be impacted, since that lives in the src=20 repo. As for pdf files, I couldn't tell you the last time I used the handbook=20 in a pdf format, so I had to generate it by grabbing asciidoctor-pdf=20 and running it on doc/documentation/content/en/books/handbook/book.adoc -= =20 and it produced [1]. Aside from things which I think can be addressed separately, the change=20 I made in order to test the theories that pdf should work with extra=20 linebreaks inserted at 72 columns, is on page 21, on the paragraph=20 "The hardware requirements to install FreeBSD vary by.." To me, this looks exactly like how I would expect it to look. So I think we'll be fine with this change, at least for newlines as it=20 relates to paragraphs. Yours, Daniel Ebdrup Jensen [1]: https://people.freebsd.org/~debdrup/book.pdf --rsdh7ahyvm7qxe5e Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQGTBAABCgB9FiEEDonNJPbg/JLIMoS6Ps5hSHzN87oFAmAr07RfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDBF ODlDRDI0RjZFMEZDOTJDODMyODRCQTNFQ0U2MTQ4N0NDREYzQkEACgkQPs5hSHzN 87oLfAf8CIjU2yDRT9Cck/ShiTpobO2RvDPri9ZzTjq7JfoFUQLCEdf/9q8JxtLI 8gT6zY9EpSOCWlfFhO5I1zDE0Y8dDcnwrq/+qTbK+ah2Pw3AI+E7TZ5Tv8RAKgpg HEzIg8PSn7pAGpw4l3AoLSW3Hzs7YY7uOsf14vSDHX9D+qHbkC5cW4k53shcWwsd FkBdEgUqTAQtIWF9ftN8f8H8qFiOYOAa4BOgr4yUzGLhNoVgyw7Jo5lZHIxnt0f6 NE1jpiwLj3EsxXKyoMCqAcNz0ptZUBrJp0g35FE19Jxtr3AlBZ1SioSFGU01sPbr NkRze/R9MfMdS13AXO2PGLsxAi7gXA== =21Kj -----END PGP SIGNATURE----- --rsdh7ahyvm7qxe5e--