[PATCH v6 79/80] drm: drm_edid: remove a duplicated kernel-doc declaration

-kms-helpers'. Declaration is 'bool drm_edid_are_equal (const struct edid *edid1, const struct edid *edid2)'. So, get rid of the duplicated kernel-doc markup. Signed-off-by: Mauro Carvalho Chehab --- include/drm/drm_edid.h | 7 --- 1 file changed, 7 deletions(-) diff --git a/include

[PATCH v6 71/80] Input: sparse-keymap: add a description for @sw

Add a description for it, in order to avoids this warning: ./include/linux/input/sparse-keymap.h:43: warning: Function parameter or member 'sw' not described in 'key_entry' Signed-off-by: Mauro Carvalho Chehab --- include/linux/input/sparse-keymap.h | 1 + 1 file changed, 1 insertion

[PATCH v6 48/80] 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 v6 77/80] 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 v6 46/80] 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 v6 00/80] htmldoc build fixes with Sphinx 2.x and 3.x

://lore.kernel.org/lkml/20201012134139.0d58f...@coco.lan/ My plan is to send a pull request with those patches after Thursday's linux next release. On this series, I removed the patches that depend on material currently found only at linux-next. Mauro Carvalho Chehab (79): scripts: kernel-doc: add

[PATCH v6 76/80] 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

[PATCH v6 51/80] 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 v6 49/80] 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 0a102d57437d..e1b16556e378 100644 --- a/Documentation/conf.py +++ b/Documentation

[PATCH v6 74/80] gpu: docs: amdgpu.rst: get rid of wrong kernel-doc markups

altogether. For amdgpu_ras.c, however, we need to remove the kernel-doc with just internal. This should be re-introduced if this file ever gets new non-DOC markups. Signed-off-by: Mauro Carvalho Chehab --- Documentation/gpu/amdgpu.rst | 7 --- 1 file changed, 7 deletions(-) diff --git

[PATCH v6 52/80] 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 v6 50/80] 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 v6 55/80] 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 670216826940..a06e68b1e5a0 100644 --- a/mm/memblock.c +++ b/mm/memblock.c @@ -50,8 +50,8 @@ * * Each region is represented

[PATCH v6 45/80] 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 v6 75/80] drm: kernel-doc: add description for a new function parameter

Signed-off-by: Mauro Carvalho Chehab --- drivers/gpu/drm/drm_prime.c | 1 + 1 file changed, 1 insertion(+) diff --git a/drivers/gpu/drm/drm_prime.c b/drivers/gpu/drm/drm_prime.c index 1693aa7c14b5..1395688930f8 100644 --- a/drivers/gpu/drm/drm_prime.c +++ b/drivers/gpu/drm/drm_prime.c @@ -793,6 +7

[PATCH v6 37/80] 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 v6 59/80] docs: powerpc: syscall64-abi.rst: fix a malformed table

Volatile (System call number.) This table requires a different notation to be valid. Signed-off-by: Mauro Carvalho Chehab --- Documentation/powerpc/syscall64-abi.rst | 32 - 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/Documentation/powerpc

[PATCH v6 60/80] block: bio: fix a warning at the kernel-doc markups

ble to use, instead, this kernel-doc markup: ``bio's`` parent Yet, here, is probably simpler to just use an altenative language: the parent of @bio Signed-off-by: Mauro Carvalho Chehab --- block/bio.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/block/bio

[PATCH v6 58/80] drivers: net: hamradio: fix document location

The hamradio docs were moved to a different dir. Update its location accordingly. Fixes: 14474950252c ("docs: networking: move z8530 to the hw driver section") Signed-off-by: Mauro Carvalho Chehab --- drivers/net/hamradio/scc.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)

[PATCH v6 57/80] net: appletalk: Kconfig: Fix docs location

The location of ltpc.rst changed. Update it at Kconfig. Fixes: 4daedf7abb41 ("docs: networking: move AppleTalk / LocalTalk drivers to the hw driver section") Signed-off-by: Mauro Carvalho Chehab --- drivers/net/appletalk/Kconfig | 2 +- 1 file changed, 1 insertion(+), 1 deletio

