Daniel P. Berrangé <berra...@redhat.com> writes: > On Thu, Sep 09, 2021 at 11:33:20AM +0200, Markus Armbruster wrote:
[...] >> There are many existing long lines in this file, so I'm not flagging >> yours, except for this one, because it increases the maximum. > > This line is at exactly 80 characters so checkstyle is happy with it. > We don't have any requirement for a differenet line limit for docs > afair ? We don't. I'm asking for a favour. Humans tend to have trouble following long lines with our eyes (I sure do). Typographic manuals suggest to limit columns to roughly 60 characters for exactly that reason[1]. 70 is a reasonable compromise between legibility and "writability". For code, we use 80-90, because there the actual width should still be fine due to indentation. checkpatch.pl doesn't differentiate betwen code and prose. This file is already hard to read for me. Please consider not making it harder. [1] https://en.wikipedia.org/wiki/Column_(typography)#Typographic_style
