[PATCH v4 4/4] firmware: remove warning at documentation generation time

2016-11-28 Thread Silvio Fricke
This patch removes following error at for `make htmldocs`. No functional change. ./drivers/base/firmware_class.c:1348: WARNING: Bullet list ends without a blank line; unexpected unindent. Signed-off-by: Silvio Fricke Reviewed-by: Mauro Carvalho Chehab --- drivers/base

[PATCH v4 2/4] Documentation/local_ops.txt: convert to ReST markup

2016-11-28 Thread Silvio Fricke
... and move to core-api folder. Signed-off-by: Silvio Fricke Reviewed-by: Mauro Carvalho Chehab --- Documentation/core-api/index.rst| 1 +- Documentation/local_ops.txt => Documentation/core-api/local_ops.rst | 273 +++ 2 files changed, 145 inserti

[PATCH v4 3/4] Documentation/atomic_ops.txt: convert to ReST markup

2016-11-28 Thread Silvio Fricke
... and move to core-api folder. Signed-off-by: Silvio Fricke --- Documentation/atomic_ops.txt => Documentation/core-api/atomic_ops.rst | 324 ++-- Documentation/core-api/index.rst |

[PATCH v4 1/4] Documentation/assoc_array.txt: convert to ReST markup

2016-11-28 Thread Silvio Fricke
... and move to Documentation/core-api folder. Signed-off-by: Silvio Fricke Reviewed-by: Mauro Carvalho Chehab --- Documentation/assoc_array.txt => Documentation/core-api/assoc_array.rst | 639 ++-- Documentation/core-

[PATCH v4 0/4] core-api ReST: assoc_array, atomic_ops, local_ops

2016-11-28 Thread Silvio Fricke
ries old(1,2,3,4) new(1,3,2,4) v2 -> v3 * change ". ::" to "::" * replace all "code-blocks" with "::" * add two ".. notes" declaration in atomic_ops.rst v1 -> v2 * use format-patch with a rename_threshold of 10%, no other changes Thanks for review

[PATCH v3 1/4] Documentation/assoc_array.txt: convert to ReST markup

2016-11-25 Thread Silvio Fricke
... and move to Documentation/core-api folder. Signed-off-by: Silvio Fricke --- Documentation/assoc_array.txt => Documentation/core-api/assoc_array.rst | 639 ++-- Documentation/core-api/index.

[PATCH v3 3/4] Documentation/local_ops.txt: convert to ReST markup

2016-11-25 Thread Silvio Fricke
... and move to core-api folder. Signed-off-by: Silvio Fricke --- Documentation/core-api/index.rst| 1 +- Documentation/local_ops.txt => Documentation/core-api/local_ops.rst | 273 +++ 2 files changed, 145 insertions(+), 129 deletions(-) diff --gi

[PATCH v3 4/4] firmware: remove warning at documentation generation time

2016-11-25 Thread Silvio Fricke
This patch removes following error at for `make htmldocs`. No functional change. ./drivers/base/firmware_class.c:1348: WARNING: Bullet list ends without a blank line; unexpected unindent. Signed-off-by: Silvio Fricke --- drivers/base/firmware_class.c | 6 +++--- 1 file changed, 3

[PATCH v3 2/4] Documentation/atomic_ops.txt: convert to ReST markup

2016-11-25 Thread Silvio Fricke
... and move to core-api folder. Signed-off-by: Silvio Fricke --- Documentation/atomic_ops.txt => Documentation/core-api/atomic_ops.rst | 777 +--- Documentation/core-api/index.rst |

[PATCH v3 0/4] core-api ReST: assoc_array, atomic_ops, local_ops

2016-11-25 Thread Silvio Fricke
;code-blocks" with "::" * add two ".. notes" declaration in atomic_ops.rst v1 -> v2 * use format-patch with a rename_threshold of 10%, no other changes Thanks for review. BR Silvio Silvio Fricke (4): Documentation/assoc_array.txt: convert to ReST markup Documen

[PATCH v2 1/4] Documentation/assoc_array.txt: convert to ReST markup

2016-11-25 Thread Silvio Fricke
... and move to Documentation/core-api folder. Signed-off-by: Silvio Fricke --- Documentation/assoc_array.txt => Documentation/core-api/assoc_array.rst | 617 ++-- Documentation/core-api/index.

[PATCH v2 2/4] Documentation/atomic_ops.txt: convert to ReST markup

2016-11-25 Thread Silvio Fricke
... and move to core-api folder. Signed-off-by: Silvio Fricke --- Documentation/atomic_ops.txt => Documentation/core-api/atomic_ops.rst | 745 +--- Documentation/core-api/index.rst |

