[tip:timers/core] timers: Adjust a kernel-doc comment

Commit-ID: bf9c96bec76fbc4424b4c70be563af4107d8044f Gitweb: https://git.kernel.org/tip/bf9c96bec76fbc4424b4c70be563af4107d8044f Author: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> AuthorDate: Mon, 7 May 2018 06:35:48 -0300 Committer: Thomas Gleixner <t...@linutronix.de>

Re: [PATCH v2 00/11] Fix some doc build warnings/errors and broken links

Em Thu, 10 May 2018 14:22:35 -0600 Jonathan Corbet <cor...@lwn.net> escreveu: > On Wed, 9 May 2018 10:18:43 -0300 > Mauro Carvalho Chehab <mchehab+sams...@kernel.org> wrote: > > > Patches 1 to 5 on this series contain the patches that weren't yet > > applied fro

Re: [PATCH 13/18] wait: wait.h: Get rid of a kernel-doc/Sphinx warnings

Em Thu, 10 May 2018 18:52:20 +0200 Andrea Parri escreveu: > On Thu, May 10, 2018 at 07:15:59AM -0600, Jonathan Corbet wrote: > > On Thu, 10 May 2018 14:23:35 +0200 > > Andrea Parri wrote: > > > > > only > > > remember that

Re: [PATCH 13/18] wait: wait.h: Get rid of a kernel-doc/Sphinx warnings

Em Thu, 10 May 2018 13:42:58 -0300 Mauro Carvalho Chehab <mchehab+sams...@kernel.org> escreveu: > Em Thu, 10 May 2018 09:38:46 -0600 > Jonathan Corbet <cor...@lwn.net> escreveu: > > > On Thu, 10 May 2018 11:21:13 -0300 > > Mauro Carvalho Chehab &

Re: [PATCH 13/18] wait: wait.h: Get rid of a kernel-doc/Sphinx warnings

Em Thu, 10 May 2018 09:38:46 -0600 Jonathan Corbet <cor...@lwn.net> escreveu: > On Thu, 10 May 2018 11:21:13 -0300 > Mauro Carvalho Chehab <mchehab+sams...@kernel.org> wrote: > > > The problem with a hint-based mechanism is that it will generate > > false hints

[RFC PATCH 1/2] scripts/kernel-doc: Auto-detect common code-blocks

Comments that end with a comma and have certain keywords should be presented as code-blocks Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- scripts/kernel-doc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/scripts/kernel-doc b/scripts/kernel-doc

[RFC PATCH 2/2] wait: add a keyword to indicate a diagram code block on a kernel-doc

When handling code-blocks, usual parsing should be disabled. Indicate it by using the keyword disagram. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- include/linux/wait.h | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/include/linux/wait.h b/i

Re: [PATCH 13/18] wait: wait.h: Get rid of a kernel-doc/Sphinx warnings

Em Thu, 10 May 2018 07:30:12 -0600 Jonathan Corbet <cor...@lwn.net> escreveu: > On Thu, 10 May 2018 06:38:05 -0300 > Mauro Carvalho Chehab <mchehab+sams...@kernel.org> wrote: > > > (Peter said): > > > Independent of any philosophical discussion not allowing

Re: [PATCH 13/18] wait: wait.h: Get rid of a kernel-doc/Sphinx warnings

Em Thu, 10 May 2018 14:20:36 +0200 Peter Zijlstra <pet...@infradead.org> escreveu: > On Thu, May 10, 2018 at 06:38:05AM -0300, Mauro Carvalho Chehab wrote: > > Em Thu, 10 May 2018 01:38:38 -0700 > > Christoph Hellwig <h...@infradead.org> escreveu: > > >

Re: [PATCH 13/18] wait: wait.h: Get rid of a kernel-doc/Sphinx warnings

Em Thu, 10 May 2018 01:38:38 -0700 Christoph Hellwig escreveu: > > * Use either while holding wait_queue_head::lock or when used for wakeups > > - * with an extra smp_mb() like: > > + * with an extra smp_mb() like:: > > Independent of any philosophical discussion not

Re: [PATCH v2 04/11] docs: dell_rbu.txt: fix location of request_firmware

Em Wed, 9 May 2018 10:18:47 -0300 Mauro Carvalho Chehab <mchehab+sams...@kernel.org> escreveu: > commit 5d6d1ddd2730 ("firmware: move firmware loader into its own directory") > and other commits renamed the old firmware_class.c file and split it > into separate