[PATCH v6 73/80] drm: kernel-doc: drm_dp_helper.h: fix a typo

Right now, kernel-doc generates a warning: ./include/drm/drm_dp_helper.h:1786: warning: Function parameter or member 'hbr2_reset' not described in 'drm_dp_phy_test_params' This is due to a typo: @hb2_reset -> @hbr2_reset Signed-off-by: Mauro Carvalho Chehab --- include/

[PATCH v6 72/80] drm/amd/display: kernel-doc: document force_timing_sync

4e52d0cf24 ("drm/amd/display: Add debugfs for forcing stream timing sync") Signed-off-by: Mauro Carvalho Chehab --- drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h | 2 ++ 1 file changed, 2 insertions(+) diff --git a/drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h b/drivers/gpu/drm/a

[PATCH v6 54/80] 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 v6 18/80] 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 v6 62/80] docs: bio: fix a kerneldoc markup

Fix this warning: ./block/bio.c:1098: WARNING: Inline emphasis start-string without end-string. The thing is that *iter is not a valid markup. That seems to be a typo: *iter -> @iter Signed-off-by: Mauro Carvalho Chehab --- block/bio.c | 2 +- 1 file changed, 1 insert

[PATCH v6 61/80] kunit: test.h: solve kernel-doc warnings

, the free argument is described as user-provided. So, this doesn't seem to belong to the "private" part of the struct. Signed-off-by: Mauro Carvalho Chehab --- include/kunit/test.h | 12 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/include/kunit/test.h b/inc

[PATCH v6 53/80] media: uAPI: buffer.rst: remove a left-over documentation

The "flat-table" directive is empty; content required. .. flat-table:: :header-rows: 0 :stub-columns: 0 :widths: 3 1 4 Fixes: 129134e5415d ("media: media/v4l2: remove V4L2_FLAG_MEMORY_NON_CONSISTENT flag") Signed

[PATCH v6 68/80] nl80211: docs: add a description for s1g_cap parameter

g_cap' not described in 'ieee80211_supported_band' Add a documentation for it. Fixes: df78a0c0b67d ("nl80211: S1G band and channel definitions") Signed-off-by: Mauro Carvalho Chehab --- include/net/cfg80211.h | 1 + 1 file changed, 1 insertion(+) diff --git a/include/net/cfg80211.h b/include/net

[PATCH v6 69/80] IB/srpt: docs: add a description for cq_size member

parameter or member 'cq_size' not described in 'srpt_rdma_ch' Add a description for it. Fixes: c804af2c1d31 ("IB/srpt: use new shared CQ mechanism") Signed-off-by: Mauro Carvalho Chehab --- drivers/infiniband/ulp/srpt/ib_srpt.h | 1 + 1 file changed, 1 insertion(+) diff --git a/drivers/in

[PATCH v6 23/80] 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 v6 44/80] 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 v6 63/80] drivers: core: fix kernel-doc markup for dev_err_probe()

unindent. ./drivers/base/core.c:4223: WARNING: Block quote ends without a blank line; unexpected unindent. Fixes: a787e5400a1c ("driver core: add device probe log helper") Signed-off-by: Mauro Carvalho Chehab --- drivers/base/core.c | 7 +-- 1 file changed, 5 insertions(+), 2

[PATCH v6 64/80] kunit: test.h: fix a bad kernel-doc markup

. Signed-off-by: Mauro Carvalho Chehab --- include/kunit/test.h | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/include/kunit/test.h b/include/kunit/test.h index 41b3a266bf8c..5c5ed262a950 100644 --- a/include/kunit/test.h +++ b/include/kunit/test.h @@ -498,8 +498,8

[PATCH v6 31/80] docs: scsi: target.rst: remove iSCSI transport class kernel-doc markup

This is already included at scsi.rst. So, remove the duplication, in order to avoid Sphinx warnings. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/target.rst | 12 1 file changed, 12 deletions(-) diff --git a/Documentation/driver-api/target.rst b/Documentation