[PATCH v2 3/4] Documentation/local_ops.txt: convert to ReST markup

2016-11-25 Thread Silvio Fricke
... and move to core-api folder. Signed-off-by: Silvio Fricke --- Documentation/core-api/index.rst| 1 +- Documentation/local_ops.txt => Documentation/core-api/local_ops.rst | 275 +++ 2 files changed, 147 insertions(+), 129 deletions(-) diff --gi

[PATCH v2 4/4] firmware: remove warning at documentation generation time

2016-11-25 Thread Silvio Fricke
This patch removes following error at for `make htmldocs`. No functional change. ./drivers/base/firmware_class.c:1348: WARNING: Bullet list ends without a blank line; unexpected unindent. Signed-off-by: Silvio Fricke --- drivers/base/firmware_class.c | 6 +++--- 1 file changed, 3

[PATCH v2 0/4] core-api ReST: assoc_array, atomic_ops, local_ops

2016-11-25 Thread Silvio Fricke
Hi, Some more ReSTification of core-api's: assoc_array, atomic_ops and local_ops. A fourth patch removes a warning about a bullet list without ending at firmware_class.c v1 -> v2 * use format-patch with a rename_threshold of 10%, no other changes Thanks for review. BR Silvio Silvio F

[PATCH 4/4] firmware: remove warning at documentation generation time

2016-11-24 Thread Silvio Fricke
This patch removes following error at for `make htmldocs`. No functional change. ./drivers/base/firmware_class.c:1348: WARNING: Bullet list ends without a blank line; unexpected unindent. Signed-off-by: Silvio Fricke --- drivers/base/firmware_class.c | 6 +++--- 1 file changed, 3

[PATCH 1/4] Documentation/assoc_array.txt: convert to ReST markup

2016-11-24 Thread Silvio Fricke
... and move to Documentation/core-api folder. Signed-off-by: Silvio Fricke --- Documentation/assoc_array.txt | 574 +-- Documentation/core-api/assoc_array.rst | 549 +- Documentation/core-api/index.rst | 1 +- 3 files changed

[PATCH 3/4] Documentation/local_ops.txt: convert to ReST markup

2016-11-24 Thread Silvio Fricke
... and move to core-api folder. Signed-off-by: Silvio Fricke --- Documentation/core-api/index.rst | 1 +- Documentation/core-api/local_ops.rst | 208 - Documentation/local_ops.txt | 191 +-- 3 files changed, 209 insertions

[PATCH 2/4] Documentation/atomic_ops.txt: convert to ReST markup

2016-11-24 Thread Silvio Fricke
... and move to core-api folder. Signed-off-by: Silvio Fricke --- Documentation/atomic_ops.txt | 640 +--- Documentation/core-api/atomic_ops.rst | 669 +++- Documentation/core-api/index.rst | 1 +- Documentation

[PATCH 0/4] core-api ReST: assoc_array, atomic_ops, local_ops

2016-11-24 Thread Silvio Fricke
Hi, Some more ReSTification of core-api's: assoc_array, atomic_ops and local_ops. A fourth patch removes a warning about a bullet list without ending at firmware_class.c Thanks for review. BR Silvio Silvio Fricke (4): Documentation/assoc_array.txt: convert to ReST markup Document

[PATCH v5 3/4] Documentation/00-index: update for new core-api folder

2016-10-28 Thread Silvio Fricke
Signed-off-by: Silvio Fricke --- Documentation/00-INDEX | 4 +++- Documentation/core-api/conf.py | 5 + Documentation/core-api/index.rst | 15 +++ Documentation/index.rst | 1 + 4 files changed, 24 insertions(+), 1 deletion(-) create mode 100644

[PATCH v5 1/4] kernel-doc: better parsing of named variable arguments

2016-10-28 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 Reviewed-by: Jani Nikula ht

[PATCH v5 4/4] Documentation/workqueue.txt: convert to ReST markup

2016-10-28 Thread Silvio Fricke
... and move to Documentation/core-api folder. Signed-off-by: Silvio Fricke --- Documentation/core-api/index.rst | 2 +- Documentation/core-api/workqueue.rst | 394 - Documentation/workqueue.txt | 388 + MAINTAINERS

[PATCH v5 2/4] workqueue: kerneldocify workqueue_attrs