Re: [PATCH v2 08/11] docs: refcount-vs-atomic.rst: prefix url with https

Em Wed, 9 May 2018 15:43:19 +0200 Andrea Parri <andrea.pa...@amarulasolutions.com> escreveu: > Hi Mauro, > > On Wed, May 09, 2018 at 10:18:51AM -0300, Mauro Carvalho Chehab wrote: > > There's a github URL there, but it is not prefixed by https. > > Add a prefi

Re: [PATCH 16/18] mtd: rawnand.h: use nested union kernel-doc markups

Em Wed, 9 May 2018 14:22:21 +0200 Boris Brezillon <boris.brezil...@bootlin.com> escreveu: > On Wed, 9 May 2018 09:10:34 -0300 > Mauro Carvalho Chehab <mchehab+sams...@kernel.org> wrote: > > > Hi Boris, > > > > Em Mon, 7 May 2018 08:32:32 -0300

[PATCH v2 01/11] docs: can.rst: fix a footnote reference

. In particular, it causes an error with LaTeX output, causing all books after networking to not be built. So, replace it by a valid syntax. Acked-by: Oliver Hartkopp <socket...@hartkopp.net> Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- Documentation/networking

[PATCH v2 08/11] docs: refcount-vs-atomic.rst: prefix url with https

There's a github URL there, but it is not prefixed by https. Add a prefix, to avoid false-positives with: ./scripts/documentation-file-ref-check As a side effect, Sphinx should also generate a cross-ref. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- Documen

[PATCH v2 03/11] docs: crypto_engine.rst: Fix two parse warnings

./Documentation/crypto/crypto_engine.rst:13: WARNING: Unexpected indentation. ./Documentation/crypto/crypto_engine.rst:15: WARNING: Block quote ends without a blank line; unexpected unindent. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- Documentation/

[PATCH v2 07/11] docs: ranoops.rst: fix location of ramoops.txt

The location of the dt bindings file is wrong: it was probably badly renamed by some script. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- Documentation/admin-guide/ramoops.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/admin

[PATCH v2 04/11] docs: dell_rbu.txt: fix location of request_firmware

ll_rbu.txt remains pointing to the old location. Fixes: 5d6d1ddd2730 ("firmware: move firmware loader into its own directory") Cc: Kees Cook <keesc...@chromium.org> Cc: Luis R. Rodriguez <mcg...@kernel.org> Cc: Greg Kroah-Hartman <gre...@linuxfoundation.org> Signed-off-b

[PATCH v2 05/11] docs: uio-howto.rst: use a code block to solve a warning

/devel/v4l/docs/Documentation/driver-api/uio-howto.rst:715: WARNING: Unexpected indentation. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- Documentation/driver-api/uio-howto.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Documentation/

[PATCH v2 06/11] scripts/documentation-file-ref-check: rewrite it in perl with auto-fix mode

they're moved to some other place and/or renamed to .rst. Add an experimental mode to auto-fix those. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- scripts/documentation-file-ref-check | 125 --- 1 file changed, 113 insertions(+), 12 deletions(-)

[PATCH v2 11/11] docs: fix broken references with multiple hints

The script: ./scripts/documentation-file-ref-check --fix-rst Gives multiple hints for broken references on some files. Manually use the one that applies for some files. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- Documentation/ABI/obsolete/sysf

