[lkml]   [2010]   [Sep]   [7]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
Messages in this thread
SubjectRe: [RFC 04/22] tcm: Add v4 base data structures and struct target_core_fabric_ops
> Hi Konard,
> I just pushed most of your recommend cleanups for target_core_base.h to
> lio-core-2.6.git/lio-4.0. The cleanup series has been posted on
> lio-devel list to prevent extra noise on linux-scsi, et al, but for
> reference the shortlog and diffstat are attached below.. I did not dive
> into intermixed struct + #defines, but I am still pretty indifferent on
> this particular item.

So the reasons why I thought it would be a good idea to combine the #defines
and the values and also dropping the prefix of structs for all of the 'flag'
members is that:

1) once you have them intermixed, searching for a particular flag either using
cscope/ctags becomes easier. You have the definition of the 'flag' and the
different values it can have in one localized spot. It also removes your
worry about the 'grep' - you usually search for the values that a specific
flag has and if you use that tool you can find it right there along with the
structure it was defined in.

2). From a perspective of a vendor maintainer who has to find a fix, getting
familiarized with the code within a short window time frame and having the
acceptable states and its definitions in one place (and even pointers to the
specs if there are some) makes it sooo much easier to grok the code.
Having even nice ascii art of how/what works together is even better.

Obviously thought there are tools that can do this for you. But when the bug
hits I somehow never managed to have those tools ready :-(

> Please have a look and feel free to make additional comments.


 \ /
  Last update: 2010-09-07 23:29    [W:0.081 / U:1.864 seconds]
©2003-2018 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site