[PATCH v6 67/80] usb: docs: document altmode register/unregister functions

. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/usb/typec_bus.rst | 8 +++- include/linux/usb/typec_altmode.h | 16 2 files changed, 23 insertions(+), 1 deletion(-) diff --git a/Documentation/driver-api/usb/typec_bus.rst b/Documentation/driver-api

[PATCH v6 65/80] docs: amdgpu: fix a warning when building the documentation

As reported by Sphinx: Documentation/gpu/amdgpu.rst:200: WARNING: Inline emphasis start-string without end-string. Signed-off-by: Mauro Carvalho Chehab --- Documentation/gpu/amdgpu.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/gpu/amdgpu.rst

[PATCH v6 56/80] dt-bindings: fix references to files converted to yaml

There were several files converted to yaml, but the .txt file is still referenced somewhere else. Update the references for them to point to the right file. Signed-off-by: Mauro Carvalho Chehab --- .../bindings/display/tilcdc/tilcdc.txt | 2 +- .../devicetree/bindings/mailbox/omap

[PATCH v6 03/80] 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 v6 06/80] 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 v6 32/80] 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 v6 07/80] 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 v6 34/80] 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 v6 01/80] 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 v6 15/80] 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 v6 11/80] docs: cdomain.py: add support for a new Sphinx 3.1+ tag

o be compatible with both Sphinx 1.x/2.x and 3.1+. Signed-off-by: Mauro Carvalho Chehab --- Documentation/sphinx/cdomain.py | 55 - 1 file changed, 54 insertions(+), 1 deletion(-) diff --git a/Documentation/sphinx/cdomain.py b/Documentation/sphinx/cdomain.py ind

[PATCH v6 02/80] 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 v6 05/80] 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(-)

Re: [PATCH v3 01/11] counters: Introduce counter_atomic* counters

Em Fri, 9 Oct 2020 09:55:56 -0600 Shuah Khan escreveu: > Introduce Simple atomic counters. > > There are a number of atomic_t usages in the kernel where atomic_t api > is used strictly for counting and not for managing object lifetime. In > some cases, atomic_t might not even be needed. > >

Re: [PATCH v6 2/5] kunit: test: create a single centralized executor for all tests

Em Tue, 4 Aug 2020 13:47:42 -0700 Brendan Higgins escreveu: > From: Alan Maguire > > Add a centralized executor to dispatch tests rather than relying on > late_initcall to schedule each test suite separately. Centralized > execution is for built-in tests only; modules will execute tests when

Re: [GIT PULL] Documentation for 5.10

Em Tue, 13 Oct 2020 20:58:56 +1100 Stephen Rothwell escreveu: > Hi Mauro, > > On Tue, 13 Oct 2020 10:49:50 +0200 Mauro Carvalho Chehab > wrote: > > > > If everything goes well on tomorrow's next, I'll send you a pull request > > with those. > > Sorry, ba

Re: [PATCH 1/2] MAINTAINERS: fix broken doc refs due to yaml conversion

Em Mon, 12 Oct 2020 14:21:14 -0500 Rob Herring escreveu: > On Fri, Oct 09, 2020 at 02:15:30PM +0200, Mauro Carvalho Chehab wrote: > > Several *.txt files got converted to yaml. Update their > > references at MAINTAINERS file accordingly. > > > > Signed-of

Re: [GIT PULL] Documentation for 5.10

Hi Linus, Em Mon, 12 Oct 2020 13:30:42 -0600 Jonathan Corbet escreveu: > As hoped, things calmed down for docs this cycle; fewer changes and almost > no conflicts at all. This pull includes: > > - A reworked and expanded user-mode Linux document > - Some simplifications and improvements for

[PATCH v5.1 10/52] scripts: kernel-doc: allow passing desired Sphinx C domain dialect

-to: Joe Perches Suggested-by: Jonathan Corbet Signed-off-by: Mauro Carvalho Chehab --- v5.1: - Right now, the script only needs to know the Sphinx major version. So, relax the regex to allow entering version on 3 different formats: x x.y x.y.z - if Sphinx output mode

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