[PATCH v2 10/11] arch/*: Kconfig: fix documentation for NMI watchdog

Changeset 9919cba7ff71 ("watchdog: Update documentation") updated the documentation, removing the old nmi_watchdog.txt and adding a file with a new content. Update Kconfig files accordingly. Fixes: 9919cba7ff71 ("watchdog: Update documentation") Signed-off-by: Mauro Carv

[PATCH v2 02/11] docs: admin-guide: add cgroup-v2 documentation

The cgroup-v2.txt is already in ReST format. So, move it to the admin-guide, where it belongs. Cc: Tejun Heo <t...@kernel.org> Cc: Li Zefan <lize...@huawei.com> Cc: Johannes Weiner <han...@cmpxchg.org> Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> ---

[PATCH v2 00/11] Fix some doc build warnings/errors and broken links

intend to apply them via my own tree. Regards, Mauro Mauro Carvalho Chehab (11): docs: can.rst: fix a footnote reference docs: admin-guide: add cgroup-v2 documentation docs: crypto_engine.rst: Fix two parse warnings docs: dell_rbu.txt: fix location of request_firmware docs: uio-howto.rst

[PATCH 3/3] media: v4l: fix broken video4linux docs locations

/video4linux/videobuf Documentation/video4linux/Zoran Make them point to the new location where available, removing otherwise. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- .../translations/zh_CN/video4linux/v4l2-framework.txt | 6 +++--- drivers/media/pci/bt8xx/K

Re: [PATCH 18/18] w1: w1_io.c: fix a kernel-doc warning

Em Tue, 08 May 2018 14:03:39 +0300 Evgeniy Polyakov <z...@ioremap.net> escreveu: > Hi > > 07.05.2018, 12:36, "Mauro Carvalho Chehab" <mchehab+sams...@kernel.org>: > > Add a blank line to avoid this Sphinx warning: > > ./drivers/w1/w1_io.c

Re: [PATCH 02/18] docs: fix location of request_firmware & friends

Em Tue, 8 May 2018 15:49:08 + "Luis R. Rodriguez" <mcg...@kernel.org> escreveu: > On Mon, May 07, 2018 at 06:35:38AM -0300, Mauro Carvalho Chehab wrote: > > commit 5d6d1ddd2730 ("firmware: move firmware loader into its own > > directory&quo

Re: [PATCH 16/18] mtd: rawnand.h: use nested union kernel-doc markups

Hi Boris, Em Mon, 7 May 2018 08:32:32 -0300 Mauro Carvalho Chehab <mchehab+sams...@kernel.org> escreveu: > Hi Boris, > > Em Mon, 7 May 2018 11:46:50 +0200 > Boris Brezillon <boris.brezil...@bootlin.com> escreveu: > > Is there a simple > > way we can

Re: [PATCH 09/18] net: mac80211.h: fix a bad comment line

Em Mon, 07 May 2018 14:38:26 +0200 Johannes Berg <johan...@sipsolutions.net> escreveu: > On Mon, 2018-05-07 at 15:37 +0300, Kalle Valo wrote: > > Mauro Carvalho Chehab <mchehab+sams...@kernel.org> writes: > > > > > Sphinx produces a lot of errors like th

Re: [PATCH 06/18] docs: core-api: add cgroup-v2 documentation

Em Tue, 8 May 2018 09:51:14 -0600 Jonathan Corbet <cor...@lwn.net> escreveu: > On Mon, 7 May 2018 06:35:42 -0300 > Mauro Carvalho Chehab <mchehab+sams...@kernel.org> wrote: > > > The cgroup-v2.txt is already in ReST format. So, move it to the > >

Re: [PATCH 15/18] iio: iio.h: use nested struct support on kernel-doc markup

Em Mon, 7 May 2018 18:08:03 +0100 Jonathan Cameron <ji...@kernel.org> escreveu: > On Mon, 7 May 2018 06:35:51 -0300 > Mauro Carvalho Chehab <mchehab+sams...@kernel.org> wrote: > > > Solve those Sphinx warnings: > > > > ./include/linux/iio/iio.h:270

Re: [PATCH 10/18] rcu: rcupdate.h: get rid of Sphinx warnings at rcu_pointer_handoff()

Em Mon, 7 May 2018 07:23:22 -0700 "Paul E. McKenney" <paul...@linux.vnet.ibm.com> escreveu: > On Mon, May 07, 2018 at 06:35:46AM -0300, Mauro Carvalho Chehab wrote: > > The code example at rcupdate.h currently produce lots of warnings: > > > > ./

Re: [PATCH 05/18] docs: core-api: add cachetlb documentation

Em Tue, 08 May 2018 17:40:56 +0300 Jani Nikula <jani.nik...@linux.intel.com> escreveu: > On Mon, 07 May 2018, Andrea Parri <andrea.pa...@amarulasolutions.com> wrote: > > On Mon, May 07, 2018 at 06:35:41AM -0300, Mauro Carvalho Chehab wrote: > >> The cachetlb.txt

Re: [PATCH 05/18] docs: core-api: add cachetlb documentation

Em Tue, 8 May 2018 15:05:07 -0300 Mauro Carvalho Chehab <mchehab+sams...@kernel.org> escreveu: > Em Tue, 08 May 2018 17:40:56 +0300 > Jani Nikula <jani.nik...@linux.intel.com> escreveu: > > > On Mon, 07 May 2018, Andrea Parri <andrea.pa...@amarulasolutions.com>

Re: [PATCH 16/18] mtd: rawnand.h: use nested union kernel-doc markups

r.foo2; union bar; }; Then it runs the normal un-nested struct parser. Thanks, Mauro [PATCH] don't describe nested struct timings IMHO, this is an ugly hack, but it allows having nested structs (or fields) undescribed by purpose. Signed-off-by: Mauro Carvalho Ch

[PATCH 04/18] docs: admin-guide: add bcache documentation

The bcache.txt is already in ReST format. So, move it to the admin guide, where it belongs. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- Documentation/00-INDEX | 2 -- Documentation/{bcache.txt => admin-guide/bcache.rst} | 0 Docu

[PATCH 06/18] docs: core-api: add cgroup-v2 documentation

The cgroup-v2.txt is already in ReST format. So, move it to the core-api guide, where it belongs. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- Documentation/00-INDEX | 2 -- Documentation/{cgroup-v2.txt => admin-guide/cgro

[PATCH 08/18] docs: driver-api: add clk documentation

The clk.rst is already in ReST format. So, move it to the driver-api guide, where it belongs. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- Documentation/00-INDEX | 2 -- Documentation/admin-guide/kernel-parameters.txt | 2 +- Documen

[PATCH 12/18] time: timer.c: adjust a kernel-doc comment

line; unexpected unindent. While here, align the lines at the block. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- kernel/time/timer.c | 14 +++--- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/kernel/time/timer.c b/kernel/time/timer.c

[PATCH 03/18] docs: */index.rst: Add newer documents to their respective index.rst

