[PATCH v5 31/52] docs: device_link.rst: remove duplicated kernel-doc include

to the functions associated with device_link. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/device_link.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/Documentation/driver-api/device_link.rst b/Documentation/driver-api/device_link.rst index 76950d061632

[PATCH v5 23/52] docs: trace-uses.rst: remove bogus c-domain tags

esh Babulal Acked-by: Steven Rostedt (VMware) Signed-off-by: Mauro Carvalho Chehab --- Documentation/trace/ftrace-uses.rst | 12 ++-- 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/Documentation/trace/ftrace-uses.rst b/Documentation/trace/ftrace-uses.rst index 2a05e7706

[PATCH v5 17/52] media: docs: make RC documents more compatible with Sphinx 3.1+

Sphinx 3.x broke support for the cdomain.py extension, as the c domain code was rewritten. Due to that, the c tags need to be re-written, in order to use the new c domain notation. Signed-off-by: Mauro Carvalho Chehab --- .../userspace-api/media/rc/lirc-get-features.rst | 9

[PATCH v5 34/52] docs: pstore-blk.rst: fix kernel-doc tags

: at the kAPI part of the documentation. Acked-by: Kees Cook Signed-off-by: Mauro Carvalho Chehab --- Documentation/admin-guide/pstore-blk.rst | 10 ++ 1 file changed, 2 insertions(+), 8 deletions(-) diff --git a/Documentation/admin-guide/pstore-blk.rst b/Documentation/admin-guide/pstore

[PATCH v5 33/52] docs: net: statistics.rst: remove a duplicated kernel-doc

-references. Solves this warning: ../Documentation/networking/ethtool-netlink.rst: WARNING: Duplicate C declaration, also defined in 'networking/statistics'. Declaration is 'ethtool_pause_stats'. Acked-by: David S. Miller Signed-off-by: Mauro Carvalho Chehab --- Documentation

[PATCH v5 27/52] docs: kernel-api.rst: drop kernel/irq/manage.c kernel-doc tag

in 'genericirq'. Declaration is 'irq_set_affinity_notifier'. ... Signed-off-by: Mauro Carvalho Chehab --- Documentation/core-api/kernel-api.rst | 6 -- 1 file changed, 6 deletions(-) diff --git a/Documentation/core-api/kernel-api.rst b/Documentation/core-api/kernel-api.rst

[PATCH v5 19/52] math64.h: kernel-docs: Convert some markups into normal comments

-by: Mauro Carvalho Chehab --- include/linux/math64.h | 8 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/include/linux/math64.h b/include/linux/math64.h index 3381d9e33c4e..66deb1fdc2ef 100644 --- a/include/linux/math64.h +++ b/include/linux/math64.h @@ -28,7 +28,7 @@ static

[PATCH v5 25/52] docs: net: ieee802154.rst: fix C expressions

hw *hw, u8 page, u8 channel): --^ Caused by some bad c:function: prototypes. Fix them. Acked-by: David S. Miller Signed-off-by: Mauro Carvalho Chehab --- Documentation/networking/ieee802154.rst | 18 ++ 1 file c

[PATCH v5 32/52] docs: basics.rst: get rid of rcu kernel-doc macros

-api/kernel-api'. Declaration is 'synchronize_rcu'. ... Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/basics.rst | 6 -- 1 file changed, 6 deletions(-) diff --git a/Documentation/driver-api/basics.rst b/Documentation/driver-api/basics.rst index

[PATCH v5 07/52] scripts: kernel-doc: reimplement -nofunction argument

output, no matter what mode is used. The parameter was also renamed to "-nosymbol", as it express better its meaning. Signed-off-by: Mauro Carvalho Chehab --- scripts/kernel-doc | 44 +--- 1 file changed, 21 insertions(+), 23 deletions(-)

[PATCH v5 39/52] docs: writing-an-alsa-driver.rst: fix some bad c:func: markups

case seems to be better replaced by a literal. For the second one, let's generate cross-references, by spliting it in two. Reviewed-by: Takashi Iwai Signed-off-by: Mauro Carvalho Chehab --- Documentation/sound/kernel-api/writing-an-alsa-driver.rst | 5 ++--- 1 file changed, 2 insertions(+), 3

[PATCH v5 47/52] docs: mei.rst: fix a C expression markup

it into a :c:expr. Acked-by: Tomas Winkler Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/mei/mei.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/driver-api/mei/mei.rst b/Documentation/driver-api/mei/mei.rst index cea0b69ec216..4f2ced4ccdc6

[PATCH v5 46/52] docs: it_IT: hacking.rst: fix a typo on a markup

ot;in-situ", come :c:func:`cpu_to_be32s --^ Acked-by: Federico Vaga Signed-off-by: Mauro Carvalho Chehab --- Documentation/translations/it_IT/kernel-hacking/hacking.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/translations/it_IT

