Re: [PATCH v2] kernel-doc: parse DECLARE_KFIFO and DECLARE_KFIFO_PTR()

FYI: added similar patch to the linuxdoc sphinx-extension https://github.com/return42/linuxdoc/commit/726af7a Thanks! -- Markus -- > Am 08.12.2017 um 15:05 schrieb Mauro Carvalho Chehab > : > > On media, we now have an struct declared with: > > struct lirc_fh { >

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

> Am 07.10.2017 um 18:34 schrieb Jonathan Corbet : > > On Wed, 4 Oct 2017 08:48:38 -0300 > Mauro Carvalho Chehab wrote: > >> Right now, it is not possible to document nested struct and nested unions. >> kernel-doc simply ignore them. >> >> Add

Re: [PATCH v2 09/13] scripts: kernel-doc: parse next structs/unions

> Am 29.09.2017 um 17:29 schrieb Mauro Carvalho Chehab > <mche...@s-opensource.com>: > > Em Thu, 28 Sep 2017 18:28:32 +0200 > Markus Heiser <markus.hei...@darmarit.de> escreveu: > >> Hi Mauro, >> >>> Am 27.09.2017 um 23:10 schrieb M

Re: [PATCH v2 09/13] scripts: kernel-doc: parse next structs/unions

> Am 29.09.2017 um 15:33 schrieb Mauro Carvalho Chehab > : >> Sorry if I was unclear. I mean we should not use tabs in reST or in py. > > Ah, OK. > >> In python the indentation is a part of the language syntax, same in >> reST; the indentation is the markup. It's not

Re: [PATCH v2 09/13] scripts: kernel-doc: parse next structs/unions

> Am 29.09.2017 um 14:08 schrieb Mauro Carvalho Chehab > <mche...@s-opensource.com>: > > Em Thu, 28 Sep 2017 18:28:32 +0200 > Markus Heiser <markus.hei...@darmarit.de> escreveu: > >> Hi Mauro, >> >>> Am 27.09.2017 um 23:10 schrieb M

Re: [PATCH v2 12/13] scripts: kernel-doc: handle nested struct function arguments

Hi Mauro, this 'else' addition seems a bit spooky to me. As I commented in patch 09/13 may it helps when you look at https://github.com/return42/linuxdoc/blob/master/linuxdoc/kernel_doc.py#L2499 which is IMO a bit more clear. -- Markus -- > Am 27.09.2017 um 23:10 schrieb Mauro Carvalho

Re: [PATCH v2 09/13] scripts: kernel-doc: parse next structs/unions

Hi Mauro, > Am 27.09.2017 um 23:10 schrieb Mauro Carvalho Chehab > : > > > > diff --git a/Documentation/doc-guide/kernel-doc.rst > b/Documentation/doc-guide/kernel-doc.rst > index 96012f9e314d..9e63a18cceea 100644 > --- a/Documentation/doc-guide/kernel-doc.rst > +++

Re: [PATCH] scripts: kernel-doc: parse next structs/unions

> Am 25.09.2017 um 20:22 schrieb Mauro Carvalho Chehab > : > > Jon, > > Please let me know what you think about this approach. IMHO, it is a way > better than what we do right now. This is more a proof of concept, as the > patch is not complete. > > With it, we can

Re: [PATCH v2] scripts: kernel-doc: fix nexted handling

> Am 25.09.2017 um 20:41 schrieb Mauro Carvalho Chehab > : >>> + $cont = 1; >>> + }; >>> + }; >>> + # Ignore other nested elements, like enums >>> + $members =~ s/({[^\{\}]*})//g; >>> + $nested = $decl_type; >> >> What is the

Re: [PATCH v2] scripts: kernel-doc: fix nexted handling

> Am 24.09.2017 um 19:38 schrieb Mauro Carvalho Chehab > <mche...@s-opensource.com>: > > Em Sun, 24 Sep 2017 17:13:13 +0200 > Markus Heiser <markus.hei...@darmarit.de> escreveu: > >>> Am 24.09.2017 um 12:23 schrieb Mauro Carvalho Che >>> &g

Re: [PATCH v2] scripts: kernel-doc: fix nexted handling

> Am 24.09.2017 um 12:23 schrieb Mauro Carvalho Che > > v2: handle embedded structs/unions from inner to outer > > When we have multiple levels of embedded structs, > > we need a smarter rule that will be removing nested structs > from the inner to the outer ones. So, changed the parsing rule

Re: [PATCH] scripts: kernel-doc: fix nexted handling

# ignore members marked private: Hi Mauro, I tested this patch. Feel free to add my Tested-by: Markus Heiser <markus.hei...@darmarit.de> FYI: I also migrated the patch to my python kernel-doc parser: https://github.com/return42/linuxdoc/commit/5dbb93f And here is the impact o

Re: [PATCH 02/22] docs-rst: convert usb docbooks to ReST

