[PATCH] CodingStyle: Clarify and complete chapter 7

2016-07-25 Thread Jean Delvare
Chapter 7 (Centralized exiting of functions) of the coding style documentation is unclear at times, and lacks some information (such as the possibility to indent labels with a single space.) Clarify and complete it. Signed-off-by: Jean Delvare <jdelv...@suse.de> Cc: Markus Elfring

Re: staging: ks7010: Rename jump labels

2016-07-25 Thread Jean Delvare
ernel/2106190 Personally I see no value in such statistics. Either labels are wrong (either wrong indentation or wrong name) and should be fixed, or they are correct and you should not touch them. Whether the same label name is used somewhere else is irrelevant. Labels are local by nature, so uniquene

Re: [PATCH v8 2/4] i2c-smbus: add SMBus Host Notify support

2016-07-18 Thread Jean Delvare
xample "rmmod i2c-i801".) 4* The workqueue is processed, accessing memory which has already been freed. Of course it would be back luck, but that's pretty much the definition of a race condition ;-) To be on the safe side, don't we need a teardown function in i2c-smbus, that could be

Re: [PATCH v8 2/4] i2c-smbus: add SMBus Host Notify support

2016-07-18 Thread Jean Delvare
On Mon, 18 Jul 2016 17:59:02 +0200, Benjamin Tissoires wrote: > On Jul 18 2016 or thereabouts, Jean Delvare wrote: > > You provide stubs for SMBus Host Notify support if CONFIG_I2C_SMBUS is > > not selected. There are no such stubs for SMBus Alert support, for which > > I

Re: [PATCH v8 2/4] i2c-smbus: add SMBus Host Notify support

2016-07-18 Thread Jean Delvare
ot selected. There are no such stubs for SMBus Alert support, for which I assumed drivers would select I2C_SMBUS if they have support. Which is what you are actually doing for i2c-i801 in a latter patch. Is there any reason for this difference? For consistency I'd rather provide stubs for all or

Re: sparc: bpf_jit: Rename jump labels in bpf_jit_compile()

2016-09-05 Thread Jean Delvare
And until this happens, my preference for one-space-indented labels will remain. Also git has its own implementation of "diff", so any change in the behavior of GNU diff's -p and/or --show-c-function options should be reflected there as well for consistency. -- Jean Delvare SUSE

Re: sparc: bpf_jit: Rename jump labels in bpf_jit_compile()

2016-09-05 Thread Jean Delvare
On Mon, 5 Sep 2016 13:37:04 +0200, Peter Zijlstra wrote: > On Mon, Sep 05, 2016 at 01:07:37PM +0200, Jean Delvare wrote: > > Now I see in http://patchwork.ozlabs.org/patch/664966/ that Peter > > Zijlstra reportedly changed the behavior of "diff -p" so that it > > han

Re: sparc: bpf_jit: Rename jump labels in bpf_jit_compile()

2016-09-06 Thread Jean Delvare
Hi Peter, On Mon, 5 Sep 2016 13:58:38 +0200, Peter Zijlstra wrote: > On Mon, Sep 05, 2016 at 01:54:45PM +0200, Jean Delvare wrote: > > On Mon, 5 Sep 2016 13:37:04 +0200, Peter Zijlstra wrote: > > > I have it in my local .gitconfig, and recommend it to people who sen

[PATCH] cpufreq-stats: Minor documentation fix

2016-09-08 Thread Jean Delvare
The cpufreq-stats code can no longer be built as a module, so it now appears with square brackets in menuconfig. Signed-off-by: Jean Delvare <jdelv...@suse.de> Fixes: 1aefc75b2449 ("cpufreq: stats: Make the stats code non-modular") Cc: Rafael J. Wysocki <rafael.j.wyso...@in

Re: [PATCH 06/17] CodingStyle.rst: use the proper tag for verbatim font

2016-09-13 Thread Jean Delvare
a switch statement > is > -to align the "switch" and its subordinate "case" labels in the same column > -instead of "double-indenting" the "case" labels. E.g.: > +to align the ``switch`` and its subordinate ``case`` labels in the same > colu

Re: [PATCH 06/17] CodingStyle.rst: use the proper tag for verbatim font