[PATCH v5 16/52] media: docs: make MC documents more compatible with Sphinx 3.1+

Sphinx 3.x broke support for the cdomain.py extension, as the c domain code was rewritten. Due to that, the c tags need to be re-written, in order to use the new c domain notation. Signed-off-by: Mauro Carvalho Chehab --- .../media/mediactl/media-func-close.rst| 10

[PATCH v5 50/52] scripts: kernel-doc: try to use c:function if possible

-by: Mauro Carvalho Chehab --- scripts/kernel-doc | 23 ++- 1 file changed, 14 insertions(+), 9 deletions(-) diff --git a/scripts/kernel-doc b/scripts/kernel-doc index 9881f08cf75c..a3453de4495c 100755 --- a/scripts/kernel-doc +++ b/scripts/kernel-doc @@ -913,6 +913,7 @@ sub

[PATCH v5 38/52] docs: block: blk-mq.rst: get rid of :c:type

Also, they won't be generating any cross references. So, replace them by a literal markup. Reviewed-by: André Almeida Signed-off-by: Mauro Carvalho Chehab --- Documentation/block/blk-mq.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/block/blk-mq

[PATCH v5 21/52] docs: remove some replace macros like |struct foo|

There are three files with replace macros for structs, mapping them into Sphinx 2.x C domain references. Well, this is broken on Sphinx 3.x. Also, for Sphinx 2.x, the automarkup macro should be able to take care of them. So, let's just drop those. Signed-off-by: Mauro Carvalho Chehab

[PATCH v5 42/52] docs: libata.rst: fix a wrong usage of :c:type: tag

ete_fn --^ Instead, let's use :c:expr: for such purpose. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/libata.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/driver-api/libata.rst b/Documentation/driver-api/libata.rst

[PATCH v5 36/52] docs: devices.rst: get rid of :c:type macros

There's no need to use macros to use :c:type on this file, as automarkup.py should do this automatically. Also, this breaks compatibility with Sphinx 3.x, as there, structs should be declared using .. c:struct. So, get rid of them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver

[PATCH v5 48/52] docs: basics.rst: avoid duplicated C function declaration

at printk-basics: ./Documentation/driver-api/basics.rst: WARNING: Duplicate C declaration, also defined in 'core-api/printk-basics'. Declaration is 'printk'. So, exclude those identifiers from basirs.rst. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api

[PATCH v5 28/52] docs: remove sound API duplication

the duplicated one. Reviewed-by: Takashi Iwai Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/index.rst| 1 - Documentation/driver-api/sound.rst| 54 --- .../sound/kernel-api/alsa-driver-api.rst | 1 + 3 files changed, 1 insertion

[PATCH v5 40/52] docs: fpga: replace :c:member: macros

ritz Fischer Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/fpga/fpga-mgr.rst | 2 +- Documentation/driver-api/fpga/fpga-programming.rst | 2 +- Documentation/driver-api/fpga/fpga-region.rst | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Docum

[PATCH v5 52/52] docs: conf.py: change the Sphinx 3.x+ text

After the build fix patches, it is believed that the output with Sphinx 3.x won't be a problem. Still, the C domain support was re-written, and this can have caused hidden issues. So, let's keep the warning, changing it to a lighter warning text. Signed-off-by: Mauro Carvalho Chehab

[PATCH v5 45/52] docs: devices.rst: fix a C reference markup

] device_may_wakeup(dev) -^ Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/pm/devices.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/driver-api/pm/devices.rst b/Documentation/driver-api/pm/devices.rst index 4bda8a21f5d1

[PATCH v5 35/52] docs: fs: fscrypt.rst: get rid of :c:type: tags

The :c:type: tag has problems with Sphinx 3.x, as structs there should be declared with c:struct. So, remove them, relying at automarkup.py extension to convert them into cross-references. Signed-off-by: Mauro Carvalho Chehab --- Documentation/filesystems/fscrypt.rst | 51

[PATCH v5 51/52] docs: conf.py: fix c:function support with Sphinx 3.x

-by: Mauro Carvalho Chehab --- Documentation/conf.py | 65 +-- 1 file changed, 62 insertions(+), 3 deletions(-) diff --git a/Documentation/conf.py b/Documentation/conf.py index 3875401486de..b402bd8f6f71 100644 --- a/Documentation/conf.py +++ b/Documentation

[PATCH v5 13/52] media: docs: make CEC documents compatible with Sphinx 3.1+

Sphinx 3.x broke support for the cdomain.py extension, as the c domain code was rewritten. Due to that, the c tags need to be re-written, in order to use the new c domain notation. Signed-off-by: Mauro Carvalho Chehab --- .../media/cec/cec-func-close.rst | 10 +++--- .../media

[PATCH v5 00/52] Fix html build with Sphinx 3.1 and above