Em Tue, 6 Oct 2020 08:01:34 -0600 Jonathan Corbet escreveu: > On Tue, 6 Oct 2020 08:42:07 +0200 > Mauro Carvalho Chehab wrote: > > > As right now we don't support Sphinx version 3.0[1], we're actually using > > just > > $sphinx_major. So, I'm wonder if it wo

[GIT PULL for v5.10-rc1] media updates

ubsection Maheshwar Ajja (1): media: v4l2-ctrls: Add encoder constant quality control Marek Szyprowski (3): media: pci: fix common ALSA DMA-mapping related codes media: videobuf2: use sgtable-based scatterlist wrappers media: platform: s5p-mfc: Fix adding a standard frame skip mo

Re: [PATCH v3 2/2] media: mtk-vcodec: fix build breakage when one of VPU or SCP is enabled

Em Mon, 12 Oct 2020 14:35:57 +0900 Alexandre Courbot escreveu: > The addition of MT8183 support added a dependency on the SCP remoteproc > module. However the initial patch used the "select" Kconfig directive, > which may result in the SCP module to not be compiled if remoteproc was > disabled.

Re: [PATCH v2] media: mtk-vcodec: fix builds when remoteproc is disabled

Em Mon, 12 Oct 2020 13:58:51 +0900 Alexandre Courbot escreveu: > Hi Mauro, > > On Fri, Oct 9, 2020 at 3:34 PM Mauro Carvalho Chehab > wrote: > > > > Em Fri, 9 Oct 2020 13:30:06 +0900 > > Alexandre Courbot escreveu: > > > > > On Fri, Oct

Re: [PATCH v2 09/17] mm: Add unsafe_follow_pfn

Em Sun, 11 Oct 2020 08:27:41 +0200 Mauro Carvalho Chehab escreveu: > Em Sat, 10 Oct 2020 23:50:27 +0200 > Daniel Vetter escreveu: > > > On Sat, Oct 10, 2020 at 11:36 PM Laurent Pinchart > > wrote: > > > > > > > > We probably still ha

Re: [PATCH v2 09/17] mm: Add unsafe_follow_pfn

Em Sat, 10 Oct 2020 23:50:27 +0200 Daniel Vetter escreveu: > On Sat, Oct 10, 2020 at 11:36 PM Laurent Pinchart > wrote: > > > > > We probably still have a few legacy drivers using videobuf (non-2), > > > but IMHO those should be safe to put behind some disabled-by-default > > > Kconfig symbol

Re: [PATCH v2 09/17] mm: Add unsafe_follow_pfn

Em Fri, 9 Oct 2020 19:52:05 +0200 Daniel Vetter escreveu: > On Fri, Oct 9, 2020 at 2:48 PM Jason Gunthorpe wrote: > > > > On Fri, Oct 09, 2020 at 02:37:23PM +0200, Mauro Carvalho Chehab wrote: > > > > > I'm not a mm/ expert, but, from what I understood from Da

Re: [PATCH v2 09/17] mm: Add unsafe_follow_pfn

Em Sat, 10 Oct 2020 12:53:49 +0200 Daniel Vetter escreveu: > Hi Mauro, > > You might want to read the patches more carefully, because what you're > demanding is what my patches do. Short summary: > > - if STRICT_FOLLOW_PFN is set: > a) normal memory is handled as-is (i.e. your example works)

Re: [PATCH v2 10/17] media/videbuf1|2: Mark follow_pfn usage as unsafe

Em Fri, 9 Oct 2020 09:59:27 +0200 Daniel Vetter escreveu: > The media model assumes that buffers are all preallocated, so that > when a media pipeline is running we never miss a deadline because the > buffers aren't allocated or available. > > This means we cannot fix the v4l follow_pfn usage

[RFC PATCH] scripts: kernel-doc: allow printing the documented symbols

It is useful to know what symbols are documented, as scripts could use this in order to check for documentation issues. This comes almost for free from kernel-doc parsing. So, add support for it. Signed-off-by: Mauro Carvalho Chehab --- While checking what's documented on some media files, I

