On 06-12-2011 12:13, Thierry Reding wrote:
* Antti Palosaari wrote:
That question is related to that kind of indentation generally, not
only that patch.
On 12/06/2011 03:39 PM, Thierry Reding wrote:
Function parameters on subsequent lines should never be aligned with the
function name but rather be indented.
[...]
usb_set_interface(dev->udev,
- dev->isoc_in.bInterfaceNumber,
- 0);
+ dev->isoc_in.bInterfaceNumber, 0);
Which kind of indentation should be used when function params are
slitted to multiple lines?
Documentation/CodingStyle currently says:
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.
So, it should be: "substantially to the right" whatever this means.
I don't think this is documented anywhere and there are no hard rules with
regard to this. I guess anything is fine as long as it is indented at all.
In that case two tabs are used (related to function indentation).
example:
ret= function(param1,
param2);
I usually use that because it is my text editor's default.
Other generally used is only one tab (related to function indentation).
example:
ret= function(param1,
param2);
I think that's okay as well.
One tab can hardly be interpreted as "substantially to the right".
And last generally used is multiple tabs + spaces until same
location where first param is meet (related to function
indentation). I see that bad since use of tabs, with only spaces I
see it fine. And this many times leads situation param level are
actually different whilst originally idea was to put those same
level.
example:
ret= function(param1,
param2);
In practice, this is the most commonly used way, from what I noticed, not only
at drivers/media. A good place to look for commonly used CodingStyle are the
most used headers at include/linux. As far as I noticed, they all use this
style.
Whether this works or not always depends on the tab-width. I think most
variations are okay here. Some people like to align them, other people
don't.
Tab width is always 8, according with the CodingStyle:
"Tabs are 8 characters, and thus indentations are also 8 characters."
Regards,
Mauro
--
To unsubscribe from this list: send the line "unsubscribe linux-media" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