se there's a function with the same name of a struct or enum. Btw, while Sphinx < 3 doesn't report such issue, this actually causes cross-references to those symbols to be broken. There is an opened Sphinx issue, asking for a fix on some Sphinx future version. Mauro Carvalho Chehab (52): doc

[PATCH v5 49/52] workqueue: fix a kernel-doc warning

As warned by Sphinx: ./Documentation/core-api/workqueue:400: ./kernel/workqueue.c:1218: WARNING: Unexpected indentation. the return code table is currently not recognized, as it lacks markups. Acked-by: Tejun Heo Signed-off-by: Mauro Carvalho Chehab --- kernel/workqueue.c | 3 +++ 1

[PATCH v5 22/52] docs: get rid of :c:type explicit declarations for structs

rid of that, solving several warnings when building docs with Sphinx 3.x. Reviewed-by: André Almeida # blk-mq.rst Reviewed-by: Takashi Iwai # sound Reviewed-by: Mike Rapoport Signed-off-by: Mauro Carvalho Chehab --- Documentation/block/blk-mq.rst| 8 +++ Documentation/block

[PATCH v5 41/52] docs: kgdb.rst: fix :c:type: usages

Thompson Signed-off-by: Mauro Carvalho Chehab --- Documentation/dev-tools/kgdb.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Documentation/dev-tools/kgdb.rst b/Documentation/dev-tools/kgdb.rst index c908ef4d3f04..77b688e6a254 100644 --- a/Documentation/dev-tools

[PATCH v5 44/52] docs: gpu: i915.rst: Fix several C duplication warnings

file. Signed-off-by: Mauro Carvalho Chehab --- Documentation/gpu/i915.rst | 29 + 1 file changed, 25 insertions(+), 4 deletions(-) diff --git a/Documentation/gpu/i915.rst b/Documentation/gpu/i915.rst index 33cc6ddf8f64..cff1f154b473 100644 --- a/Documentation/gpu/i915

[PATCH v5 09/52] scripts: kernel-doc: don't mangle with parameter list

printing the function prototype and when describing each argument. Signed-off-by: Mauro Carvalho Chehab --- scripts/kernel-doc | 26 ++ 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/scripts/kernel-doc b/scripts/kernel-doc index 33ad3ce66f73..09e3e78b9723

[PATCH v5 12/52] docs: kerneldoc.py: add support for kerneldoc -nosymbol

Currently, there's no way to exclude identifiers from a kernel-doc markup. Add support for it. Signed-off-by: Mauro Carvalho Chehab --- Documentation/doc-guide/kernel-doc.rst | 8 Documentation/sphinx/kerneldoc.py | 7 +++ 2 files changed, 15 insertions(+) diff --git

[PATCH v5 29/52] docs: basics.rst: move kernel-doc workqueue markups to workqueue.rst

As there's already a rst file with workqueue markups, containing part of them, move the other definitions, in order to avoid warnings with Sphinx. Signed-off-by: Mauro Carvalho Chehab --- Documentation/core-api/workqueue.rst | 2 ++ Documentation/driver-api/basics.rst | 9 - 2 files

[PATCH v5 37/52] docs: sound: writing-an-alsa-driver.rst: get rid of :c:type

-an-alsa-driver.rst:3928: WARNING: Unparseable C cross-reference: 'copy_from/to_user' Invalid C declaration: Expected end of definition. [error at 9] copy_from/to_user -^ Reviewed-by: Takashi Iwai Signed-off-by: Mauro Carvalho Chehab --- .../kernel-api/writing

[PATCH v5 03/52] docs: conf.py: disable automarkup for Sphinx 3.x

The class types changed after the C domain rewrite on Sphinx 3.x. Due to that, the automarkup extension is just generating additional noise when trying to convert structs and other markups into cross references. Signed-off-by: Mauro Carvalho Chehab --- Documentation/conf.py | 3 ++- 1 file

[PATCH v5 15/52] media: docs: make DVB documents more compatible with Sphinx 3.1+

Sphinx 3.x broke support for the cdomain.py extension, as the c domain code was rewritten. Due to that, the c tags need to be re-written, in order to use the new c domain notation. Signed-off-by: Mauro Carvalho Chehab --- .../dvb/audio-bilingual-channel-select.rst | 7 +++ .../media

[PATCH v5 04/52] scripts: kernel-doc: make it more compatible with Sphinx 3.x

sn't exist on older versions. Add a check for the Sphinx version and change the produced tags accordingly. Signed-off-by: Mauro Carvalho Chehab --- scripts/kernel-doc | 71 ++ 1 file changed, 65 insertions(+), 6 deletions(-) diff --git a/scripts/ke

[PATCH v5 43/52] docs: infrastructure.rst: don't include firmware kernel-doc

