Date: Tue, 16 Feb 2021 13:01:45 +0000 From: Ceri Davies <ceri@submonkey.net> To: Daniel Ebdrup Jensen <debdrup@freebsd.org>, freebsd-doc@freebsd.org, Sergio Carlavilla <carlavilla@freebsd.org>, Doc Manager <doceng@freebsd.org> Subject: Re: Regarding AsciiDoctor and long lines Message-ID: <CAOa83AcBASoD=tOxx6xtAwtf5Wz7XeTm3qacBpM9dxYvX7C0LQ@mail.gmail.com> In-Reply-To: <20210216074810.qwaotlonqdaulvk2@nerd-thinkpad.local> 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> <20210216074810.qwaotlonqdaulvk2@nerd-thinkpad.local>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, 16 Feb 2021 at 07:48, Daniel Ebdrup Jensen <debdrup@freebsd.org> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAOa83AcBASoD=tOxx6xtAwtf5Wz7XeTm3qacBpM9dxYvX7C0LQ>