A number of new docs were added, but they're currently not on the index.rst from the session they're supposed to be, causing Sphinx warnings. Add them. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- Documentation/crypto/index.rst | 1 + Documentation/driv

[PATCH 05/18] docs: core-api: add cachetlb documentation

The cachetlb.txt is already in ReST format. So, move it to the core-api guide, where it belongs. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- Documentation/00-INDEX| 2 -- Documentation/{cachetlb.txt => core-api/cachetlb

[PATCH 02/18] docs: fix location of request_firmware & friends

tman <gre...@linuxfoundation.org> Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- Documentation/dell_rbu.txt | 4 ++-- .../driver-api/firmware/fallback-mechanisms.rst | 2 +- .../driver-api/firmware/request_firmware.rst| 17

[PATCH 14/18] fbdev: modedb.c: fix a kernel-doc markup

/video/fbdev/core/modedb.c:647: WARNING: Inline strong start-string without end-string. ./drivers/video/fbdev/core/modedb.c:647: WARNING: Inline strong start-string without end-string. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- drivers/video/fbdev/core/mo

[PATCH 01/18] docs: can.rst: fix a footnote reference

. In particular, it causes an error with LaTeX output, causing all books after networking to not be built. So, replace it by a valid syntax. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- Documentation/networking/can.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 del

[PATCH 17/18] docs: uio-howto.rst: use a code block to solve a warning

/devel/v4l/docs/Documentation/driver-api/uio-howto.rst:715: WARNING: Unexpected indentation. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- Documentation/driver-api/uio-howto.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Documentation/

[PATCH 07/18] docs: core-api: add circular-buffers documentation

The circular-buffers.txt is already in ReST format. So, move it to the core-api guide, where it belongs. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- Documentation/00-INDEX | 2 -- .../{circular-buffers.txt => core-api

[PATCH 16/18] mtd: rawnand.h: use nested union kernel-doc markups

in 'nand_chip' ./include/linux/mtd/rawnand.h:848: WARNING: Unexpected indentation. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- include/linux/mtd/rawnand.h | 26 ++ 1 file changed, 18 insertions(+), 8 deletions(-) diff --git a/include/lin

[PATCH 11/18] docs: crypto_engine.rst: Fix two parse warnings

./Documentation/crypto/crypto_engine.rst:13: WARNING: Unexpected indentation. ./Documentation/crypto/crypto_engine.rst:15: WARNING: Block quote ends without a blank line; unexpected unindent. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- Documentation/

[PATCH 18/18] w1: w1_io.c: fix a kernel-doc warning

Add a blank line to avoid this Sphinx warning: ./drivers/w1/w1_io.c:197: WARNING: Definition list ends without a blank line; unexpected unindent. Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- drivers/w1/w1_io.c | 1 + 1 file changed, 1 insertion(+) diff

[PATCH 09/18] net: mac80211.h: fix a bad comment line

Sphinx produces a lot of errors like this: ./include/net/mac80211.h:2083: warning: bad line: > Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- include/net/mac80211.h | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/include/net/mac

[PATCH 13/18] wait: wait.h: Get rid of a kernel-doc/Sphinx warnings

quote ends without a blank line; unexpected unindent. This is easily done by using "::" instead of just ":". Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- include/linux/wait.h | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --gi

[PATCH 00/18] Fix some build warnings/errors with Sphinx

the tree, and moved a few text documents to a book. I with I had more time to move the other ones and to solve other warnings. Mauro Carvalho Chehab (18): docs: can.rst: fix a footnote reference docs: fix location of request_firmware & friends docs: */index.rst: Add newer docum

[PATCH 10/18] rcu: rcupdate.h: get rid of Sphinx warnings at rcu_pointer_handoff()

line; unexpected unindent. ./include/linux/rcupdate.h:582: WARNING: Block quote ends without a blank line; unexpected unindent. ./include/linux/rcupdate.h:582: WARNING: Inline literal start-string without end-string. Change it to a code-block. Signed-off-by: Mauro Carvalho Chehab

Re: [PATCH] MAINTAINERS & files: Canonize the e-mails I use at files

Em Fri, 04 May 2018 13:58:39 +0300 Jani Nikula <jani.nik...@linux.intel.com> escreveu: > On Fri, 04 May 2018, Mauro Carvalho Chehab <mchehab+sams...@kernel.org> wrote: > > From now on, I'll start using my @kernel.org as my development e-mail. > > > > As such, le

[PATCH] MAINTAINERS & files: Canonize the e-mails I use at files

off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> Signed-off-by: Brian Warner <brian.war...@samsung.com> Signed-off-by: Mauro Carvalho Chehab <mchehab+sams...@kernel.org> --- Documentation/doc-guide/parse-headers.rst | 4 ++-- Documentation/media/uapi/rc/key

[PATCH] docs: kernel-doc: fix parsing of arrays

The logic with parses array has a bug that prevents it to parse arrays like: struct { ... struct { u64 msdu[IEEE80211_NUM_TIDS + 1]; ... ... Fix the parser to accept it. Signed-off-by: Mauro Carvalho Chehab

Re: nested structs parsing

Em Thu, 29 Mar 2018 16:26:33 +0200 Johannes Berg escreveu: > Hi, > > > The original patchset for nested structs was supporting it only > > when not inlined. This should be fixed on this patchset: > > > > https://lkml.org/lkml/2018/2/19/387 > > > > Do you have

Re: nested structs parsing

Em Thu, 29 Mar 2018 11:47:07 +0200 Johannes Berg escreveu: > On Thu, 2018-03-29 at 11:46 +0200, Johannes Berg wrote: > > Hi, > > > > For a while I haven't looked at my documentation for 802.11, and now I > > noticed I'm getting warnings due to the nested parsing. > >

[PATCH v2 2/2] COPYING: use the new text with points to the license files

by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- COPYING | 358 ++-- COPYING.new | 18 --- 2 files changed, 10 insertions(+), 366 deletions(-) delete mode 100644 COPYING.new diff --git a/COPYING b/COPYING index ca442d313d8

[PATCH v2 0/2] COPYING: create a new file with points to the Kernel license files

easier to read, I broke it into two patches. Feel free to merge both when merging if you want. Mauro Carvalho Chehab (2): COPYING: create a new file with points to the Kernel license files COPYING: use the new text with points to the license files COPYING

[PATCH v2 1/2] COPYING: create a new file with points to the Kernel license files

changes. Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- Version 2: - Did some text changes at license-rules.rst, based on Matthew Wilcox review. COPYING.new | 18 ++ Documentation/process/license-rules.rs

Re: [PATCH 1/2] COPYING: create a new file with points to the Kernel license files

Em Thu, 22 Mar 2018 05:13:55 -0700 Matthew Wilcox <wi...@infradead.org> escreveu: > On Thu, Mar 22, 2018 at 06:54:13AM -0300, Mauro Carvalho Chehab wrote: > > +++ b/Documentation/process/license-rules.rst > > @@ -4,15 +4,17 @@ Linux k

[PATCH 2/2] COPYING: use the new text with points to the license files

Now that we have a new COPYING file with points to the Linux license files, replace it with the old content. This patch does: 1 file changed, 0 insertions(+), 0 deletions(-) rename COPYING.new => COPYING (100%) Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> ---

[PATCH 0/2] COPYING: create a new file with points to the Kernel license files

easier to read, I broke it into two patches. Feel free to merge both when merging if you want. Mauro Carvalho Chehab (2): COPYING: create a new file with points to the Kernel license files COPYING: use the new text with points to the license files COPYING

[PATCH 1/2] COPYING: create a new file with points to the Kernel license files

changes. Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- COPYING.new | 18 ++ Documentation/process/license-rules.rst | 20 +++- 2 files changed, 29 insertions(+), 9 deletions(-) create mode 100644 COPYING.new diff

Re: [PATCH] w1: fix w1_ds2438 documentation

Em Fri, 2 Mar 2018 08:55:24 +0100 Mariusz Bialonczyk escreveu: > Signed-off-by: Mariusz Bialonczyk > --- > Documentation/w1/slaves/w1_ds2438 | 2 +- > 1 file changed, 1 insertion(+), 1 deletion(-) > > diff --git a/Documentation/w1/slaves/w1_ds2438 >

Re: [PATCH 4/6] scripts: kernel-doc: support in-line comments on nested structs/unions

Em Fri, 16 Feb 2018 15:52:33 +0100 Markus Heiser <markus.hei...@darmarit.de> escreveu: > > Am 16.02.2018 um 14:48 schrieb Mauro Carvalho Chehab > > <mche...@s-opensource.com>: > > > > The parser at kernel-doc rejects names with dots in the middle. > >

Re: [PATCH v4 16/18] scripts: kernel-doc: improve nested logic to handle multiple identifiers

Em Wed, 14 Feb 2018 20:20:21 +0200 Jani Nikula <jani.nik...@linux.intel.com> escreveu: > On Wed, 14 Feb 2018, Mauro Carvalho Chehab <mche...@s-opensource.com> wrote: > > There is a simple fix, though. Make inline comments to accept a dot: > > > > diff --git a/sc

[PATCH 6/6] drm: intel_dpio_phy: fix kernel-doc comments at nested struct

intel.com> Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- drivers/gpu/drm/i915/intel_dpio_phy.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/drivers/gpu/drm/i915/intel_dpio_phy.c b/drivers/gpu/drm/i915/intel_dpio_phy.c index 76473e9836c6..c

[PATCH 4/6] scripts: kernel-doc: support in-line comments on nested structs/unions

The parser at kernel-doc rejects names with dots in the middle. Fix it, in order to support nested structs/unions. Tested-by: Jani Nikula <jani.nik...@intel.com> Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- scripts/kernel-doc | 2 +- 1 file changed, 1 ins

[PATCH 5/6] doc-guide: kernel-doc: add examples about nested union/structs

It helps to give some examples about how to use in-line comments also when nested union/structs are present. So add it. Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- Documentation/doc-guide/kernel-doc.rst | 13 +++-- 1 file changed, 11 insertions(+), 2 del

[PATCH 3/6] doc-guide: kernel-doc: move in-line section to be after nested struct

We want to give some examples about how to do in-line comments for nested structs. So, move it to be after nested structs/unions chapter. The section content was not changed on this patch. Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- Documentation/doc-guide/kernel-d

[PATCH 2/6] doc-guide: kernel-doc: fix example for inlined comments

Without ending with a ";", kernel-doc doesn't recognize it as an struct, and it fails to parse the example. Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- Documentation/doc-guide/kernel-doc.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git

[PATCH 1/6] doc-guide: kernel-doc: fix example for nested_foobar struct

in 'nested_foobar' example:33: warning: Function parameter or member 'bar.st2' not described in 'nested_foobar' So, make the example more complete and add the missing end of comment there. Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- Documentation/doc-guide/kernel-d

[PATCH 0/6] Add support for in-line nested struct comments

This series fix two bugs at kernel-doc.rst examples and add support for in-line nested struct comments. It also converts one documentation at intel_dpio_phy to use it, in order to give a practical example about how to use it. Mauro Carvalho Chehab (6): doc-guide: kernel-doc: fix example

Re: [PATCH v4 16/18] scripts: kernel-doc: improve nested logic to handle multiple identifiers

Em Wed, 14 Feb 2018 18:07:03 +0200 Jani Nikula <jani.nik...@linux.intel.com> escreveu: > On Mon, 18 Dec 2017, Mauro Carvalho Chehab <mche...@s-opensource.com> wrote: > > It is possible to use nested structs like: > > > > struct { > > struct { > &g

[PATCH] media: cxusb, dib0700: ignore XC2028_I2C_FLUSH

Mauro Carvalho Chehab <mche...@osg.samsung.com> --- drivers/media/usb/dvb-usb/cxusb.c | 2 ++ drivers/media/usb/dvb-usb/dib0700_devices.c | 1 + 2 files changed, 3 insertions(+) diff --git a/drivers/media/usb/dvb-usb/cxusb.c b/drivers/media/usb/dvb-usb/cxusb.c index 37dea0adc695..

Re: [PATCH] Documentation: Fix misconversion of #if

Signed-off-by: Matthew Wilcox <mawil...@microsoft.com> Reviewed-by: Mauro Carvalho Chehab <mche...@s-opensource.com> > --- > Documentation/kernel-hacking/hacking.rst | 4 ++-- > 1 file changed, 2 insertions(+), 2 deletions(-) > > diff --git a/Documentation/ker

Re: [PATCH 02/11] media: videobuf2: Add new uAPI for DVB streaming I/O

Em Mon, 8 Jan 2018 15:26:50 +0100 Hans Verkuil escreveu: > A quick follow-up: > > On 01/08/2018 02:54 PM, Hans Verkuil wrote: > >> +/* > >> + * Videobuf operations > >> + */ > >> +int dvb_vb2_init(struct dvb_vb2_ctx *ctx, const char *name, int > >> nonblocking) > >> +{ > >>

Re: [PATCH 02/11] media: videobuf2: Add new uAPI for DVB streaming I/O

ut the '[PATCH v3] media: videobuf2-core: don't go > out > of the buffer range' patch). > > On 12/21/2017 05:18 PM, Mauro Carvalho Chehab wrote: > > From: Satendra Singh Thakur <satendr...@samsung.com> > > > > Adds a new uAPI for DVB to use streaming I/O which i

Re: [PATCH v3 1/1] runchecks: Generalize make C={1,2} to support multiple checkers

Em Fri, 05 Jan 2018 20:41:41 +0100 Knut Omang <knut.om...@oracle.com> escreveu: > On Fri, 2018-01-05 at 16:08 -0200, Mauro Carvalho Chehab wrote: > > Em Thu, 04 Jan 2018 21:15:31 +0100 > > Knut Omang <knut.om...@oracle.com> escreveu: > > > &g

Re: [PATCH v3 1/1] runchecks: Generalize make C={1,2} to support multiple checkers

Em Thu, 04 Jan 2018 21:15:31 +0100 Knut Omang escreveu: > > I'm surprised the commit message and the provided documentation say > > nothing about using CHECK=foo on the command line. That already supports > > arbitrary checkers. > > The problem, highlighted by Jim

Re: scripts/kernel-doc: no warning or error on lots of missing function parameters

: it doesn't cover the cases where OUTPUT_INTERNAL and OUTPUT_EXPORTED are used. As the most common case is OUTPUT_ALL, place it first, in order to optimize a litte bit the check logic. Fixes: 2defb2729217 ("scripts: kernel-doc: apply filtering rules to warnings") Reported-by: Randy Du

Re: scripts/kernel-doc: no warning or error on lots of missing function parameters

Em Fri, 29 Dec 2017 20:12:15 -0800 Randy Dunlap <rdun...@infradead.org> escreveu: > On 12/29/2017 06:28 PM, Mauro Carvalho Chehab wrote: > > Em Fri, 29 Dec 2017 18:17:08 -0800 > > Randy Dunlap <rdun...@infradead.org> escreveu: > > > >> In linux-next-

Re: scripts/kernel-doc: no warning or error on lots of missing function parameters

Em Fri, 29 Dec 2017 18:17:08 -0800 Randy Dunlap escreveu: > In linux-next-20171222, this message: > > print STDERR "${file}:$.: warning:" . > " No description found for parameter '$param'\n"; > > has roughly/approximately been replaced with: > >

Re: [PATCH 05/11] media: dvb_vb2: fix a warning about streamoff logic

Em Thu, 21 Dec 2017 14:18:04 -0200 Mauro Carvalho Chehab <mche...@s-opensource.com> escreveu: > The streamoff logic is causing those warnings: > > WARNING: CPU: 3 PID: 3382 at drivers/media/v4l2-core/videobuf2-core.c:1652 > __vb2_queue_cancel+0x177/0x250 [videobuf2_core]

Re: [PATCH v4 00/18] kernel-doc: add supported to document nested structs

Em Thu, 21 Dec 2017 14:08:43 -0700 Jonathan Corbet <cor...@lwn.net> escreveu: > On Mon, 18 Dec 2017 10:30:01 -0200 > Mauro Carvalho Chehab <mche...@s-opensource.com> wrote: > > > This is a rebased version of my patch series that add support for > > nested structs

[PATCH 09/11] media: dvb-core: get rid of mmap reserved field

The "reserved" field was a way, used at V4L2 API, to add new data to existing structs without breaking userspace. However, there are now clever ways of doing that, without needing to add an uneeded overhead. So, get rid of them. Signed-off-by: Mauro Carvalho Chehab <mche...@s-o

[PATCH 07/11] media: dvb uAPI docs: document demux mmap/munmap syscalls

With the new dmx mmap interface, those two syscalls are now handled by the subsystem. Document them. This patch is based on the V4L2 text for those ioctls. Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- Documentation/media/uapi/dvb/dmx-mmap.rst

[PATCH 02/11] media: videobuf2: Add new uAPI for DVB streaming I/O

Geunyoung Kim <nenggun@samsung.com> Acked-by: Seung-Woo Kim <sw0312@samsung.com> Acked-by: Inki Dae <inki@samsung.com> Signed-off-by: Satendra Singh Thakur <satendr...@samsung.com> Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- drive

[PATCH 06/11] media: move videobuf2 to drivers/media/common

Now that VB2 is used by both V4L2 and DVB core, move it to the common part of the subsystem. Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- drivers/media/common/Kconfig | 1 + drivers/media/common/Makefile | 2 +- drivers

[PATCH 10/11] fs: compat_ioctl: add new DVB demux ioctls

Use trivial handling for the new DVB demux ioctls, as none of them passes a pointer inside their structures. Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- fs/compat_ioctl.c | 5 + 1 file changed, 5 insertions(+) diff --git a/fs/compat_ioctl.c b/fs/compat_ioctl.c

[PATCH 05/11] media: dvb_vb2: fix a warning about streamoff logic

should be called when changing the buffer state; 2) The logic with marks the buffers as done is at the wrong place. Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- drivers/media/dvb-core/dvb_vb2.c | 33 - 1 file changed, 20 insertions(+),

[PATCH 04/11] media: vb2-core: add a new warning about pending buffers

with debug instrumentation inside the drivers can make easier to identify where the problem is. Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- drivers/media/v4l2-core/videobuf2-core.c | 5 - 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/drivers/media/v4l

[PATCH 03/11] media: vb2-core: add pr_fmt() macro

Simplify the pr_foo() macros by adding a pr_fmt() macro. Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- drivers/media/v4l2-core/videobuf2-core.c | 30 -- 1 file changed, 16 insertions(+), 14 deletions(-) diff --git a/drivers/media/v4l

[PATCH 08/11] media: dvb uAPI docs: document mmap-related ioctls

5 new ioctls were added to the DVB demux API, in order to handle memory maped I/O. Add documentation for them. Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- Documentation/media/uapi/dvb/dmx-expbuf.rst | 90 +++ Documentation/media/uapi/d

[PATCH 11/11] media: dvb_vb2: add SPDX headers

This code is released under GPL. Add the corresponding SPDX headers. Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- drivers/media/dvb-core/dvb_vb2.c | 1 + drivers/media/dvb-core/dvb_vb2.h | 2 ++ 2 files changed, 3 insertions(+) diff --git a/drivers/media/dvb-core/d

[PATCH 01/11] media: vb2-core: Fix a bug about unnecessary calls to queue cancel and free

d-off-by: Satendra Singh Thakur <satendr...@samsung.com> Signed-off-by: Mauro Carvalho Chehab <mche...@s-opensource.com> --- drivers/media/v4l2-core/videobuf2-core.c | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/drivers/media/v4l2-core/videobuf2-core.c b/drivers/me

Re: [PATCH 2/8] media: v4l2-ioctl.h: convert debug into an enum of bits

Em Wed, 20 Dec 2017 12:47:23 +0200 Laurent Pinchart <laurent.pinch...@ideasonboard.com> escreveu: > Hi Mauro, > > On Tuesday, 19 December 2017 17:34:46 EET Mauro Carvalho Chehab wrote: > > Em Tue, 19 Dec 2017 16:05:46 +0200 Laurent Pinchart escreveu: > > > On Tues

Re: [PATCH 2/8] media: v4l2-ioctl.h: convert debug into an enum of bits

Em Tue, 19 Dec 2017 19:17:12 +0200 Laurent Pinchart <laurent.pinch...@ideasonboard.com> escreveu: > Hi Mauro, > > On Tuesday, 19 December 2017 17:37:58 EET Mauro Carvalho Chehab wrote: > > Em Tue, 19 Dec 2017 16:12:35 +0200 Sakari Ailus escreveu: > > > On Tue, De

  1   2   3   4   5   6   7   8   9   10   >