Regarding AsciiDoctor and long lines
Daniel Ebdrup Jensen
debdrup at FreeBSD.org
Tue Feb 16 07:48:13 UTC 2021
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
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 618 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20210216/6d7dca04/attachment.sig>
More information about the freebsd-doc
mailing list