Re: [PATCH 3/7] crypto: doc - fix source comments for Sphinx

2016-10-16 Thread Markus Heiser
Am 16.10.2016 um 15:03 schrieb Stephan Mueller : > Am Sonntag, 16. Oktober 2016, 14:56:49 CEST schrieb Markus Heiser: > > Hi Markus, > ... > >> compared to DocBook, with sphinx you can use (have to use) the reST markup >> in source code comments. >> >> Here, the code

Re: [PATCH 3/7] crypto: doc - fix source comments for Sphinx

2016-10-16 Thread Markus Heiser
Am 16.10.2016 um 05:18 schrieb Stephan Mueller : > Update comments to avoid any complaints from Sphinx during compilation. > > Signed-off-by: Stephan Mueller > --- > include/crypto/aead.h | 14 +++--- > include/crypto/hash.h | 2 +- >

Re: [PATCH 3/7] crypto: doc - fix source comments for Sphinx

2016-10-16 Thread Stephan Mueller
Am Sonntag, 16. Oktober 2016, 14:56:49 CEST schrieb Markus Heiser: Hi Markus, ... > compared to DocBook, with sphinx you can use (have to use) the reST markup > in source code comments. > > Here, the code example is just a (indented) float text and this is > why you have to quote the asterisk

Re: [PATCH 7/7] crypto: doc - clarify AEAD memory structure

2016-10-16 Thread Markus Heiser
Am 16.10.2016 um 05:22 schrieb Stephan Mueller : > The previous description have been misleading and partially incorrect. > > Reported-by: Harsh Jain > Signed-off-by: Stephan Mueller > --- > crypto/algif_aead.c | 14

Re: [PATCH 7/7] crypto: doc - clarify AEAD memory structure

2016-10-16 Thread Stephan Mueller
Am Sonntag, 16. Oktober 2016, 15:11:38 CEST schrieb Markus Heiser: Hi Markus, > These are only my 2cent in hope that helps ... there is no rule > to use any special markup ... use markup as you prefer ;-) Thanks for the pointers. I will release a new patch set following your suggestions after

[RFC PATCH 2/3] workqueue: kerneldocify workqueue_attrs

2016-10-16 Thread Silvio Fricke
Only formating changes. Signed-off-by: Silvio Fricke --- include/linux/workqueue.h | 22 +- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/include/linux/workqueue.h b/include/linux/workqueue.h index fc6e221..8455869 100644 ---

[RFC PATCH 1/3] kernel-doc: better parsing of named variable arguments

2016-10-16 Thread Silvio Fricke
Without this patch we get warnings for named variable arguments. warning: No description found for parameter '...' warning: Excess function parameter 'args' description in 'alloc_ordered_workqueue' Signed-off-by: Silvio Fricke --- scripts/kernel-doc | 9

[RFC PATCH 0/3] [RFC] workqueue documentation reformated

2016-10-16 Thread Silvio Fricke
Hi, This is a RFC of a reformatting the workqueue documentation using rst. It's my first contribution to documentation section and I would like to know if these changes are in a acceptable state. Thanks for reviewing, Silvio Silvio Fricke (3): kernel-doc: better parsing of named variable

[RFC PATCH 3/3] kernel-doc: kerneldocify workqueue documentation

2016-10-16 Thread Silvio Fricke
Only formating changes. Signed-off-by: Silvio Fricke --- Documentation/index.rst | 1 +- Documentation/workqueue.rst | 394 +- Documentation/workqueue.txt | 388 + MAINTAINERS

[PATCH] mac80211_hwsim: suggest nl80211 instead of wext driver in documentation

2016-10-16 Thread Linus Lüssing
For mac80211_hwsim interfaces, suggest to use wpa_supplicant with the more modern, netlink based driver instead of wext. Signed-off-by: Linus Lüssing --- Actually, I wasn't even able to make a connection with the configuration files and information provided in