From owner-freebsd-doc@freebsd.org Fri Feb 12 14:09:48 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 986E454E64B for ; Fri, 12 Feb 2021 14:09:48 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: from smtp.freebsd.org (smtp.freebsd.org [IPv6:2610:1c1:1:606c::24b:4]) (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 "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Dcb3c3pcPz4tbs; Fri, 12 Feb 2021 14:09:48 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: from mail-lf1-f51.google.com (mail-lf1-f51.google.com [209.85.167.51]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) (Authenticated sender: carlavilla) by smtp.freebsd.org (Postfix) with ESMTPSA id 6F40F1F55; Fri, 12 Feb 2021 14:09:48 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: by mail-lf1-f51.google.com with SMTP id w36so13279809lfu.4; Fri, 12 Feb 2021 06:09:48 -0800 (PST) X-Gm-Message-State: AOAM5324YcLVGY2ZBzJX0XWxgrZCC4EdWAPQIzE5klTEA2vVbUd5Zfo+ kjtHY27PLKG3v/87hG5iKa01D/FXz2WJK3Xd5vM= X-Google-Smtp-Source: ABdhPJwR0GHlpmePs07qTwiKMPY50NxIMmDSlopScHVhzvp54t0EHjW7IxQXM9F4wjRB2NkoT8ZaV5hSWAZ/TEI7dEY= X-Received: by 2002:a05:6512:1108:: with SMTP id l8mr1588355lfg.255.1613138986766; Fri, 12 Feb 2021 06:09:46 -0800 (PST) MIME-Version: 1.0 References: <20210210135028.u2mm3bhwgep557vu@nerd-thinkpad.local> <20210210140716.pr6up7uxjdf2gydu@nerd-thinkpad.local> <20210210160348.xfy3un6bx5u7cqvj@nerd-thinkpad.local> In-Reply-To: From: Sergio Carlavilla Date: Fri, 12 Feb 2021 15:09:35 +0100 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: Regarding AsciiDoctor and long lines To: Daniel Ebdrup Jensen , freebsd-doc@freebsd.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Content-Filtered-By: Mailman/MimeDel 2.1.34 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 14:09:48 -0000 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 diff= s 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 tools= . Maybe we can talk with the AsciiDoctor team. Bye.