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