2016-09-14 Thread Jean Delvare
On Tue, 13 Sep 2016 16:24:48 -0300, Mauro Carvalho Chehab wrote: > Em Tue, 13 Sep 2016 19:45:23 +0200 > Jean Delvare <jdelv...@suse.de> escreveu: > > > Hi Mauro, > > > > On Mon, 12 Sep 2016 11:47:57 -0300, Mauro Carvalho Chehab wrote: > > > Instead

Re: [PATCH 07/17] SubmitChecklist: rename to RST and add to the development-proccess book

2016-09-16 Thread Jean Delvare
hecklist => > development-process/SubmitChecklist.rst} (98%) > (...) For the hwmon part: Reviewed-by: Jean Delvare <jdelv...@suse.de> -- Jean Delvare SUSE L3 Support -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to maj

Re: [PATCH] cpufreq-stats: Minor documentation fix

2016-09-09 Thread Jean Delvare
On Fri, 9 Sep 2016 00:38:59 +0200, Rafael J. Wysocki wrote: > On 9/8/2016 1:20 PM, Viresh Kumar wrote: > > On 08-09-16, 12:39, Jean Delvare wrote: > >> The cpufreq-stats code can no longer be built as a module, so it now > >> appears with square brackets in menuc

Re: [PATCH] docs: Remove space-before-label guidance from CodingStyle

2016-09-22 Thread Jean Delvare
kfree(foo); > return ret; There are 2 more occurrences after this point, which you probably want to change too. -- Jean Delvare SUSE L3 Support -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: "CodingStyle: Clarify and complete chapter 7" in docs-next

2016-09-22 Thread Jean Delvare
ce. This SHOULD be fixed before the patch is submitted upstream, unless the maintainer agreed otherwise." Not sure if we need something for CHECK, as these messages are not printed by default so I'd assume people who get them know what they asked for. But apparently these confused Julia so mayb

Re: "CodingStyle: Clarify and complete chapter 7" in docs-next

2016-09-22 Thread Jean Delvare
Hi Jani, On Thu, 22 Sep 2016 13:43:42 +0300, Jani Nikula wrote: > On Thu, 22 Sep 2016, Jean Delvare <jdelv...@suse.de> wrote: > > You need to think in terms of actual use cases. Who uses checkpatch and > > why? I think there are 3 groups of users: > > * Beginners

Re: "CodingStyle: Clarify and complete chapter 7" in docs-next

2016-09-22 Thread Jean Delvare
On Thu, 22 Sep 2016 03:42:10 -0700, Joe Perches wrote: > On Thu, 2016-09-22 at 11:24 +0200, Jean Delvare wrote: > > I would rather suggest: > > > > ERROR -> MUST_FIX > > WARNING -> SHOULD_FIX > > CHECK -> MAY_FIX > > MUST is much stronger langua

Re: "CodingStyle: Clarify and complete chapter 7" in docs-next

2016-09-22 Thread Jean Delvare
On Thu, 22 Sep 2016 14:11:03 +0100, Al Viro wrote: > On Thu, Sep 22, 2016 at 01:57:58PM +0200, Jean Delvare wrote: > > > > > > MUST is much stronger language than I would prefer. > > > > That's what error means, really. When your compiler fails with an > &g

Re: "CodingStyle: Clarify and complete chapter 7" in docs-next

2016-09-22 Thread Jean Delvare
On Thu, 22 Sep 2016 10:49:47 -0700, Joe Perches wrote: > On Thu, 2016-09-22 at 13:57 +0200, Jean Delvare wrote: > > Sure. But I'm afraid you keep changing topics and I have no idea where > > you are going. We started with "should there be a space before jump > > label

Re: [PATCH] Documentation/i2c: sync docs with current state of i2c-tools.

2018-04-13 Thread Jean Delvare
a comment on this? Fixing the documentation is always welcome, thanks Sam for stepping in. However we really want separate patches for whitespace fixes and actual contents change, as Wolfram already mentioned above. -- Jean Delvare SUSE L3 Support -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [PATCH] Documentation/i2c: direct users to i2c-tools regarding i2c/smbus.h

2018-04-25 Thread Jean Delvare
age (libi2c or similar), and the header file in yet another package (libi2c-devel or similar.) Although the exact package names are distribution specific, it would be convenient to hint the reader at which packages he is supposed to install. You could also mention that the C program must be compiled