Am 30.03.2017 um 13:17 schrieb Markus Heiser <markus.hei...@darmarit.de>: > > If it helps ... dbxml2rst also supports single file conversion ... I updated: > > > https://github.com/return42/sphkerneldoc/tree/master/Documentation/books_migrated > > There you fin

Re: [PATCH 02/22] docs-rst: convert usb docbooks to ReST

Am 30.03.2017 um 12:12 schrieb Mauro Carvalho Chehab : >>> At this point I'd just go with what Mauro has. It's here now, as >>> patches. We've seen from the GPU documentation that polishing the >>> one-time initial conversion is, after a point, wasted effort. Having the

Re: [PATCH 02/22] docs-rst: convert usb docbooks to ReST

Am 30.03.2017 um 10:21 schrieb Jani Nikula <jani.nik...@intel.com>: > On Thu, 30 Mar 2017, Markus Heiser <markus.hei...@darmarit.de> wrote: >> Hi Mauro, >> >> Am 29.03.2017 um 20:54 schrieb Mauro Carvalho Chehab >> <mche...@s-opensource.com>:

Re: [PATCH 02/22] docs-rst: convert usb docbooks to ReST

Hi Mauro, Am 29.03.2017 um 20:54 schrieb Mauro Carvalho Chehab : > As we're moving out of DocBook, let's convert the remaining > USB docbooks to ReST. > > The transformation itself on this patch is a no-brainer > conversion using pandoc. right, its a no-brainer ;-)

[PATCH] doc-rst: fixed cleandoc target when used with O=dir

'cleandocs' failed Signed-off-by: Markus Heiser <markus.hei...@darmarit.de> --- Documentation/Makefile.sphinx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/Makefile.sphinx b/Documentation/Makefile.sphinx index e14d82a..be1936e 100644 --- a/Documentation/Makef

Re: [Ksummit-discuss] Including images on Sphinx documents

Am 11.11.2016 um 12:22 schrieb Jani Nikula <jani.nik...@linux.intel.com>: > On Thu, 10 Nov 2016, Jani Nikula <jani.nik...@linux.intel.com> wrote: >> On Thu, 10 Nov 2016, Markus Heiser <markus.hei...@darmarit.de> wrote: >>> Could this POC persuade you, if so, I

Re: [Ksummit-discuss] Including images on Sphinx documents

On 09.11.2016 12:58, Jani Nikula wrote: > On Wed, 09 Nov 2016, Markus Heiser <markus.hei...@darmarit.de> wrote: >> Am 09.11.2016 um 12:16 schrieb Jani Nikula <jani.nik...@linux.intel.com>: >>>> So I vote for : >>>> >>>>>

Re: [Ksummit-discuss] Including images on Sphinx documents

Am 09.11.2016 um 12:16 schrieb Jani Nikula : >> So I vote for : >> >>> 1) copy (or symlink) all rst files to Documentation/output (or to the >>> build dir specified via O= directive) and generate the *.pdf there, >>> and produce those converted images via Makefile.;

Re: [Ksummit-discuss] Including images on Sphinx documents

Am 07.11.2016 um 18:01 schrieb Josh Triplett : > On Mon, Nov 07, 2016 at 07:55:24AM -0200, Mauro Carvalho Chehab wrote: >> 2) add an Sphinx extension that would internally call ImageMagick and/or >> inkscape to convert the bitmap; > > This seems sensible; Sphinx should

Re: [PATCH 1/3] doc-rst: generic way to build PDF of sub-folders

Am 02.11.2016 um 12:43 schrieb Jani Nikula <jani.nik...@intel.com>: > On Wed, 24 Aug 2016, Markus Heiser <markus.hei...@darmarit.de> wrote: >> From: Markus Heiser <markus.hei...@darmarit.de> >> >> This extends the method to build only sub-folders to

Re: Documentation/media/uapi/cec/ sporadically unnecessarily rebuilding

On 27.10.2016 16:52, Jani Nikula wrote: On Thu, 27 Oct 2016, Markus Heiser <markus.hei...@darmarit.de> wrote: Hi Jani, Am 24.10.2016 um 11:04 schrieb Jani Nikula <jani.nik...@intel.com>: I think I saw some of this in the past [1], but then couldn't reproduce it after all. No

Re: Documentation/media/uapi/cec/ sporadically unnecessarily rebuilding

Hi Jani, Am 24.10.2016 um 11:04 schrieb Jani Nikula : > I think I saw some of this in the past [1], but then couldn't reproduce > it after all. Now I'm seeing it again. Sporadically > Documentation/media/uapi/cec/ gets rebuilt on successive runs of make > htmldocs, even

Re: [PATCH 0/4] reST-directive kernel-cmd / include contentent from scripts

Am 22.10.2016 um 17:04 schrieb Jonathan Corbet : > On Sat, 22 Oct 2016 08:56:29 -0200 > Mauro Carvalho Chehab wrote: > >> The security implications will be the same if either coded as an >> "ioctl()" or as "syscall", the scripts should be audited.

[PATCH] kernel-cmd and tabs