Re: [PATCH v2 09/17] mm: Add unsafe_follow_pfn

Em Fri, 9 Oct 2020 14:37:23 +0200 Mauro Carvalho Chehab escreveu: > Em Fri, 9 Oct 2020 09:21:11 -0300 > Jason Gunthorpe escreveu: > > > On Fri, Oct 09, 2020 at 12:34:21PM +0200, Mauro Carvalho Chehab wrote: > > > Hi, > > > > > > Em Fri, 9 O

Re: [PATCH v2 09/17] mm: Add unsafe_follow_pfn

Em Fri, 9 Oct 2020 09:21:11 -0300 Jason Gunthorpe escreveu: > On Fri, Oct 09, 2020 at 12:34:21PM +0200, Mauro Carvalho Chehab wrote: > > Hi, > > > > Em Fri, 9 Oct 2020 09:59:26 +0200 > > Daniel Vetter escreveu: > > > > > Way back it was a reason

[PATCH 2/2] crypto: sun8x-ce*: update entries to its documentation

The README file was converted to ReST format. Update the references for it accordingly. Signed-off-by: Mauro Carvalho Chehab --- drivers/crypto/allwinner/sun8i-ce/sun8i-ce-hash.c | 2 +- drivers/crypto/allwinner/sun8i-ce/sun8i-ce-prng.c | 2 +- drivers/crypto/allwinner/sun8i-ce/sun8i-ce-trng.c

[PATCH 1/2] MAINTAINERS: fix broken doc refs due to yaml conversion

Several *.txt files got converted to yaml. Update their references at MAINTAINERS file accordingly. Signed-off-by: Mauro Carvalho Chehab --- Documentation/devicetree/bindings/clock/hi6220-clock.txt | 2 +- MAINTAINERS | 9 - .../devicetree

[PATCH 0/2] Fix new warnings at linux-next

There are some file renames at linux-next that are causing some new documentation warnings. Address them. Mauro Carvalho Chehab (2): MAINTAINERS: fix broken doc refs due to yaml conversion crypto: sun8x-ce*: update entries to its documentation Documentation/devicetree/bindings/clock/hi6220

Re: [PATCH v2 09/17] mm: Add unsafe_follow_pfn

Hi, Em Fri, 9 Oct 2020 09:59:26 +0200 Daniel Vetter escreveu: > Way back it was a reasonable assumptions that iomem mappings never > change the pfn range they point at. But this has changed: > > - gpu drivers dynamically manage their memory nowadays, invalidating > ptes with

Re: [PATCH v2 06/17] media: videobuf2: Move frame_vector into media subsystem

viewed-by: John Hubbard > Signed-off-by: Daniel Vetter > Cc: Jason Gunthorpe > Cc: Pawel Osciak > Cc: Marek Szyprowski > Cc: Kyungmin Park > Cc: Tomasz Figa > Cc: Mauro Carvalho Chehab > Cc: Andrew Morton > Cc: John Hubbard > Cc: Jérôme Glisse > Cc: Jan Kara &

[PATCH] kernel-doc: fix line number handling

d. Signed-off-by: Mauro Carvalho Chehab --- scripts/kernel-doc | 6 -- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/scripts/kernel-doc b/scripts/kernel-doc index a3453de4495c..297312824d26 100755 --- a/scripts/kernel-doc +++ b/scripts/kernel-doc @@ -1706,7 +1706,7 @@ sub dum

Re: [PATCH] docs: Make automarkup ready for Sphinx 3.1+

Em Thu, 08 Oct 2020 13:54:59 + Nícolas F. R. A. Prado escreveu: > On Thu Oct 8, 2020 at 2:27 AM -03, Mauro Carvalho Chehab wrote: > > > > Hi Nícolas, > > > > Em Wed, 07 Oct 2020 23:12:25 + > > Nícolas F. R. A. Prado escreveu: > > > &g

Re: [PATCH] docs: Make automarkup ready for Sphinx 3.1+

