Re: [PATCH 1/2] Btrfs: use rcu to protect device->name V2

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Wed, Jun 13, 2012 at 09:51:03AM -0400, Josef Bacik wrote:
> On Wed, Jun 13, 2012 at 03:49:07PM +0200, Stefan Behrens wrote:
> > The last sentence of chapter 2 of Documentation/CodingStyle is quite
> > unambiguous. Here is the full quote of that chapter:
> > 
> >                 Chapter 2: Breaking long lines and strings
> > 
> > Coding style is all about readability and maintainability using commonly
> > available tools.
> > 
> > The limit on the length of lines is 80 columns and this is a strongly
> > preferred limit.
> > 
> > Statements longer than 80 columns will be broken into sensible chunks,
> > unless
> > exceeding 80 columns significantly increases readability and does not hide
> > information. Descendants are always substantially shorter than the
> > parent and
> > are placed substantially to the right. The same applies to function headers
> > with a long argument list. However, never break user-visible strings such as
> > printk messages, because that breaks the ability to grep for them.
> 
> Ah never seen that part of it, I will leave them alone then.  Thanks,

Added not so long ago

commit 6f76b6fcaa6025bc9b2c00e055c7ccd39730568d
Author: Josh Triplett <josh@xxxxxxxxxxxxxxxx>
Date:   Wed Aug 3 12:19:07 2011 -0700

    CodingStyle: Document the exception of not splitting user-visible strings, for grepping

    Patch reviewers now recommend not splitting long user-visible strings,
    such as printk messages, even if they exceed 80 columns.  This avoids
    breaking grep.  However, that recommendation did not actually appear
    anywhere in Documentation/CodingStyle.

    See, for example, the thread at
      http://news.gmane.org/find-root.php?message_id=%3c1312215262.11635.15.camel%40Joe%2dLaptop%3e

--
To unsubscribe from this list: send the line "unsubscribe linux-btrfs" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Linux Filesystem Development]     [Linux NFS]     [Linux NILFS]     [Linux USB Devel]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]

  Powered by Linux