Date: Tue, 16 Feb 2021 08:48:10 +0100 From: Daniel Ebdrup Jensen <debdrup@FreeBSD.org> To: freebsd-doc@freebsd.org Cc: Sergio Carlavilla <carlavilla@freebsd.org>, Doc Manager <doceng@freebsd.org> Subject: Re: Regarding AsciiDoctor and long lines Message-ID: <20210216074810.qwaotlonqdaulvk2@nerd-thinkpad.local> In-Reply-To: <YCq31UMUj8DH2En3@emphyrio.blackend.org> References: <20210210140716.pr6up7uxjdf2gydu@nerd-thinkpad.local> <CAFwocyNttBcOvyYVcs9Mp12bEmiWFCV3vWZCxnixc2QjmQ9%2ByA@mail.gmail.com> <c7d36625-0688-9ebb-de03-0e9b5eb55a82@freebsd.org> <20210210160348.xfy3un6bx5u7cqvj@nerd-thinkpad.local> <YCZ4TedB5G1sI8L1@emphyrio.blackend.org> <CAFwocyOYepw%2BntThzGp8ZNKQrPHm9bzgK60_fpfu1BZ5v39y9Q@mail.gmail.com> <20210212170859.lzzj5qrriovjd2ux@nerd-thinkpad.local> <CAFwocyOdSqnVUcRgUhiecXvG2qGasnL2VU0JugwEVc-WuvJxOg@mail.gmail.com> <CAFwocyOBLW0Siwtk0A%2BQox_MQt4KqCnMvHa_1s23RmjqqmLUkw@mail.gmail.com> <YCq31UMUj8DH2En3@emphyrio.blackend.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--7gtdcxqxk4vugbmc Content-Type: text/plain; charset=iso-8859-1; format=flowed Content-Disposition: inline Content-Transfer-Encoding: quoted-printable 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? >With the current setup, we can't really use the diff and the commit >logs. Paragraphs are now single long lines. For a single character >change, we now commit hundreds of characters instead of 72 in the worst >case in past. Just from a sustainability point of view, I'm concerned >about that situation. > >--=20 >Marc Hi folks, Can we make a compromise where real paragraphs, ie. the only things=20 which don't seem to need much in the way of AsciiDoctor markup, are kept=20 at 72 columns, and headings, lists, images, include macros, variables=20 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=20 as concise as possible (without, of course, making things too obtuse -=20 it's a tough balance, admittedly? That seemed to work for DocBook, so is there a reason it won't work=20 here? Yours, Daniel Ebdrup Jensen --7gtdcxqxk4vugbmc Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQGTBAABCgB9FiEEDonNJPbg/JLIMoS6Ps5hSHzN87oFAmAreLpfFIAAAAAALgAo aXNzdWVyLWZwckBub3RhdGlvbnMub3BlbnBncC5maWZ0aGhvcnNlbWFuLm5ldDBF ODlDRDI0RjZFMEZDOTJDODMyODRCQTNFQ0U2MTQ4N0NDREYzQkEACgkQPs5hSHzN 87pUxwf/d0/erVFipgUWq+qU5yHG3ivhEKxjW0gSQOh89tQctFU4DRaN6dn0TSeh WYvmZHn8W/t720HObpzs0oky+QCSWbMC4oZqWYoeByPI6p97l2r/YnUH3FLVulLF HbhjhvpLAgT0ELqh2HODzkBs7XsIgVvK593oExwSY3ZZTOXoPrUpbTtwVzoLXS1p 1HQqW1B1HRIFjVdGqnPlh2OPzH+kLx2hnFJ2BJDwcMtqznvJCUnzcKTjjsTCxcsO pqHPGkCSRhC0YZpJXY3C92guC4Uf69FuC0csaylX2I/13/ht5dxaEDIXVE05Kc4A 6kIrRiRHR7jWvYMnUYKYgM7Xu1SBBw== =rZ8Q -----END PGP SIGNATURE----- --7gtdcxqxk4vugbmc--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20210216074810.qwaotlonqdaulvk2>