2016-10-28 Thread Silvio Fricke
Only formating changes. Signed-off-by: Silvio Fricke --- include/linux/workqueue.h | 35 --- 1 file changed, 24 insertions(+), 11 deletions(-) diff --git a/include/linux/workqueue.h b/include/linux/workqueue.h index fc6e221..d4f16cf 100644 --- a/include/linux

[PATCH v5 0/4] workqueue documentation reformatted

2016-10-28 Thread Silvio Fricke
param takes care that this parameter is used for formatting too. * i/l/workqueue.h: inlining of documentation for workqueue_attrs struct members * D/workqueue.rst: Every author get a own :AUTHOR:-label * D/index.rst: add misc section and add link to workqueue documentation Best regards Silvio Silvio F

[PATCH v4 4/4] Documentation/workqueue.txt: convert to ReST markup

2016-10-24 Thread Silvio Fricke
... and move to Documentation/core-api folder. Signed-off-by: Silvio Fricke --- Documentation/core-api/index.rst | 2 +- Documentation/core-api/workqueue.rst | 394 - Documentation/workqueue.txt | 388 + MAINTAINERS

[PATCH v4 0/4] workqueue documentation reformatted

2016-10-24 Thread Silvio Fricke
too. * i/l/workqueue.h: inlining of documentation for workqueue_attrs struct members * D/workqueue.rst: Every author get a own :AUTHOR:-label * D/index.rst: add misc section and add link to workqueue documentation Best regards Silvio Silvio Fricke (4): kernel-doc: better parsing of named

[PATCH v4 3/4] Documentation/00-index: update for new core-api folder

2016-10-24 Thread Silvio Fricke
Signed-off-by: Silvio Fricke --- Documentation/00-INDEX | 4 +++- Documentation/core-api/conf.py | 5 + Documentation/core-api/index.rst | 15 +++ Documentation/index.rst | 1 + 4 files changed, 24 insertions(+), 1 deletion(-) create mode 100644

[PATCH v4 2/4] workqueue: kerneldocify workqueue_attrs

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

[PATCH v4 1/4] kernel-doc: better parsing of named variable arguments

2016-10-24 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 Reviewed-by: Jani Nikula ht

[PATCH v3 3/4] Documentation/00-index: update for new core-api folder

2016-10-24 Thread Silvio Fricke
Signed-off-by: Silvio Fricke --- Documentation/00-INDEX | 4 +++- Documentation/core-api/conf.py | 5 + Documentation/core-api/index.rst | 15 +++ Documentation/index.rst | 1 + 4 files changed, 24 insertions(+), 1 deletion(-) create mode 100644

[PATCH v3 2/4] workqueue: kerneldocify workqueue_attrs

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

[PATCH v3 1/4] kernel-doc: better parsing of named variable arguments

2016-10-24 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 Reviewed-by: Jani Nikula ht

[PATCH v3 4/4] Documentation/workqueue.txt: convert to ReST markup

2016-10-24 Thread Silvio Fricke
... and move to Documentation/core-api folder. Signed-off-by: Silvio Fricke --- Documentation/core-api/index.rst | 2 +- Documentation/core-api/workqueue.rst | 394 - Documentation/index.rst | 1 +- Documentation/workqueue.txt | 388

[PATCH v3 0/4] workqueue documentation reformatted

2016-10-24 Thread Silvio Fricke
struct members * D/workqueue.rst: Every author get a own :AUTHOR:-label * D/index.rst: add misc section and add link to workqueue documentation Best regards Silvio Silvio Fricke (4): kernel-doc: better parsing of named variable arguments workqueue: kerneldocify workqueue_attrs Documentation/00

[PATCH v2 2/3] workqueue: kerneldocify workqueue_attrs

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

[PATCH v2 3/3] Documentation/workqueue.txt: convert to ReST markup

2016-10-19 Thread Silvio Fricke
This patch add a "misc" documentation section and add the workqueue documentation to this section. Signed-off-by: Silvio Fricke --- Documentation/index.rst | 1 +- Documentation/misc/conf.py | 5 +- Documentation/misc/index.rst | 17 ++- Documentation/workqueue.

[PATCH v2 0/3] workqueue documentation reformatted

2016-10-19 Thread Silvio Fricke
* D/index.rst: add misc section and add link to workqueue documentation Best regards Silvio Silvio Fricke (3): kernel-doc: better parsing of named variable arguments workqueue: kerneldocify workqueue_attrs Documentation/workqueue.txt: convert to ReST markup Documentation/index.rst |

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

2016-10-19 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 |

[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 | 2 +- include/linux

[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 var

[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 --- a/include/linux/workqueue.h

[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 |