Thread (1 message) 1 message, 1 author, 2016-06-15

Re: [PATCH] Add line-wrapping guidelines to the coding style documentation

From: Junio C Hamano <hidden>
Date: 2016-06-15 22:43:50

Wincent Colaiuta [off-list ref] writes:
A statistician could probably make some interesting comments about the  
results, but the basic trend is that, while there are plenty of  
examples of isolated long lines in the source tree (the longest is a  
287-character line in one of the perl scripts), the frequency starts  
to drop off pretty rapidly once you pass 70 columns and start climbing  
towards 80.
Gaah.  287???
+ - In the case of documentation, mixing excessively long and short
+   lines may make the AsciiDoc source harder to read, so try to
+   keep line lengths consistent.
+
+ - When submitting patches use common sense to decide whether to
+   rewrap, avoiding gratuitous changes.
Hmph.  The last item applies only to the documentation because
it uses the word "rewrap", but otherwise applies equally well to
the sources (re-indenting).  So probably "whether to rewrap or
reindent" would be a good change there.
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help