Em Thu, 8 Oct 2020 12:31:27 +0100 Matthew Wilcox escreveu: > On Thu, Oct 08, 2020 at 08:03:06AM +0200, Mauro Carvalho Chehab wrote: > > Em Thu, 8 Oct 2020 03:47:06 +0100 > > Matthew Wilcox escreveu: > > > > > On Thu, Oct 08, 2020 at 02:15:24AM +

[PATCH] scripts: check_docs_external_symbols: speed up its execution

sys 0m2,048s After it: $ time scripts/check_docs_external_symbols drivers/media/v4l2-core/ ... real0m3,153s user0m19,322s sys 0m2,738s So, it is now almost 4 times faster. Signed-off-by: Mauro Carvalho Chehab --- scripts

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

Em Wed, 7 Oct 2020 15:31:10 +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 direction. Th

Re: [PATCH v2] misc: Kconfig: add a new dependency for HISI_HIKEY_USB

Em Thu, 8 Oct 2020 08:14:43 +0200 Greg Kroah-Hartman escreveu: > On Thu, Oct 08, 2020 at 07:30:27AM +0200, Mauro Carvalho Chehab wrote: > > As warned by Randy: > > > > on x86_64: > > CONFIG_USB_ROLE_SWITCH=m > > and HISI_HIKEY_USB=y. > > &g

[PATCH] misc: Kconfig: fix a HISI_HIKEY_USB dependency

The dependency should be just USB_ROLE_SWITCH, instead of CONFIG_USB_ROLE_SWITCH. Fixes: 2827d98bc5d6 ("misc: Kconfig: add a new dependency for HISI_HIKEY_USB") Reported-by: Nathan Chancellor Signed-off-by: Mauro Carvalho Chehab --- drivers/misc/Kconfig | 2 +- 1 file changed, 1

Re: [PATCH] docs: Make automarkup ready for Sphinx 3.1+