://www.mail-archive.com/linux-doc@vger.kernel.org/msg06828.html Markus Heiser (1): doc-rst: reST-directive kernel-cmd parse with tabs Documentation/sphinx/kernel_cmd.py | 17 + 1 file changed, 13 insertions(+), 4 deletions(-) -- 2.7.4 -- To unsubscribe from this list: send

[PATCH] doc-rst: reST-directive kernel-cmd parse with tabs

Add a 'tab-width' option to the kernel-cmd, and convert whitespace (tabs) well. The default 'tab-width' is 8. This is also a bugfix, since without this patch, tabs in command's output are not handled. Signed-off-by: Markus Heiser <markus.hei...@darmarit.de> --- Documentation/

DVB-T2 with H.265 (HEVC) ?

Hi, does anyone know (or has experiences) about a DVB-T2 device with H.265? -- Markus -- -- To unsubscribe from this list: send the line "unsubscribe linux-media" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [PATCH 1/4] doc-rst: reST-directive kernel-cmd / include contentent from scripts

Am 18.10.2016 um 12:06 schrieb Mauro Carvalho Chehab <mche...@infradead.org>: > Sorry, I missed part of your comments on my last reply... > > > Em Tue, 18 Oct 2016 09:03:28 +0200 > Markus Heiser <markus.hei...@darmarit.de> escreveu: > >> +-

Re: [PATCH 1/4] doc-rst: reST-directive kernel-cmd / include contentent from scripts

Am 17.10.2016 um 18:46 schrieb Mauro Carvalho Chehab <mche...@infradead.org>: > Hi Markus, > > Em Thu, 6 Oct 2016 09:20:17 +0200 > Markus Heiser <markus.hei...@darmarit.de> escreveu: > >> From: Markus Heiser <markus.hei...@darmarit.de> >> >>

Re: [PATCH 1/4] doc-rst: reST-directive kernel-cmd / include contentent from scripts

Am 18.10.2016 um 08:07 schrieb Jani Nikula : > If you're going to insist on getting kernel-cmd upstream (and I haven't > changed my opinion on that) please at least have the sense to have just > *one* perl script to parse MAINTAINERS, not many. The one script should > be

[PATCH 0/2] v4l-utils: fixed dvbv5 vdr format

format output for DVB-T(2) Markus Heiser (1): v4l-utils: fixed dvbv5 vdr format lib/libdvbv5/dvb-vdr-format.c | 56 +-- 1 file changed, 38 insertions(+), 18 deletions(-) -- 2.7.4 -- To unsubscribe from this list: send the line "unsubscribe

[PATCH 1/2] v4l-utils: fixed dvbv5 vdr format

From: Markus Heiser <markus.hei...@darmarit.de> From: Heiser, Markus <markus.hei...@darmarit.de> The vdr format was broken, I got '(null)' entries HD:11494:S1HC23I0M5N1O35:S:(null):22000:5101:5102,5103,5106,5108:0:0:10301:0:0:0: 0-:1:2--:3:4-: refering to t

Re: [PATCH 0/4] reST-directive kernel-cmd / include contentent from scripts

