From owner-freebsd-doc@freebsd.org Fri Feb 12 17:09:00 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 CBC6F52A199 for ; Fri, 12 Feb 2021 17:09:00 +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 4Dcg2N5Q9Hz3M9X for ; Fri, 12 Feb 2021 17:09:00 +0000 (UTC) (envelope-from debdrup@freebsd.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1613149740; 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=36okja/zQO3qG07zTGHEVDz/rZxLjneIwbSYjWaboqc=; b=fRXuuEljT09hrZeSJ71B8WrOQU/xM2eDuXQ8cLeO+cjEiiLuKlDlPcyomr1roz5yghY1Dp 1nKbIxVonmXhoUqdobTy1SXG4/1WLbjnsCRrh4PdIjitgSUyXlIJWy71yL9A9kefbQEmQo oS0ywm3RMoZl9bmDyQDWQRRaBXWTO5ODkbcIS1kZqwc9d92S1QTJJRJrNTN/6DOmLjlGKA rTiwT4QG0IupKWgaxZXA2+i0suRAUQMf+5ASQSxueyhzaeFdJXPBDFUAAVnatbIGldU+8x dUSCyLawRvzcGPGPEMT+0q7swElFfsO2qC2RgoqwYEE0cRWQUJF8vQn6/IQ5ng== Received: by freefall.freebsd.org (Postfix, from userid 1471) id AEC221988D; Fri, 12 Feb 2021 17:09:00 +0000 (UTC) Date: Fri, 12 Feb 2021 18:08:59 +0100 From: Daniel Ebdrup Jensen To: freebsd-doc@freebsd.org Subject: Re: Regarding AsciiDoctor and long lines Message-ID: <20210212170859.lzzj5qrriovjd2ux@nerd-thinkpad.local> Mail-Followup-To: Daniel Ebdrup Jensen , freebsd-doc@freebsd.org References: <20210210135028.u2mm3bhwgep557vu@nerd-thinkpad.local> <20210210140716.pr6up7uxjdf2gydu@nerd-thinkpad.local> <20210210160348.xfy3un6bx5u7cqvj@nerd-thinkpad.local> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="ddwnosrx4pz3qf2y" Content-Disposition: inline In-Reply-To: ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1613149740; 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=36okja/zQO3qG07zTGHEVDz/rZxLjneIwbSYjWaboqc=; b=R5F8Dl8ekWpZBmOkwPExpM56RRdfGAGD3J1pIh40GdebLCTT8VzxNczCUvlctyJo0c6v8Z PNVbfnbhyyIE7t8D0+PAe0fPPMewoVbe7oxnCZ9z8FQqEbOzPD3HV2HTlgkggfwMJCVYnA 1rfFuuIE+Uqs3DzvY+Fadvr3xEIWwtehJjuF+C/+rS2H9Ns4je6CyLwD90Sg+tWXQoDYbd uZ2yhHZ6JwcxKrRBgWJAa4jTXSlpHQFdUg1qkpK/XwZJSr9wu77xySpzwYFgL1p/eUmEjV gkqtmkWmLDsbTtsovVmoxN+yvsnSeBV9mhw4qK6jtaHztF36OYPYUvLV0/4uEg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1613149740; a=rsa-sha256; cv=none; b=hCHGSkfrozldb2w+D5gehn6ZPaIZMNjgJd4OgsZnqUo/SjuNb89mqsLPy38J5BBSSF/JPZ qCm3VOWyS/j/WNLEVNeGmcjnPQACIjilr9iCMrLuBGZfbYtlOYqg9vf3adbXvJnfLgk4As jXKdQY13/pH9QfoAGEg8rw7/N37gNrMpDy3YlsnNpcG7PIEpj/EowG/h8hM5EtOERhw6rY HqLw6csBwYQXFg9TnvxATIkWt3ToBaqIwQo0izbdTMer4qR2xGnXq22+QhBEwT+bya1NUf TZu9Zn5DDykqlxGbs3b0BEJBb0kF3j2mVmsHZsakHpjIyNwrcKNYjG78thvxXw== 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: Fri, 12 Feb 2021 17:09:00 -0000 --ddwnosrx4pz3qf2y Content-Type: text/plain; charset=utf-8; format=flowed Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Feb 12, 2021 at 03:09:35PM +0100, Sergio Carlavilla wrote: >On Fri, 12 Feb 2021 at 13:45, Marc Fonvieille wrote: > >> Le 10.02.2021 17:03, Daniel Ebdrup Jensen a =C3=A9crit : >> > Yeah, I'm perfectly fine with doing it like how manual pages work, ie. >> > the one-sentence-per-line workflow, if I understand it. >> > >> >> One sentence per line makes the read of diff/commit logs really >> difficult. I gave up reading the commit logs because of that. >> It's really a pain to find what changed without even talking about the >> edition of a long non-wrapped line in an editor. >> Some languages are very verbose, so we would end with very long lines. >> For a such change seems so backward. >> >> > I'll be re-working the handbook/x11 chapter to that at some point. :) >> > >> >> Please don't. >> >> -- >> Marc >> >Hi, > >I know that this approach it=E2=80=99s causing some confusion with the dif= fs tools. >But instead of using a different way that recommended from the AsciiDoctor >team I think we should try to focus on getting a solution in the diff tool= s. > >Maybe we can talk with the AsciiDoctor team. > >Bye. Hi folks, Marc does have a point, which I think is quite valid. A lot of people do reviews of code in the email they're sent, where - at least for the commits, it's inlined - and pursuant to discussions about this elsewhere, that doesn't seem likely to be changing any time soon. If diffs were attachments with the text/x-patch or text/x-diff mime-type, it'd be up to peoples MUA and possibly their .mailcap as to how it should be opened, but that's not something that's doable with the current setup. So I do think wrapping to 72 columns is the better option here, if we want to retain the broadest review possibilities. Yours, Daniel Ebdrup Jensen --ddwnosrx4pz3qf2y Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQGTBAABCgB9FiEEDonNJPbg/JLIMoS6Ps5hSHzN87oFAmAmtitfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDBF ODlDRDI0RjZFMEZDOTJDODMyODRCQTNFQ0U2MTQ4N0NDREYzQkEACgkQPs5hSHzN 87ruqggAptPGUxb356jHVlLeu45fEX0sK25gTIxVNgIseiLtA8nO+i4eygfq+JWW qy0xDNQ8kk+KE94+ucF47zO1Y0JLAzEg6pqMc7yNry4cPDCWfRx+ktyZS0196pzS QxVkqoqLc4Alk4MLFQqbNWAR9FpMJXbXUvWoUqx4FEFJ+dIpgEuGpwhMCitbof7o aiE/6nqTTXKFfLaAN5rYj0WxIap5F44Zdf0dgff/eNQJB6wtq6XhiPW+DOB+r5nX MPQ2+TmKum7QNUNDCgG/R3FL65Md/ujPwo3RvEPXUHpcFn+YpBF6oJ8505BzD27k b9A7ZI08nsjX2OvFJWjpKd42IwKydw== =UvLm -----END PGP SIGNATURE----- --ddwnosrx4pz3qf2y--