Em Thu, 8 Oct 2020 03:47:06 +0100 Matthew Wilcox escreveu: > On Thu, Oct 08, 2020 at 02:15:24AM +, Nícolas F. R. A. Prado wrote: > > > I have a feature request ... could you automarkup NULL as being > > > :c:macro? > > > Or maybe just anything matching \<[[:upper:]_[:digit:]]*\> > > > (i may

Re: [PATCH] misc: Kconfig: add a new dependency for HISI_HIKEY_USB

Em Wed, 7 Oct 2020 19:52:56 -0700 Randy Dunlap escreveu: > On 10/7/20 7:18 PM, Nathan Chancellor wrote: > > On Wed, Oct 07, 2020 at 07:09:54AM +0200, Mauro Carvalho Chehab wrote: > >> As warned by Randy: > >> > >>on x86_64: > >>CONFIG_U

[PATCH v2] misc: Kconfig: add a new dependency for HISI_HIKEY_USB

: hisi_hikey_usb.c:(.text+0xa08): undefined reference to `usb_role_switch_register' ld: hisi_hikey_usb.c:(.text+0xa6e): undefined reference to `usb_role_switch_put' Make it dependent on CONFIG_USB_ROLE_SWITCH. Reported-by: Randy Dunlap Signed-off-by: Mauro Carvalho Chehab --- drivers/misc

Re: [PATCH] docs: Make automarkup ready for Sphinx 3.1+

Hi Nícolas, Em Wed, 07 Oct 2020 23:12:25 + Nícolas F. R. A. Prado escreveu: > While Sphinx 2 used a single c:type role for struct, union, enum and > typedef, Sphinx 3 uses a specific role for each one. > To keep backward compatibility, detect the Sphinx version and use the > correct roles

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

Em Wed, 07 Oct 2020 01:32:31 -0700 Joe Perches escreveu: > On Wed, 2020-10-07 at 11:23 +0300, Jani Nikula wrote: > > On Tue, 06 Oct 2020, Mauro Carvalho Chehab > > wrote: > > > While not all EXPORT_SYMBOL*() symbols should be documented, > > > it seems usefu

[PATCH v3] 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 | 289 1 file changed, 289 insertions(+) create mode 100755 scripts/check_docs_external_symbols diff --git a/scripts

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

Em Wed, 7 Oct 2020 13:43:59 +0200 Greg Kroah-Hartman escreveu: > On Wed, Oct 07, 2020 at 01:05:49PM +0200, Mauro Carvalho Chehab wrote: > > Em Wed, 7 Oct 2020 11:06:19 +0200 > > Greg Kroah-Hartman escreveu: > > > > > On Wed, Oct 07, 2020 at 10:57:02AM +020

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

Em Wed, 7 Oct 2020 13:29:04 +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 direction. Th

[PATCH v2] 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 | 267 1 file changed, 267 insertions(+) create mode 100755 scripts/check_docs_external_symbols diff --git a/scripts

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

Em Wed, 7 Oct 2020 11:06:19 +0200 Greg Kroah-Hartman escreveu: > On Wed, Oct 07, 2020 at 10:57:02AM +0200, Mauro Carvalho Chehab wrote: > > Em Wed, 7 Oct 2020 10:32:27 +0300 > > Ivan Zaentsev escreveu: > > > > > Tuesday, October 6, 2020, 4:19:15 P

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

Em Wed, 7 Oct 2020 10:32:27 +0300 Ivan Zaentsev escreveu: > Tuesday, October 6, 2020, 4:19:15 PM, Mauro Carvalho Chehab wrote: > > >> diff --git a/Documentation/w1/slaves/w1_therm.rst > >> b/Documentation/w1/slaves/w1_therm.rst > >> index

[PATCH] misc: Kconfig: add a new dependency for HISI_HIKEY_USB

: hisi_hikey_usb.c:(.text+0xa08): undefined reference to `usb_role_switch_register' ld: hisi_hikey_usb.c:(.text+0xa6e): undefined reference to `usb_role_switch_put' Make it dependent on CONFIG_USB_ROLE_SWITCH. Reported-by: Randy Dunlap Signed-off-by: Mauro Carvalho Chehab --- drivers/misc

[PATCH v5 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 v5 01/52] docs: cdomain.py: add support for a new Sphinx 3.1+ tag

o be compatible with both Sphinx 1.x/2.x and 3.1+. Signed-off-by: Mauro Carvalho Chehab --- Documentation/sphinx/cdomain.py | 55 - 1 file changed, 54 insertions(+), 1 deletion(-) diff --git a/Documentation/sphinx/cdomain.py b/Documentation/sphinx/cdomain.py ind

[PATCH v5 18/52] media: cec-core.rst: don't use c:type for structs

The new C domain code on Sphinx 3 doesn't allow anymore to use c:type:: for structs. Now that cdomain.py has backward support, let's use c:struct:: instead. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/media/cec-core.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion

[PATCH v5 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 v5 06/52] scripts: kernel-doc: fix troubles with line counts

pens the handle "IN". This makes the line number to be incremented, as the handler for the main open is also "IN". Fix the problem by using a different handler for the main open(). While here, add a missing close for it. Signed-off-by: Mauro Carvalho Chehab --- scripts/kernel

[PATCH v5 11/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 v5 24/52] docs: it_IT: fix namespace collisions at locking.rst

that. Acked-by: Federico Vaga 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

[PATCH v5 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 v5 20/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 v5 10/52] scripts: kernel-doc: allow passing desired Sphinx C domain dialect

-to: Joe Perches Suggested-by: Jonathan Corbet Signed-off-by: Mauro Carvalho Chehab --- Documentation/sphinx/kerneldoc.py | 5 scripts/kernel-doc| 44 +-- 2 files changed, 41 insertions(+), 8 deletions(-) diff --git a/Documentation/sphinx

[PATCH v5 30/52] docs: scsi: target.rst: remove iSCSI transport class kernel-doc markup

This is already included at scsi.rst. So, remove the duplication, in order to avoid Sphinx warnings. Signed-off-by: Mauro Carvalho Chehab --- Documentation/driver-api/target.rst | 12 1 file changed, 12 deletions(-) diff --git a/Documentation/driver-api/target.rst b/Documentation

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