From owner-freebsd-doc@freebsd.org Wed Feb 10 14:07:18 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 03B0B547EF9 for ; Wed, 10 Feb 2021 14:07:18 +0000 (UTC) (envelope-from debdrup@freebsd.org) Received: from freefall.freebsd.org (freefall.freebsd.org [96.47.72.132]) (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 4DbM5d6lH5z4Wb0 for ; Wed, 10 Feb 2021 14:07:17 +0000 (UTC) (envelope-from debdrup@freebsd.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1612966037; 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=94p+U/9kAipF/yTZNKGHH2CGqKHje7XR4uCpr4bYTfU=; b=b+qDFo7vonoWx+NjHf4s5q1FYOYfwll3sZt2m30830j+i9PdZm1vIu/oJqRHbZ7vY1SpU9 sw83AbpIXhwa4QBCkeEzg8Pgiw7t5YnrZp4jV5/RpxBaGhDQwcdOFAnkxQdbRkr+C5qmET bkK2BWoPsEb6koA9yXcmrLaHoGkriyV7OD+DdLww7DNqE9H4mDWBY53lUO9KS6os1mjuLO OuzF93VL43KNH2MgBO/NP3VtYnM8cLrs8T9xIrFutC1QTXLJGxNTbQnFx56nbHB2ePgpSR LA0+HLa/o+Kkr2tPOxOkjP2h40XCtvzM5TrXf0HR2JVpqnyAl133Ojz9cvAZ2Q== Received: by freefall.freebsd.org (Postfix, from userid 1471) id E006BBEAC; Wed, 10 Feb 2021 14:07:17 +0000 (UTC) Date: Wed, 10 Feb 2021 15:07:16 +0100 From: Daniel Ebdrup Jensen To: freebsd-doc@freebsd.org Subject: Re: Regarding AsciiDoctor and long lines Message-ID: <20210210140716.pr6up7uxjdf2gydu@nerd-thinkpad.local> References: <20210210135028.u2mm3bhwgep557vu@nerd-thinkpad.local> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="ck6fjlkzsm4eqmjg" Content-Disposition: inline In-Reply-To: ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1612966037; 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=94p+U/9kAipF/yTZNKGHH2CGqKHje7XR4uCpr4bYTfU=; b=STH/MGAFB9jy0vn282J2u3+LylIhajwlKyQh4VFndU6oby0ie5MmYbtqqRLA8yLFtg2tfJ luQ/89t4ibF9+dcWgDFFUmM4z8ya1ihWbAGAo/GrVnXl9LMuYGS5eJ0MByRyv51AU7Rawt LlC65VtiXsPRNjV+tMS4R9MeIaomjHXXopjuSk6YaMrNDp1OZZPtkGYfXsh5AnnNlNuaph 10cyY9DZhuon31xJQ9+ge4xQLu1xZhsIUS4MSbUkkxZ7kgwuhcvBulV20F7t9pJntXfz4E ycAWC9+dZjWEeDAKTrrAFHBq0cTxFFM8HnAYjf4uRWT0B1e/tswaY1AVVw1SFg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1612966037; a=rsa-sha256; cv=none; b=pv8Pk2TgV2RVBhCZhxCuX+n5tafG1TLMo9sh4itfWYBaumqoxjn05bbC5/VPYZYqTOXrmQ Yy0GUMOTTVR5rJg52zpSO0zJZkKm5sAmTFSDdImJCVjlsdZS1kd4HsKF8Ra8YcXJGT1THI 8I7jmG6U+vI3evqCueRBjJjAwb1kQhIleI6OI3tN9Gxz3w2AJrcbnH4teJtsQk8akJP3I2 CX5PuuognvwfSjP3l9igvSNnbC5zPGCABGKimJO0miTEjDYu33A9Z6myElh6i7wIeSJiK9 UWbX1kLa8+nEG5f0MEe/76O8wRnZxhLKKOwKiRp6QQ6omGM3KcNUxEXvVDunRw== 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: Wed, 10 Feb 2021 14:07:18 -0000 --ck6fjlkzsm4eqmjg Content-Type: text/plain; charset=us-ascii; format=flowed Content-Disposition: inline On Wed, Feb 10, 2021 at 02:57:34PM +0100, Andreas B wrote: >Have you considered one sentence per line? > >Ref. https://asciidoctor.org/docs/asciidoc-recommended-practices/#one-sentence-per-line. > >Andreas > >On Wed, Feb 10, 2021 at 2:50 PM Daniel Ebdrup Jensen > wrote: >> >> Hi folks, >> >> Pursuant to a conversation that was had on #bsddocs on EFnet, this is >> mostly me wondering if we can adopt a new standard practice. >> >> Since the AsciiDoctor conversion, it's become evident that reading diffs >> which exceed the usual 72 columns that FreeBSD has standardized on for >> style(9) is less than great, especially as some of the sentences in the >> documentation can be rather long. >> >> So I would love if it we can agree to wrap/justify lines to 72 columns, >> going forward whenever we touch files. >> >> I've already started doing this on the handbook/x11 chapter update that >> I'm working on, and it's in line with what we're used to from DocBook, >> so I don't think it's too much of a big ask? :) >> >> We also need to decide about it relatively soon, since the Weblate >> project needs to know about about it, as it involves their use of .so >> files (although the details somewhat escaped me when I read it after >> staying up all night, so perhaps a domain expert can fill in the blanks >> here?). >> >> For reference, my testing had led me to believe that AsciiDoctor doesn't >> care one bit how it's styled, as long as the actual markup is kept the >> same. >> >> I'm open to feedback about it, of course, but it seems like a very >> sensible change to me. >> >> Yours hopefully, >> Daniel Ebdrup Jensen >_______________________________________________ >freebsd-doc@freebsd.org mailing list >https://lists.freebsd.org/mailman/listinfo/freebsd-doc >To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" Sure, that seems like a nice compromise. I mostly want some kind of consensus so we can move forward without having to deal with these extremely long lines. ;) Yours, Daniel Ebdrup Jensen --ck6fjlkzsm4eqmjg Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQGSBAABCgB9FiEEDonNJPbg/JLIMoS6Ps5hSHzN87oFAmAj6JRfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDBF ODlDRDI0RjZFMEZDOTJDODMyODRCQTNFQ0U2MTQ4N0NDREYzQkEACgkQPs5hSHzN 87pIxgf4yS9Sgck7ysrufZKHFBFUVAW4yxvJm/COs12w8rFsMgm3OWhK8X0D43IV CS6vzGGt5fzkUeA9cCUbzMEPe3jshbEPy0LhyuosAWmE5UCn53xk+BlxfQjSD1DU VJrAXV+ZTvJwhsQU2H5dMwX9Ltsnk8KYF1ZwDojwCh5q3h3Dua4XlRNmiOntGa4V 1OFmS/TmyOtk5LSj91hE25vjie1Lv64qrOYz2HrrfIKJFaL0x+80RofHUqt4yU/v VhPGfbx0S11X9ISSTKJLquQbm4kIce+bOx958Q4fdeZW1St56jduTGSmVliMHzAA /RQiaxFdNaoH9W9HIm8DNgsC1O/r =Zplf -----END PGP SIGNATURE----- --ck6fjlkzsm4eqmjg--