Am 11.10.2016 um 18:45 schrieb Mauro Carvalho Chehab : > If we allow such scripts (and we do since day zero, due to > kernel-doc), then there are 3 options: > > 1) use a single python script to run the scripts needed in the > build process (e. g. merging kernel-cmd

Re: [PATCH 0/4] reST-directive kernel-cmd / include contentent from scripts

Am 11.10.2016 um 17:34 schrieb Jani Nikula <jani.nik...@intel.com>: > On Tue, 11 Oct 2016, Mauro Carvalho Chehab <mche...@infradead.org> wrote: >> Em Tue, 11 Oct 2016 09:26:48 +0200 >> Markus Heiser <markus.hei...@darmarit.de> escreveu: >> >>

Re: [PATCH 0/4] reST-directive kernel-cmd / include contentent from scripts

Am 07.10.2016 um 07:56 schrieb Jani Nikula : > On Thu, 06 Oct 2016, Mauro Carvalho Chehab wrote: >> Em Thu, 06 Oct 2016 17:21:36 +0300 >> Jani Nikula escreveu: >>> We've seen what happens when we make it easy to add random

[PATCH 3/4] doc-rst: migrated media build kernel-cmd directive

From: Markus Heiser <markus.hei...@darmarit.de> From: Markus Heiser <markus.hei...@darmarit.de> Remove the media-Makefile and migrate the ``.. kernel-include::`` directive to the new ``.. kernel-cmd::`` directive. To avoid breaking bisect, this patch includes the requ

[PATCH 2/4] doc-rst: customize RTD theme; literal-block

From: Markus Heiser <markus.hei...@darmarit.de> From: Markus Heiser <markus.hei...@darmarit.de> Format the literal-block like other code-block elements, with 12px and a line-high of 1.5. Signed-off-by: Markus Heiser <markus.hei...@darmarit.de> --- Documenta

[PATCH 1/4] doc-rst: reST-directive kernel-cmd / include contentent from scripts

From: Markus Heiser <markus.hei...@darmarit.de> From: Markus Heiser <markus.hei...@darmarit.de> The ``kernel-cmd`` directive includes contend from the stdout of a command-line. With the ``kernel-cmd`` directive we can include the output of any (Perl or whatever) script. This is a

[PATCH 4/4] doc-rst: remove the kernel-include directive

From: Markus Heiser <markus.hei...@darmarit.de> From: Markus Heiser <markus.hei...@darmarit.de> The kernel-include directive is no longer needed, so lets remove this out-of-favor solution. BTW: fixed a C typo in the Documentation/Makefile Signed-off-by: Markus Heiser <markus.hei

[PATCH 0/4] reST-directive kernel-cmd / include contentent from scripts

From: Markus Heiser <markus.hei...@darmarit.de> Hi Jon, Mauro, and Jani, with this series a reST-directive kernel-cmd is introduced. The kernel-cmd directive includes contend from the stdout of a command-line (@mchehab asked for). Including content from a command's stdout is a more g

Re: kernel-doc-rst-lint (was: Re: [PATCH 00/15] improve function-level documentation)

Am 05.10.2016 um 16:04 schrieb Jani Nikula : > On Wed, 05 Oct 2016, Daniel Vetter wrote: >> Jani Nikula has a patch with a scrip to make the one kernel-doc parser >> into a lint/checker pass over the entire kernel. I think that'd would >> be more

Re: [PATCH 06/11] dma-buf: Introduce fence_get_rcu_safe()

Am 23.09.2016 um 14:59 schrieb Daniel Vetter : >> >> /** >> - * fence_put - decreases refcount of the fence >> - * @fence: [in]fence to reduce refcount of >> + * fence_get_rcu_safe - acquire a reference to an RCU tracked fence >> + * @fence: [in]pointer to fence to

Re: kernel-lintdoc parser - was: Re: [PATCH v2 0/3] doc-rst:c-domain: fix some issues in the c-domain

Am 22.09.2016 um 14:35 schrieb Mauro Carvalho Chehab : > Hi Markus, > 3) this is actually a more complex problem: how to represent returned values > from the function callbacks. Maybe we'll need to patch kernel-doc. This might be a solution for dense kernel-doc comments

Re: kernel-lintdoc parser - was: Re: [PATCH v2 0/3] doc-rst:c-domain: fix some issues in the c-domain

m Tue, 20 Sep 2016 20:56:35 +0200 >> Markus Heiser <markus.hei...@darmarit.de> escreveu: >> > >> The new parser seems to have some bugs, like those: >> >> $ kernel-lintdoc include/media/v4l2-ctrls.h >> include/media/v4l2-ctrls.h:106 :WARN: typedef of

Re: [RFC] Remove row numbers from tables in V4L2 documentation

Am 21.09.2016 um 10:48 schrieb Laurent Pinchart : > Hello, > > While documenting the metadata API I got annoyed by how tables were converted > from DocBook to ReST. I suggested to drop them, but Mauro wanted to address this later:

Re: [PATCH v2 0/3] doc-rst:c-domain: fix some issues in the c-domain

Am 19.09.2016 um 17:00 schrieb Mauro Carvalho Chehab : >> Hmm, as far as I see, the output is not correct ... The output of >> functions with a function pointer argument are missing the >> leading parenthesis in the function definition: >> >> .. c:function:: struct

Re: [PATCH v2 0/3] doc-rst:c-domain: fix some issues in the c-domain

Hi Mauro, sorry for my late reply (so much work to do) .. Am 09.09.2016 um 14:25 schrieb Markus Heiser <markus.hei...@darmarit.de>: >> Using either this approach or my kernel-doc patch, I'm now getting >> only two warnings: >> >> 1) at media-entit

Re: [PATCH v2 0/3] doc-rst:c-domain: fix some issues in the c-domain

Am 16.09.2016 um 18:02 schrieb Jonathan Corbet <cor...@lwn.net>: > On Wed, 7 Sep 2016 09:12:55 +0200 > Markus Heiser <markus.hei...@darmarit.de> wrote: > >> according to your remarks I fixed the first and second patch. The third >> patch is >> resend unc

Re: [PATCH v2 0/3] doc-rst:c-domain: fix some issues in the c-domain

Am 09.09.2016 um 14:08 schrieb Mauro Carvalho Chehab <mche...@infradead.org>: > Em Wed, 7 Sep 2016 09:12:55 +0200 > Markus Heiser <markus.hei...@darmarit.de> escreveu: > >> From: Markus Heiser <markus.hei...@darmarit.de> >> >> Hi Jon, >&

Re: [PATCH 03/47] docs-rst: parse-headers.pl: use the C domain for cross-references

Hi BTW: porting parse-headers to python / get rid of media/Makefile * https://www.mail-archive.com/linux-media@vger.kernel.org/msg101261.html I think last relevant comment was from you Mauro: * https://www.mail-archive.com/linux-media@vger.kernel.org/msg101426.html should we continue this

Re: [PATCH v3] docs-rst: ignore arguments on macro definitions

Am 08.09.2016 um 13:40 schrieb Mauro Carvalho Chehab <mche...@s-opensource.com>: > Hi Jon/Markus, > > Em Mon, 29 Aug 2016 16:12:39 +0200 > Markus Heiser <markus.hei...@darmarit.de> escreveu: > >> Am 29.08.2016 um 15:13 schrieb Mauro Carvalho Che

Re: [PATCH 2/2] v4l-utils: fixed dvbv5 vdr format

Am 07.09.2016 um 19:59 schrieb VDR User : >> It is broken (see below). Have you ever used dvbv5 tools with vdr format >> output or did you know a "VDR user" who is using dvbv5-scan and not wscan? > > In my experience the v4l scanner, wscan, and VDR's internal scanner > has

Re: [PATCH 2/2] v4l-utils: fixed dvbv5 vdr format

Am 06.09.2016 um 17:47 schrieb Mauro Carvalho Chehab : > Em Tue, 6 Sep 2016 08:16:22 -0700 > VDR User escreveu: > >> I can tell you that people do still use VDR-1.6.0-3. It would be >> unwise (and unnecessary) to break backwards compatible, which

Re: [PATCH 1/3] doc-rst:c-domain: fix sphinx version incompatibility

Am 06.09.2016 um 17:55 schrieb Mauro Carvalho Chehab : ... >> Sphinx has some more of these tuples with fixed length (remember >> conf.py, the latex_documents settings) where IMHO hash/value pairs >> (dicts) are more suitable. > > Well, the LaTeX stuff at conf.py seems to

[PATCH v2 0/3] doc-rst:c-domain: fix some issues in the c-domain

From: Markus Heiser <markus.hei...@darmarit.de> Hi Jon, according to your remarks I fixed the first and second patch. The third patch is resend unchanged; > Am 06.09.2016 um 14:28 schrieb Jonathan Corbet <cor...@lwn.net>: > > As others have pointed out, we generally want t

[RFC v2 3/3] doc-rst:c-domain: function-like macros index entry

From: Markus Heiser <markus.hei...@darmarit.de> For function-like macros, sphinx creates 'FOO (C function)' entries. With this patch 'FOO (C macro)' are created for function-like macros, which is the same for object-like macros. Signed-off-by: Markus Heiser <markus.hei...@da

[PATCH v2 2/3] doc-rst:c-domain: function-like macros arguments

From: Markus Heiser <markus.hei...@darmarit.de> Handle signatures of function-like macros well. Don't try to deduce arguments types of function-like macros. Signed-off-by: Markus Heiser <markus.hei...@darmarit.de> --- Documentation/sphinx/cdo

[PATCH v2 1/3] doc-rst:c-domain: fix sphinx version incompatibility

From: Markus Heiser <markus.hei...@darmarit.de> The self.indexnode's tuple has changed in sphinx version 1.4, from a former 4 element tuple to a 5 element tuple. https://github.com/sphinx-doc/sphinx/commit/e6a5a3a92e938fcd75866b4227db9e0524d58f7c Signed-off-by: Markus Heiser <m

Re: [PATCH 2/3] doc-rst:c-domain: function-like macros arguments

Am 06.09.2016 um 14:27 schrieb Jonathan Corbet <cor...@lwn.net>: > So I'm going into total nit-picking territory here, but since I'm looking > at it and I think the series needs a respin anyway... > > On Wed, 31 Aug 2016 17:29:31 +0200 > Markus Heiser <markus.h

Re: [PATCH 1/3] doc-rst:c-domain: fix sphinx version incompatibility

Am 06.09.2016 um 15:34 schrieb Jani Nikula <jani.nik...@intel.com>: > On Tue, 06 Sep 2016, Jonathan Corbet <cor...@lwn.net> wrote: >> On Wed, 31 Aug 2016 17:29:30 +0200 >> Markus Heiser <markus.hei...@darmarit.de> wrote: >> >&

Re: [PATCH 1/3] doc-rst:c-domain: fix sphinx version incompatibility

Am 06.09.2016 um 14:19 schrieb Jonathan Corbet <cor...@lwn.net>: > On Wed, 31 Aug 2016 17:29:30 +0200 > Markus Heiser <markus.hei...@darmarit.de> wrote: > >> +if major >= 1 and minor < 4: >> +# indexnode's tuple changed

Re: [PATCH 2/2] v4l-utils: fixed dvbv5 vdr format

b <mche...@s-opensource.com> escreveu: > >> Hi Markus, >> >> Em Wed, 10 Aug 2016 11:52:19 +0200 >> Markus Heiser <markus.hei...@darmarit.de> escreveu: >> >>> From: Markus Heiser <markus.hei...@darmarit.de> >>> >>> From: H

Re: [PATCH] doc-rst:sphinx-extensions: add metadata parallel-safe

Am 01.09.2016 um 18:22 schrieb Markus Heiser <markus.hei...@darmarit.de>: > > Am 01.09.2016 um 16:29 schrieb Jani Nikula <jani.nik...@linux.intel.com>: > >> On Thu, 01 Sep 2016, Jonathan Corbet <cor...@lwn.net> wrote: >>> On Wed, 24 Aug 2016 15

Re: [PATCH] doc-rst:sphinx-extensions: add metadata parallel-safe

Am 01.09.2016 um 16:29 schrieb Jani Nikula <jani.nik...@linux.intel.com>: > On Thu, 01 Sep 2016, Jonathan Corbet <cor...@lwn.net> wrote: >> On Wed, 24 Aug 2016 15:35:24 +0200 >> Markus Heiser <markus.hei...@darmarit.de> wrote: >> >>> With

[PATCH 2/3] doc-rst:c-domain: function-like macros arguments

From: Markus Heiser <markus.hei...@darmarit.de> Handle signatures of function-like macros well. Don't try to deduce arguments types of function-like macros. Signed-off-by: Markus Heiser <markus.hei...@darmarit.de> --- Documentation/sphinx/cdo

[PATCH 1/3] doc-rst:c-domain: fix sphinx version incompatibility

From: Markus Heiser <markus.hei...@darmarit.de> The self.indexnode's tuple has changed in sphinx version 1.4, from a former 4 element tuple to a 5 element tuple. https://github.com/sphinx-doc/sphinx/commit/e6a5a3a92e938fcd75866b4227db9e0524d58f7c Signed-off-by: Markus Heiser <m

[PATCH 3/3] doc-rst:c-domain: function-like macros index entry

From: Markus Heiser <markus.hei...@darmarit.de> For function-like macros, sphinx creates 'FOO (C function)' entries. With this patch 'FOO (C macro)' are created for function-like macros, which is the same for object-like macros. Signed-off-by: Markus Heiser <markus.hei...@da

[RFC PATCH 0/3] doc-rst:c-domain: fix some issues in the c-domain

From: Markus Heiser <markus.hei...@darmarit.de> Hi Jon, this is a small series, fixing a issues about sphinx version incompatibility and adds improved handling of function-like macros [1]. The last patch is optional, I don't know if it is better to create 'FOO (C macro)' index entries i

Re: [PATCH v3] docs-rst: ignore arguments on macro definitions

Am 31.08.2016 um 12:26 schrieb Mauro Carvalho Chehab <mche...@s-opensource.com>: > Em Wed, 31 Aug 2016 12:09:39 +0200 > Markus Heiser <markus.hei...@darmarit.de> escreveu: > >> Am 31.08.2016 um 11:02 schrieb Jani Nikula <jani.nik...@linux.intel.com>: >>

Re: [PATCH v3] docs-rst: ignore arguments on macro definitions

Am 31.08.2016 um 11:02 schrieb Jani Nikula <jani.nik...@linux.intel.com>: > On Wed, 31 Aug 2016, Markus Heiser <markus.hei...@darmarit.de> wrote: >> I haven't tested your suggestion, but since *void* is in the list >> of stop-words: >> >># These C ty

Re: [PATCH v3] docs-rst: ignore arguments on macro definitions

Am 29.08.2016 um 17:36 schrieb Jani Nikula <jani.nik...@linux.intel.com>: > On Mon, 29 Aug 2016, Mauro Carvalho Chehab <mche...@s-opensource.com> wrote: >> Em Mon, 29 Aug 2016 16:12:39 +0200 >> Markus Heiser <markus.hei...@darmarit.de> escreveu: >> &

Re: [PATCH v3] docs-rst: ignore arguments on macro definitions

Am 29.08.2016 um 15:13 schrieb Mauro Carvalho Chehab : > A macro definition is mapped via .. c:function:: at the > ReST markup when using the following kernel-doc tag: > > /** >* DMX_FE_ENTRY - Casts elements in the list of registered >*

Re: [PATCH 0/3] doc-rst: generic way to build PDF of sub-folder

Am 26.08.2016 um 13:34 schrieb Mauro Carvalho Chehab <mche...@infradead.org>: > Hi Markus, > > Em Wed, 24 Aug 2016 17:36:13 +0200 > Markus Heiser <markus.hei...@darmarit.de> escreveu: > >> From: Markus Heiser <markus.hei...@darmarit.de> >> >

[PATCH 3/3] doc-rst:media: build separated PDF books (experimental)

From: Markus Heiser <markus.hei...@darmarit.de> This patch is only to demonstrate, how to build separated PDF books of the media sub-folder and close open links with intersphinx. It is an experimental state (I detected an build error, which I have not yet traced deep). Build

[PATCH 1/3] doc-rst: generic way to build PDF of sub-folders

From: Markus Heiser <markus.hei...@darmarit.de> This extends the method to build only sub-folders to the targets "latexdocs" and "pdfdocs". To do so, a conf.py in the sub-folder is required, where the latex_documents of the sub-folder are defined. E.g. to build only g

[PATCH 2/3] doc-rst: define PDF's of the media folder

From: Markus Heiser <markus.hei...@darmarit.de> To build only the PDF of the media folder run:: make SPHINXDIRS=media pdfdocs Signed-off-by: Markus Heiser <markus.hei...@darmarit.de> --- Documentation/media/conf.py | 5 + 1 file changed, 5 insertions(+) diff --git a/Documen

[PATCH 0/3] doc-rst: generic way to build PDF of sub-folder

From: Markus Heiser <markus.hei...@darmarit.de> Hi Mauro, here is a small patch series which extends the method to build only sub-folders to the targets "latexdocs" and "pdfdocs". If you think, that the two first patches works for you, path them with your next merge to

[PATCH] doc-rst:sphinx-extensions: add metadata parallel-safe

From: Markus Heiser <markus.hei...@darmarit.de> The setup() function of a Sphinx-extension can return a dictionary. This is treated by Sphinx as metadata of the extension [1]. With metadata "parallel_read_safe = True" a extension is marked as save for "parallel reading of so

Re: [PATCH 0/9] Prepare Sphinx to build media PDF books

Am 24.08.2016 um 12:42 schrieb Mauro Carvalho Chehab : > Markus, > > Em Thu, 18 Aug 2016 17:21:27 -0600 > Jonathan Corbet escreveu: > >> On Tue, 16 Aug 2016 13:25:34 -0300 >> Mauro Carvalho Chehab wrote: >> >>> I think this

Re: [PATCH v2 2/2] Documentation/sphinx: link dma-buf rsts

Am 23.08.2016 um 08:01 schrieb Daniel Vetter : > On Mon, Aug 22, 2016 at 12:49:30PM -0300, Mauro Carvalho Chehab wrote: >> Em Mon, 22 Aug 2016 20:41:45 +0530 >> Sumit Semwal escreveu: >> >>> Include dma-buf sphinx documentation into top level index.

Re: RFC? [PATCH] docs-rst: kernel-doc: better output struct members

Am 22.08.2016 um 14:15 schrieb Mauro Carvalho Chehab <mche...@s-opensource.com>: > Em Mon, 22 Aug 2016 14:52:42 +0300 > Jani Nikula <jani.nik...@intel.com> escreveu: > >> On Mon, 22 Aug 2016, Markus Heiser <markus.hei...@darmarit.de> wrote: >>>

Re: RFC? [PATCH] docs-rst: kernel-doc: better output struct members

Am 22.08.2016 um 13:52 schrieb Jani Nikula <jani.nik...@intel.com>: > On Mon, 22 Aug 2016, Markus Heiser <markus.hei...@darmarit.de> wrote: >> Am 22.08.2016 um 13:16 schrieb Jani Nikula <jani.nik...@intel.com>: >> >>> On Mon, 22 Aug 2016, Mauro Carval

Re: RFC? [PATCH] docs-rst: kernel-doc: better output struct members

Am 22.08.2016 um 12:06 schrieb Mauro Carvalho Chehab <mche...@s-opensource.com>: > Markus, > > Em Mon, 22 Aug 2016 10:56:01 +0200 > Markus Heiser <markus.hei...@darmarit.de> escreveu: > >> Am 21.08.2016 um 14:11 schrieb Mauro Carvalho Chehab >> <mc

Re: RFC? [PATCH] docs-rst: kernel-doc: better output struct members

Am 22.08.2016 um 13:16 schrieb Jani Nikula <jani.nik...@intel.com>: > On Mon, 22 Aug 2016, Mauro Carvalho Chehab <mche...@s-opensource.com> wrote: >> Markus, >> >> Em Mon, 22 Aug 2016 10:56:01 +0200 >> Markus Heiser <markus.hei...@darmarit.de> esc

Re: [PATCH 2/2] v4l-utils: fixed dvbv5 vdr format

Am 16.08.2016 um 09:10 schrieb Markus Heiser <markus.hei...@darmarit.de>: > Am 10.08.2016 um 11:52 schrieb Markus Heiser <markus.hei...@darmarit.de>: > >> The vdr format was broken, I got '(null)' entries >> >> HD:11494:S1HC23I0M5N1O35:S:(null):22000:5101

RFC? [PATCH] docs-rst: kernel-doc: better output struct members

Am 21.08.2016 um 14:11 schrieb Mauro Carvalho Chehab : > Right now, for a struct, kernel-doc produces the following output: > > .. c:type:: struct v4l2_prio_state > > stores the priority states > > **Definition** > > :: > > struct

Re: [PATCH 1/7] doc-rst: generic way to build only sphinx sub-folders

Am 19.08.2016 um 14:49 schrieb Jani Nikula <jani.nik...@intel.com>: > On Fri, 19 Aug 2016, Markus Heiser <markus.hei...@darmarit.de> wrote: >> Am 19.08.2016 um 00:35 schrieb Jonathan Corbet <cor...@lwn.net>: >> * the pdf goes to the "latex" folder .. si

Re: [PATCH 1/7] doc-rst: generic way to build only sphinx sub-folders

Am 19.08.2016 um 00:35 schrieb Jonathan Corbet <cor...@lwn.net>: > On Sat, 13 Aug 2016 16:12:42 +0200 > Markus Heiser <markus.hei...@darmarit.de> wrote: > >> Add a generic way to build only a reST sub-folder with or >> without a individual *build-them

Re: [PATCH 0/7] doc-rst: sphinx sub-folders & parseheaders directive

Am 17.08.2016 um 07:44 schrieb Markus Heiser <markus.hei...@darmarit.de>: > > @Daniel: I added you to this discussion. May you are interested in, > it is about the parse-headers functionality from Mauro. > > Am 16.08.2016 um 20:22 schrieb Mauro Carvalho Chehab &

Re: [PATCH 0/7] doc-rst: sphinx sub-folders & parseheaders directive

@Daniel: I added you to this discussion. May you are interested in, it is about the parse-headers functionality from Mauro. Am 16.08.2016 um 20:22 schrieb Mauro Carvalho Chehab <mche...@infradead.org>: > Em Mon, 15 Aug 2016 10:21:07 +0200 > Markus Heiser <markus.hei...@darmar

Re: [PATCH RFC v2 3/9] docs-rst: Don't mangle with UTF-8 chars on LaTeX/PDF output

Am 16.08.2016 um 14:16 schrieb Mauro Carvalho Chehab : ... > The only issue there was the name of the math extension, with is also > sphinx.ext.pngmath. On a plus side, I was also able to remove one of the > hacks, by applying the enclosed patch (this doesn't work on

Re: [PATCH RFC v2 3/9] docs-rst: Don't mangle with UTF-8 chars on LaTeX/PDF output

Am 16.08.2016 um 13:03 schrieb Mauro Carvalho Chehab : > Em Tue, 16 Aug 2016 06:36:05 -0300 > Mauro Carvalho Chehab escreveu: > > 2) the Latex auto-generated Makefile is hardcoded to use pdflatex. So, > I had to manually replace it to

Re: [PATCH RFC v2 3/9] docs-rst: Don't mangle with UTF-8 chars on LaTeX/PDF output

Am 15.08.2016 um 23:21 schrieb Mauro Carvalho Chehab : > pdflatex doesn't accept using some UTF-8 chars, like > "equal or less than" or "equal or greater than" chars. However, > the media documents use them. So, we need to use XeLaTeX for > conversion, and a font that

Re: [PATCH 2/2] v4l-utils: fixed dvbv5 vdr format

Am 10.08.2016 um 11:52 schrieb Markus Heiser <markus.hei...@darmarit.de>: > The vdr format was broken, I got '(null)' entries > > HD:11494:S1HC23I0M5N1O35:S:(null):22000:5101:5102,5103,5106,5108:0:0:10301:0:0:0: > 0-:1:2--:3:4-: > > r

[PATCH] doc-rst: add index to sub-folders

From: Markus Heiser <markus.hei...@darmarit.de> Add a index if only a sub-folder is build e.g.:: make SPHINXDIRS=media cleandocs htmldocs BTW: removed dead search link in the top-index file Signed-off-by: Markus Heiser <markus.hei...@darmarit.de> --- Documentation/gpu/con

[PATCH 3/5] doc-rst: moved *duplicate* warnings to nitpicky mode

From: Markus Heiser <markus.hei...@darmarit.de> Moved the *duplicate C object description* warnings for function declarations in the nitpicky mode. In nitpick mode, you can suppress those warnings (e.g. ioctl) with:: nitpicky = True nitpick_ignore = [ ("c:func", &q

[PATCH 2/5] doc-rst:c-domain: ref-name of a function declaration

From: Markus Heiser <markus.hei...@darmarit.de> Add option 'name' to the "c:function:" directive. With option 'name' the ref-name of a function can be modified. E.g.:: .. c:function:: int ioctl( int fd, int request ) :name: VIDIOC_LOG_STATUS The func-name (e.g

[PATCH 5/5] doc-rst: migrate ioctl CEC_DQEVENT to c-domain

From: Markus Heiser <markus.hei...@darmarit.de> This is only one example, demonstrating the benefits of the patch series. The CEC_DQEVENT ioctl is migrated to the sphinx c-domain and referred by ":name: CEC_DQEVENT". With this change the indirection using ":ref:`CEC_DQEVENT

[PATCH 1/5] doc-rst: add boilerplate to customize c-domain

From: Markus Heiser <markus.hei...@darmarit.de> Add a sphinx-extension to customize the sphinx c-domain. No functional changes right yet, just the boilerplate code. Signed-off-by: Markus Heiser <markus.hei...@darmarit.de> --- Documentation/conf.py | 2 +- Document

  1   2   >