is 'request_firmware_nowait'. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/infrastructure.rst | 3 --- 1 file changed, 3 deletions(-) diff --git a/Documentation/driver-api/infrastructure.rst b/Documentation/driver-api/infrastructure.rst index 06d98c4526df..e38d79be4e16 100644

[PATCH v5 08/52] scripts: kernel-doc: fix typedef identification

Some typedef expressions are output as normal functions. As we need to be clearer about the type with Sphinx 3.x, detect such cases. While here, fix a wrongly-indented block. Signed-off-by: Mauro Carvalho Chehab --- scripts/kernel-doc | 62 ++ 1

[PATCH 0/4] linu-next next-20201006 document build fixes

This small series fix new warnings introduced on today's linux-next. Feel free to add the patches on this series at the same tree as the warning was introduced at the first place. Thanks! Mauro Mauro Carvalho Chehab (4): docs: infrastructure.rst: exclude device_link_state from device.h

[PATCH 1/4] docs: infrastructure.rst: exclude device_link_state from device.h

-by: Mauro Carvalho Chehab --- Documentation/driver-api/infrastructure.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/Documentation/driver-api/infrastructure.rst b/Documentation/driver-api/infrastructure.rst index e38d79be4e16..683bd460e222 100644 --- a/Documentation/driver-api

[PATCH 3/4] docs: RCU: Requirements.rst: fix a list block

esign") Signed-off-by: Mauro Carvalho Chehab --- Documentation/RCU/Design/Requirements/Requirements.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/Documentation/RCU/Design/Requirements/Requirements.rst b/Documentation/RCU/Design/Requirements/Requirements.rst index 98557fee90cc..9f3628271

[PATCH 2/4] docs: zh_CN: amu.rst: fix document title markup

As warned by Sphinx 2.4.4: .../Documentation/translations/zh_CN/arm64/amu.rst:7: WARNING: Title overline too short. Increase its size. Signed-off-by: Mauro Carvalho Chehab --- Documentation/translations/zh_CN/arm64/amu.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions

[PATCH 4/4] firmware_loader: fix a kernel-doc markup

The firmware_fallback_sysfs had some changes at their parameters. Those ended by dropping a documentation for such parameter. Re-add it. Fixes: 89287c169f8f ("firmware: Store opt_flags in fw_priv") Fixes: c2c076166b58 ("firmware_loader: change enum fw_opt to u32") Signed-of

Re: [PATCH 2/2] w1: w1_therm: Add support for GXCAS GX20MH01 device.

Em Fri, 4 Sep 2020 19:00:04 +0300 Ivan Zaentsev escreveu: > diff --git a/Documentation/w1/slaves/w1_therm.rst > b/Documentation/w1/slaves/w1_therm.rst > index f1148181f53e..00376501a5ef 100644 > --- a/Documentation/w1/slaves/w1_therm.rst > +++ b/Documentation/w1/slaves/w1_therm.rst > > @@

Re: [PATCH RFC] script: add a script for checking doc problems with external functions

Hi Matthew/Jon, Em Tue, 6 Oct 2020 13:53:34 +0200 Mauro Carvalho Chehab escreveu: > While not all EXPORT_SYMBOL*() symbols should be documented, > it seems useful to have a tool which would help to check what > symbols aren't documented. > > This is a first step on this dire

[PATCH RFC] script: add a script for checking doc problems with external functions

on their subsystems. Suggested-by: Matthew Wilcox Signed-off-by: Mauro Carvalho Chehab --- scripts/check_docs_external_symbols | 127 1 file changed, 127 insertions(+) create mode 100755 scripts/check_docs_external_symbols diff --git a/scripts

Re: [PATCH v4 35/52] docs: fs: fscrypt.rst: get rid of :c:type: tags

Em Mon, 5 Oct 2020 12:08:23 -0700 Eric Biggers escreveu: > On Mon, Oct 05, 2020 at 02:06:22PM +0200, Mauro Carvalho Chehab wrote: > > The latest version at: > > > > > > https://git.linuxtv.org/mchehab/experimental.git/log/?h=sphinx3-fixes-v4 > > Doesn

Re: [PATCH] scripts: kernel-doc: allow passing desired Sphinx C domain dialect

Em Mon, 5 Oct 2020 10:17:36 -0600 Jonathan Corbet escreveu: > On Sun, 4 Oct 2020 10:02:03 +0200 > Mauro Carvalho Chehab wrote: > > > When kernel-doc is called via kerneldoc.py, there's no need to > > auto-detect the Sphinx version, as the Sphinx module already

Re: [PATCH v4 35/52] docs: fs: fscrypt.rst: get rid of :c:type: tags

t.rst, there are only two patches on my series affecting it, both as part of this /52 series: $ git log next-20200922..devel/sphinx3-fixes-v4 Documentation/filesystems/fscrypt.rst commit ee4af6dd20dd6d2ac7f5d970abac960a36679e13 Author: Mauro Carvalho Chehab Date: Tu

