From owner-freebsd-doc@freebsd.org Tue Feb 16 13:02:25 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 F231853798F for ; Tue, 16 Feb 2021 13:02:25 +0000 (UTC) (envelope-from ceri@submonkey.net) Received: from mail-ej1-x632.google.com (mail-ej1-x632.google.com [IPv6:2a00:1450:4864:20::632]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Dg1N11F35z3qsb for ; Tue, 16 Feb 2021 13:02:24 +0000 (UTC) (envelope-from ceri@submonkey.net) Received: by mail-ej1-x632.google.com with SMTP id y26so16309346eju.13 for ; Tue, 16 Feb 2021 05:02:24 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=submonkey-net.20150623.gappssmtp.com; s=20150623; h=mime-version:references:in-reply-to:from:date:message-id:subject:to; bh=m2c4ufXDUoUI20oX0Jr/io2aIDF3jLxPihCq7UWEtEk=; b=NIubdRlRfdNIrIPi9UWztw1mJHKPHHzVy0saIgsB+7OhLsTDQ94XYlbKccd2Hd8YKd eYN5g7/Lg8VHZNUF1YQcEiPdC6rj+39n50ZhUM7ihHTO3f9nxX8JJvIwLYAhHCoS6J8a z4y+dGGhxRnVhHRnbX1XrD7aYoJjNQf/Dl08YNjKKnEBpP9Qno2+raQTMovgW6x1Y0Ow dYmVhNAuhuds3N956EiaZ1j8D3rzSQqhZ7je3pwDx8kcnQUBBgxWc874vfXc/8WebysJ Iy1HceW1KHyomUVOmm4VZCmMTvfVsfDspNGmJ+jHe7zCtL/T8/pOWTjF9c3zGg9xXVZA h2sQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to; bh=m2c4ufXDUoUI20oX0Jr/io2aIDF3jLxPihCq7UWEtEk=; b=c4AlM3chPnaF0yTAWggEoyuxRfhz+RYd0Kv4Y+va1sdLWr8nWniOWo4fbpyQg0sJRE eez8VTYW0wcu0q3P9sErwqGuQfqGG4CgU97LJMAAIsB1fDlR8jOLbkukDc/oZsimJWM7 9XpC/OcMXxY20CnZ2LYQ+HLhmAlayeWUR9kjaUyr/ESdPUne1NuuT3O2QVL/2h5V0Kq0 8wj5mFP5GPpKjeU+5Bx3YX+j8Cnpz/8O+W/UjfLX30TBo2d1ahBhEvSBw9yDwM1cOzll pIThwUP2Qo4J9kAEBJp5I8VEyqV/k+hE32SxmaDZHDCh1SPWcdBBgWofsVySjiQaqs7m ZC+A== X-Gm-Message-State: AOAM532ImYz/LQP6jfjQsqVCIeto9hzU6BwqSodbO55FMm4HxjSYteY4 NK2BkJQVAmU7a6lDm23PfwwNuI6b26cip49VfgA6z7/mQP6IKoPu X-Google-Smtp-Source: ABdhPJyZUpuNcBndQapsX/XAPjTd1NuqKJBdJZK+XZ3j37Pdxg2SSB6sCtwHJ4pbmsCKFkBXiAaXgtfVNTa1B3f9Zdc= X-Received: by 2002:a17:906:e284:: with SMTP id gg4mr2233634ejb.546.1613480543013; Tue, 16 Feb 2021 05:02:23 -0800 (PST) MIME-Version: 1.0 References: <20210210140716.pr6up7uxjdf2gydu@nerd-thinkpad.local> <20210210160348.xfy3un6bx5u7cqvj@nerd-thinkpad.local> <20210212170859.lzzj5qrriovjd2ux@nerd-thinkpad.local> <20210216074810.qwaotlonqdaulvk2@nerd-thinkpad.local> In-Reply-To: <20210216074810.qwaotlonqdaulvk2@nerd-thinkpad.local> From: Ceri Davies Date: Tue, 16 Feb 2021 13:01:45 +0000 Message-ID: Subject: Re: Regarding AsciiDoctor and long lines To: Daniel Ebdrup Jensen , freebsd-doc@freebsd.org, Sergio Carlavilla , Doc Manager X-Rspamd-Queue-Id: 4Dg1N11F35z3qsb X-Spamd-Bar: --- Authentication-Results: mx1.freebsd.org; dkim=pass header.d=submonkey-net.20150623.gappssmtp.com header.s=20150623 header.b=NIubdRlR; dmarc=fail reason="No valid SPF, DKIM not aligned (relaxed)" header.from=submonkey.net (policy=none); spf=none (mx1.freebsd.org: domain of ceri@submonkey.net has no SPF policy when checking 2a00:1450:4864:20::632) smtp.mailfrom=ceri@submonkey.net X-Spamd-Result: default: False [-3.20 / 15.00]; RCVD_TLS_ALL(0.00)[]; ARC_NA(0.00)[]; R_DKIM_ALLOW(-0.20)[submonkey-net.20150623.gappssmtp.com:s=20150623]; FREEFALL_USER(0.00)[ceri]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_THREE(0.00)[4]; TO_DN_SOME(0.00)[]; NEURAL_HAM_LONG(-1.00)[-1.000]; MIME_GOOD(-0.10)[multipart/alternative,text/plain]; PREVIOUSLY_DELIVERED(0.00)[freebsd-doc@freebsd.org]; NEURAL_HAM_MEDIUM(-1.00)[-1.000]; SPAMHAUS_ZRD(0.00)[2a00:1450:4864:20::632:from:127.0.2.255]; TO_MATCH_ENVRCPT_SOME(0.00)[]; DKIM_TRACE(0.00)[submonkey-net.20150623.gappssmtp.com:+]; NEURAL_HAM_SHORT(-1.00)[-1.000]; RCVD_IN_DNSWL_NONE(0.00)[2a00:1450:4864:20::632:from]; R_SPF_NA(0.00)[no SPF record]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+,1:+,2:~]; RBL_DBL_DONT_QUERY_IPS(0.00)[2a00:1450:4864:20::632:from]; ASN(0.00)[asn:15169, ipnet:2a00:1450::/32, country:US]; RCVD_COUNT_TWO(0.00)[2]; MAILMAN_DEST(0.00)[freebsd-doc]; DMARC_POLICY_SOFTFAIL(0.10)[submonkey.net : No valid SPF, DKIM not aligned (relaxed), none] 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: Tue, 16 Feb 2021 13:02:26 -0000 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 =C3=A9crit : > >> > >> 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