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>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --] On Mon, Feb 15, 2021 at 07:05:09PM +0100, Marc Fonvieille wrote: >Le 12.02.2021 18:24, Sergio Carlavilla a écrit : >> >> 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. > >-- >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? Yours, Daniel Ebdrup Jensen [-- Attachment #2 --] -----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-----home | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20210216074810.qwaotlonqdaulvk2>