Re: [PATCH 00/14] get rid of the remaining kernel-doc warnings when building the docs

Em Mon, 5 Oct 2020 12:51:11 +0200 Mauro Carvalho Chehab escreveu: > Em Thu, 10 Sep 2020 19:12:08 +0100 > Matthew Wilcox escreveu: > > > On Thu, Sep 10, 2020 at 12:23:53PM +0200, Mauro Carvalho Chehab wrote: > > > As described on its subject, this series finally get

Re: [PATCH 00/14] get rid of the remaining kernel-doc warnings when building the docs

Em Thu, 10 Sep 2020 19:12:08 +0100 Matthew Wilcox escreveu: > On Thu, Sep 10, 2020 at 12:23:53PM +0200, Mauro Carvalho Chehab wrote: > > As described on its subject, this series finally get rid of all kernel-doc > > warnings. > > > > With this series applied (plus

[PATCH] docs: net: 80211: reduce docs build time

achine with lots of ram and a fast SSD disk with Sphinx 3.2.1. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/80211/cfg80211.rst | 392 +- .../driver-api/80211/mac80211-advanced.rst| 151 +++ Documentation/driver-api/80211/mac80211.rst | 148 ++-

[PATCH] media: zoran.rst: place it at the right place this time

I was too quick moving zoran.rst... it ends that the original patch didn't do the right thing and forgot to update the files that references it. Fix it. Fixes: 6b90346919d4 ("media: zoran: move documentation file to the right place") Signed-off-by: Mauro Carvalho Chehab --- .../

[PATCH] scripts: kernel-doc: allow passing desired Sphinx C domain dialect

was not specified. On such case, emit a warning if sphinx-build can't be found at PATH. Suggested-by: Jonathan Corbet Signed-off-by: Mauro Carvalho Chehab --- Documentation/sphinx/kerneldoc.py | 5 scripts/kernel-doc| 40 --- 2 files changed, 37

[PATCH 4/4] media: add Zoran cardlist

Now that Zoran was re-added, we need to add its cardlist to the admin guide. Signed-off-by: Mauro Carvalho Chehab --- .../admin-guide/media/pci-cardlist.rst| 2 + .../admin-guide/media/zoran-cardlist.rst | 51 +++ 2 files changed, 53 insertions(+) create mode

[PATCH 1/4] media: zoran: move documentation file to the right place

The zoran revert patch misplaced the Zoran doc file. Move it to the right place. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/media/drivers/index.rst | 1 + .../{media => driver-api/media/drivers}/v4l-drivers/zoran.rst| 0 2 files changed, 1 insert

[PATCH 2/4] media: siano: rename a duplicated card string

s are different. So, better to use different names in order to distinguish between them. Signed-off-by: Mauro Carvalho Chehab --- Documentation/admin-guide/media/siano-cardlist.rst | 2 +- drivers/media/common/siano/sms-cards.c | 2 +- 2 files changed, 2 insertions(+), 2 dele

[PATCH 3/4] media: admin-guide: update cardlists

Update them according with the current support on drivers. Signed-off-by: Mauro Carvalho Chehab --- .../admin-guide/media/dvb-usb-dvbsky-cardlist.rst | 8 .../admin-guide/media/dvb-usb-dw2102-cardlist.rst | 4 Documentation/admin-guide/media/em28xx-cardlist.rst

Re: [PATCH 5/6] scripts: kernel-doc: add support for typedef enum

Hi Andrew, Em Fri, 2 Oct 2020 14:07:28 +0200 Andrew Lunn escreveu: > On Fri, Oct 02, 2020 at 07:49:49AM +0200, Mauro Carvalho Chehab wrote: > > The PHY kernel-doc markup has gained support for documenting > > a typedef enum. > > > > However, right now

Re: [PATCH 4/6] docs: i2c: index.rst: add slave-testunit-backend.rst

Em Fri, 2 Oct 2020 09:54:04 +0200 Wolfram Sang escreveu: > Hi Mauro, > > > index 8a2ad3845191..9b8df313902c 100644 > > --- a/Documentation/i2c/index.rst > > +++ b/Documentation/i2c/index.rst > > @@ -38,6 +38,7 @@ Debugging > > > > gpio-fault-injection > > i2c-stub > > +

Re: [PATCH v4 00/52] Fix html build with Sphinx 3.1 and above

Em Thu, 1 Oct 2020 15:48:54 -0600 Jonathan Corbet escreveu: > On Wed, 30 Sep 2020 15:24:23 +0200 > Mauro Carvalho Chehab wrote: > > > This series add proper support for Sphinx 3.1 and above for building the > > html docs. > > > > This series comes after th

Re: [PATCH v4 04/52] scripts: kernel-doc: make it more compatible with Sphinx 3.x

Em Thu, 1 Oct 2020 15:41:00 -0600 Jonathan Corbet escreveu: > On Wed, 30 Sep 2020 15:24:27 +0200 > Mauro Carvalho Chehab wrote: > > > With Sphinx 3.x, the ".. c:type:" tag was changed to accept either: > > > > .. c:type:: typedef-like declaration &g

[PATCH 5/6] scripts: kernel-doc: add support for typedef enum

The PHY kernel-doc markup has gained support for documenting a typedef enum. However, right now the parser was not prepared for it. So, add support for parsing it. Fixes: 4069a572d423 ("net: phy: Document core PHY structures") Signed-off-by: Mauro Carvalho Chehab --- scripts/kerne

[PATCH 1/6] net: core: document two new elements of struct net_device

or member 'nested_level' not described in 'net_device' Fixes: 1fc70edb7d7b ("net: core: add nested_level variable in net_device") Signed-off-by: Mauro Carvalho Chehab --- include/linux/netdevice.h | 5 + 1 file changed, 5 insertions(+) diff --git a/include/linux/netdevice.h b/inclu

[PATCH 6/6] docs: gpio: add a new document to its index.rst

There's now a new ReST file. Add it to the index.rst file. Fixes: ce7a2f77f976 ("docs: gpio: Add GPIO Aggregator documentation") Signed-off-by: Mauro Carvalho Chehab --- Documentation/admin-guide/gpio/index.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/Documentation/admin-

[PATCH 2/6] docs: vcpu.rst: fix some build warnings

a blank line; unexpected unindent. By marking the C code as a literal block. Fixes: 8be86a5eec04 ("KVM: arm64: Document PMU filtering API") Signed-off-by: Mauro Carvalho Chehab --- Documentation/virt/kvm/devices/vcpu.rst | 26 - 1 file changed, 13 insertions(+), 13

[PATCH 0/6] Fix new html build warnings from next-20201001

html builds with version < 3. Mauro Carvalho Chehab (6): net: core: document two new elements of struct net_device docs: vcpu.rst: fix some build warnings docs: virt: user_mode_linux_howto_v2.rst: fix a literal block markup docs: i2c: index.rst: add slave-testunit-backend.rst scri

[PATCH 4/6] docs: i2c: index.rst: add slave-testunit-backend.rst

As warned by Sphinx: .../Documentation/i2c/slave-testunit-backend.rst: WARNING: document isn't included in any toctree This document is not included anywhere. Fixes: a8335c64c5f0 ("i2c: add slave testunit driver") Signed-off-by: Mauro Carvalho Chehab --- Documentation/admi

[PATCH 3/6] docs: virt: user_mode_linux_howto_v2.rst: fix a literal block markup

There's a missing new line for a literal block: .../Documentation/virt/uml/user_mode_linux_howto_v2.rst:682: WARNING: Unexpected indentation. Fixes: 04301bf5b072 ("docs: replace the old User Mode Linux HowTo with a new one") Signed-off-by: Mauro Carvalho Chehab --- Document

Re: [PATCH v3] media: atomisp: fixes build breakage for ISP2400 due to a cleanup

Hi Andy, Em Thu, 1 Oct 2020 18:50:12 +0300 Andy Shevchenko escreveu: > On Thu, Oct 1, 2020 at 2:17 PM Mauro Carvalho Chehab > wrote: > > > > A temporary var needed for building with ISP2400 was removed > > by accident on a cleanup patch. > > > > Fix the bre

[PATCH v3] media: atomisp: fixes build breakage for ISP2400 due to a cleanup

A temporary var needed for building with ISP2400 was removed by accident on a cleanup patch. Fix the breakage. Fixes: 852a53a02cf0 ("media: atomisp: get rid of unused vars") Signed-off-by: Mauro Carvalho Chehab --- drivers/staging/media/atomisp/pci/sh_css.c | 14 +++--- 1 fi

[PATCH 2/3] media: zoran: get rid of an unused var

The jpeg_error in lowercase is not used anywhere. Drop it. Signed-off-by: Mauro Carvalho Chehab --- drivers/staging/media/zoran/zoran.h | 1 - 1 file changed, 1 deletion(-) diff --git a/drivers/staging/media/zoran/zoran.h b/drivers/staging/media/zoran/zoran.h index 7217a64fe59b..945502becd60

[PATCH 1/3] media: zoran: use upper case for card types

Don't mix case there: let's just use uppercase, as this is the common pattern for such define-like enums. Signed-off-by: Mauro Carvalho Chehab --- drivers/staging/media/zoran/zoran.h | 8 drivers/staging/media/zoran/zoran_card.c | 20 ++-- 2 files changed, 14

[PATCH 3/3] media: zoran: fix mixed case on vars

ia/zoran/*.[ch]|perl -ne 'print "$1\n" if (m/#define\s+(zr\S+)/)'); do j=$(echo $i|tr [a-z] [A-Z]); sed "s,\b$i\b,$j,g" -i drivers/staging/media/zoran/*.[ch]; done This should solve almost all warnings reported by checkpatch.pl in strict mode. Signed-off-by: Mauro Carvalho C

Re: [PATCH RFT/RFC v2 28/47] staging: media: zoran: convert mdelay to udelay

Em Fri, 25 Sep 2020 18:30:38 + Corentin Labbe escreveu: > As asked by checkpath, let's use udelay. > > Signed-off-by: Corentin Labbe > --- > drivers/staging/media/zoran/zoran_device.c | 4 ++-- > 1 file changed, 2 insertions(+), 2 deletions(-) > > diff --git

[PATCH 4/4] media: vidtv: avoid copying data for PES structs

-by: Mauro Carvalho Chehab --- drivers/media/test-drivers/vidtv/vidtv_mux.c | 30 ++-- drivers/media/test-drivers/vidtv/vidtv_pes.c | 178 +-- drivers/media/test-drivers/vidtv/vidtv_pes.h | 2 +- 3 files changed, 102 insertions(+), 108 deletions(-) diff --git a/drivers/media

[PATCH 2/4] media: vidtv: add error checks

, start_streaming will return an error that userspace can detect: ERRORDMX_SET_PES_FILTER failed (PID = 0x2000): 12 Cannot allocate memory and the driver doesn't crash. Signed-off-by: Mauro Carvalho Chehab --- .../media/test-drivers/vidtv/vidtv_bridge.c | 2 + .../media/test-drivers/vidtv

[PATCH 3/4] media: vidtv: avoid data copy when initializing the multiplexer

Initialize the fields of the arguments directly when declaring it, and pass the args as a pointer, instead of copying them. Signed-off-by: Mauro Carvalho Chehab --- .../media/test-drivers/vidtv/vidtv_bridge.c | 24 ++- drivers/media/test-drivers/vidtv/vidtv_mux.c | 24

[PATCH 1/4] media: vidtv: reorganize includes

- Place the includes on alphabetical order; - get rid of asm/byteorder.h; - add bug.h at vidtv_s302m.c, as it is needed by inux/fixp-arith.h Signed-off-by: Mauro Carvalho Chehab --- .../media/test-drivers/vidtv/vidtv_bridge.c | 8 +++ .../media/test-drivers/vidtv/vidtv_bridge.h | 2

Re: [PATCH v4 23/52] docs: trace-uses.rst: remove bogus c-domain tags

Em Thu, 1 Oct 2020 11:36:53 +0530 Kamalesh Babulal escreveu: > On 30/09/20 6:54 pm, Mauro Carvalho Chehab wrote: > > There are some c-domain tags that are wrong. While this won't > > cause problems with Sphinx < 3.0, this cause troubles with > > newer versions, as the

Re: [PATCH v4 35/52] docs: fs: fscrypt.rst: get rid of :c:type: tags

Hi Eric, Em Wed, 30 Sep 2020 09:21:44 -0700 Eric Biggers escreveu: > On Wed, Sep 30, 2020 at 03:24:58PM +0200, Mauro Carvalho Chehab wrote: > > The :c:type: tag has problems with Sphinx 3.x, as structs > > there should be declared with c:struct. > > > &g

Re: [PATCH v4 19/52] memblock: get rid of a :c:type leftover

Em Wed, 30 Sep 2020 17:23:23 +0300 Mike Rapoport escreveu: > Hello Mauro, > > On Wed, Sep 30, 2020 at 03:24:42PM +0200, Mauro Carvalho Chehab wrote: > > chanseset b3a7bb1851c8 ("docs: get rid of :c:type explicit declarations for > > structs") > > removed se

[PATCH v2] media: atomisp: fixes a breakage due to a cleanup patch

A temporary var needed for building with ISP2400 was removed by accident on a cleanup patch. Fix the breakage. Fixes: 852a53a02cf0 ("media: atomisp: get rid of unused vars") Signed-off-by: Mauro Carvalho Chehab --- v2: fixed a typo at comment: ISP2401 -> ISP2400 drivers/staging/

[PATCH] media: atomisp: fixes a breakage due to a cleanup patch

A temporary var needed for building with ISP2401 was removed by accident on a cleanup patch. Fix the breakage. Fixes: 852a53a02cf0 ("media: atomisp: get rid of unused vars") Signed-off-by: Mauro Carvalho Chehab --- drivers/staging/media/atomisp/pci/sh_css.c | 3 +-- 1 file changed, 1

[PATCH v4 12/52] media: docs: make CEC documents compatible with Sphinx 3.1+

Sphinx 3.x broke support for the cdomain.py extension, as the c domain code was rewritten. Due to that, the c tags need to be re-written, in order to use the new c domain notation. Signed-off-by: Mauro Carvalho Chehab --- .../media/cec/cec-func-close.rst | 10 +++--- .../media

[PATCH v4 05/52] scripts: kernel-doc: use a less pedantic markup for funcs on Sphinx 3.x

macros. So, let's instead use the :c:macro notation. This will produce an output that it is not as nice as currently, but it should still be acceptable, and will provide cross-references, removing thousands of warnings when building with newer versions of Sphinx. Signed-off-by: Mauro Carvalho Chehab

[PATCH v4 19/52] memblock: get rid of a :c:type leftover

t. Signed-off-by: Mauro Carvalho Chehab --- mm/memblock.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/mm/memblock.c b/mm/memblock.c index 165f40a8a254..326c6b3fec1d 100644 --- a/mm/memblock.c +++ b/mm/memblock.c @@ -50,8 +50,8 @@ * * Each region is represented

[PATCH v4 08/52] scripts: kernel-doc: fix typedef identification

Some typedef expressions are output as normal functions. As we need to be clearer about the type with Sphinx 3.x, detect such cases. While here, fix a wrongly-indented block. Signed-off-by: Mauro Carvalho Chehab --- scripts/kernel-doc | 62 ++ 1

[PATCH v4 26/52] docs: genericirq.rst: don't document chip.c functions twice

Currently, kernel/irq/chip.c is included twice, one for export functions, and then for internal ones. However, as the :export: and :internal: tags are missing, they ended being included twice. Signed-off-by: Mauro Carvalho Chehab --- Documentation/core-api/genericirq.rst | 2 ++ 1 file changed

[PATCH v4 11/52] docs: kerneldoc.py: add support for kerneldoc -nosymbol

Currently, there's no way to exclude identifiers from a kernel-doc markup. Add support for it. Signed-off-by: Mauro Carvalho Chehab --- Documentation/doc-guide/kernel-doc.rst | 8 Documentation/sphinx/kerneldoc.py | 7 +++ 2 files changed, 15 insertions(+) diff --git

[PATCH v4 10/52] docs: kerneldoc.py: append the name of the parsed doc file

/kernel-api:171: ../lib/math/div64.c:73: WARNING: Duplicate C declaration, also defined in 'kernel-api'. Declaration is 'div_s64_rem'. Signed-off-by: Mauro Carvalho Chehab --- Documentation/sphinx/kerneldoc.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git

[PATCH v4 09/52] scripts: kernel-doc: don't mangle with parameter list

printing the function prototype and when describing each argument. Signed-off-by: Mauro Carvalho Chehab --- scripts/kernel-doc | 26 ++ 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/scripts/kernel-doc b/scripts/kernel-doc index a0344c78c641..f549837d874d

[PATCH v4 18/52] math64.h: kernel-docs: Convert some markups into normal comments

'. ./lib/math/div64.c:172: WARNING: Duplicate C declaration, also defined in 'core-api/kernel-api'. Declaration is 'div64_s64'. In order to avoid Sphinx warnings about duplication, change the kernel-doc markups to just comments at math64.h. Signed-off-by: Mauro Carvalho Chehab

[PATCH v4 02/52] docs: cdomain.py: extend it to handle new Sphinx 3.x tags

out losing backward compatibility. This should allow fixing the remaining warnings with the Kernel tags. Signed-off-by: Mauro Carvalho Chehab --- Documentation/sphinx/cdomain.py | 40 - 1 file changed, 39 insertions(+), 1 deletion(-) diff --git a/Documentation/sph

[PATCH v4 04/52] scripts: kernel-doc: make it more compatible with Sphinx 3.x

sn't exist on older versions. Add a check for the Sphinx version and change the produced tags accordingly. Signed-off-by: Mauro Carvalho Chehab --- scripts/kernel-doc | 71 ++ 1 file changed, 65 insertions(+), 6 deletions(-) diff --git a/scripts/ke

[PATCH v4 07/52] scripts: kernel-doc: reimplement -nofunction argument

output, no matter what mode is used. The parameter was also renamed to "-nosymbol", as it express better its meaning. Signed-off-by: Mauro Carvalho Chehab --- scripts/kernel-doc | 44 +--- 1 file changed, 21 insertions(+), 23 deletions(-)

[PATCH v4 24/52] docs: it_IT: fix namespace collisions at locking.rst

that. Signed-off-by: Mauro Carvalho Chehab --- Documentation/translations/it_IT/kernel-hacking/locking.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Documentation/translations/it_IT/kernel-hacking/locking.rst b/Documentation/translations/it_IT/kernel-hacking/locking.rst index 4615df5723fb

<    6   7   8   9   10   11   12   13   14   15   >