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 {
> struct list_head lis
> 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 support to document them.
>
> So I've finally fo
> Am 29.09.2017 um 17:29 schrieb Mauro Carvalho Chehab
> :
>
> Em Thu, 28 Sep 2017 18:28:32 +0200
> Markus Heiser escreveu:
>
>> Hi Mauro,
>>
>>> Am 27.09.2017 um 23:10 schrieb Mauro Carvalho Chehab
>>> :
>
>>
> 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 only me who recommend to
>>
> Am 29.09.2017 um 14:08 schrieb Mauro Carvalho Chehab
> :
>
> Em Thu, 28 Sep 2017 18:28:32 +0200
> Markus Heiser escreveu:
>
>> Hi Mauro,
>>
>>> Am 27.09.2017 um 23:10 schrieb Mauro Carvalho Chehab
>>> :
>>>
>> I al
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 Cheh
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
> +++ b/Documentation/doc-guide/
> 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 now document both anonymous
> 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 latter good for? I guess the 'n
> Am 24.09.2017 um 19:38 schrieb Mauro Carvalho Chehab
> :
>
> Em Sun, 24 Sep 2017 17:13:13 +0200
> Markus Heiser escreveu:
>
>>> Am 24.09.2017 um 12:23 schrieb Mauro Carvalho Che
>>>
>>> v2: handle embedded structs/unions from inner to o
> 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
# ignore members marked private:
Hi Mauro,
I tested this patch. Feel free to add my
Tested-by: Markus Heiser
FYI: I also migrated the patch to my python kernel-doc parser:
https://github.com/return42/linuxdoc/commit/5dbb93f
And here is the impact of this patch on the whole sources:
http
Am 30.03.2017 um 13:17 schrieb Markus Heiser :
>
> If it helps ... dbxml2rst also supports single file conversion ... I updated:
>
>
> https://github.com/return42/sphkerneldoc/tree/master/Documentation/books_migrated
>
> There you find a folder for each DocBook convers
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
>>> documentation in rst at
Am 30.03.2017 um 10:21 schrieb Jani Nikula :
> On Thu, 30 Mar 2017, Markus Heiser wrote:
>> 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
&
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 ;-) I'am not very happy with this
x:100: recipe for target 'cleandocs' failed
Signed-off-by: Markus Heiser
---
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/Makefi
Am 11.11.2016 um 12:22 schrieb Jani Nikula :
> On Thu, 10 Nov 2016, Jani Nikula wrote:
>> On Thu, 10 Nov 2016, Markus Heiser wrote:
>>> Could this POC persuade you, if so, I send a more elaborate RFC,
>>> what do you think about?
>>
>> Sorry, I do not
On 09.11.2016 12:58, Jani Nikula wrote:
> On Wed, 09 Nov 2016, Markus Heiser wrote:
>> 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
>>>
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.;
>
> We're supposed to solve p
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 directly handle the sourc
Am 02.11.2016 um 12:43 schrieb Jani Nikula :
> On Wed, 24 Aug 2016, Markus Heiser wrote:
>> From: Markus Heiser
>>
>> This extends the method to build only sub-folders to the targets
>> "latexdocs" and "pdfdocs". To do so, a conf.py in the sub-f
On 27.10.2016 16:52, Jani Nikula wrote:
On Thu, 27 Oct 2016, Markus Heiser wrote:
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/medi
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 when nothing has changed.
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. Actually,
>> if we force the need of a "syscall
https://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:
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
---
Documentation/sphinx/kernel_cmd.py
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
Am 18.10.2016 um 12:06 schrieb Mauro Carvalho Chehab :
> Sorry, I missed part of your comments on my last reply...
>
>
> Em Tue, 18 Oct 2016 09:03:28 +0200
> Markus Heiser escreveu:
>
>> +- ``T:`` SCM tree type and location.
>> +
>>> + - T
Am 17.10.2016 um 18:46 schrieb Mauro Carvalho Chehab :
> Hi Markus,
>
> Em Thu, 6 Oct 2016 09:20:17 +0200
> Markus Heiser escreveu:
>
>> From: Markus Heiser
>>
>> The ``kernel-cmd`` directive includes contend from the stdout of a
>> command-line. W
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 scripts/get_maintainer.pl
From: Chris Mayo
Before (1.10.1):
BBC TWO:498000:S0B8C23D12I999M64T8G32Y0:T:27500:201:202,206:0:0:4287:0:0:0
BBC TWO
HD:474167:S1B8C23D999I999M256T32G128Y0:T:27500:101:102,106:0:0:17472:0:0:0
After:
BBC TWO:498000:B8C23D12G32I999M64S0T8Y0:T:0:201:202,206:0:0:4287:0:0:0
BBC TWO
HD:474167:B8C23D9
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 linux-m
From: Markus Heiser
From: Heiser, Markus
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 the VDR Wikis ...
* LinuxTV: http://www.linuxtv.org/vdrwiki
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 extension upstream);
>
> 2)
Am 11.10.2016 um 17:34 schrieb Jani Nikula :
> On Tue, 11 Oct 2016, Mauro Carvalho Chehab wrote:
>> Em Tue, 11 Oct 2016 09:26:48 +0200
>> Markus Heiser escreveu:
>>
>>> Am 07.10.2016 um 07:56 schrieb Jani Nikula :
>>>
>>>> On Thu, 06 Oct 201
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 scripts to
>>> build documentation. We've worked hard to get rid of that
From: Markus Heiser
From: Markus Heiser
Remove the media-Makefile and migrate the ``.. kernel-include::``
directive to the new ``.. kernel-cmd::`` directive.
To avoid breaking bisect, this patch includes the required changes to
the implementation (script ``parse-headers.pl``) and the content
From: Markus Heiser
From: Markus Heiser
Format the literal-block like other code-block elements, with 12px and a
line-high of 1.5.
Signed-off-by: Markus Heiser
---
Documentation/sphinx-static/theme_overrides.css | 7 +++
1 file changed, 7 insertions(+)
diff --git a/Documentation/sphinx
From: Markus Heiser
From: Markus Heiser
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 more general solution
for other workarounds like the "kernel_in
From: Markus Heiser
From: Markus Heiser
The kernel-include directive is no longer needed, so lets remove this
out-of-favor solution.
BTW: fixed a C&P typo in the Documentation/Makefile
Signed-off-by: Markus Heiser
---
Documentation/Makefile.sphinx | 2 +-
Documentation/con
From: Markus Heiser
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 general solution for other
workar
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 robust instead of trying to approximate the real
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 increase refcount o
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 where you
want to have pa
Hi Mauro,
thanks a lot for your tests and inspirations ...
Am 22.09.2016 um 14:35 schrieb Mauro Carvalho Chehab :
> Hi Markus,
>
> Em Thu, 22 Sep 2016 09:08:50 -0300
> Mauro Carvalho Chehab escreveu:
>
>> Em Tue, 20 Sep 2016 20:56:35 +0200
>> Markus Heiser escreve
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:
https://www.mail-archive.com/linux-media@vger.kernel.org/msg10
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 v4l2_m2m_ctx * v4l2_m2m_ctx_
Hi Mauro,
sorry for my late reply (so much work to do) ..
Am 09.09.2016 um 14:25 schrieb Markus Heiser :
>> Using either this approach or my kernel-doc patch, I'm now getting
>> only two warnings:
>>
>> 1) at media-entity.h, even without nitpick mode:
>>
Am 16.09.2016 um 18:02 schrieb Jonathan Corbet :
> On Wed, 7 Sep 2016 09:12:55 +0200
> Markus Heiser wrote:
>
>> according to your remarks I fixed the first and second patch. The third
>> patch is
>> resend unchanged;
>
> OK, I've applied the first two,
Am 09.09.2016 um 14:08 schrieb Mauro Carvalho Chehab :
> Em Wed, 7 Sep 2016 09:12:55 +0200
> Markus Heiser escreveu:
>
>> From: Markus Heiser
>>
>> Hi Jon,
>>
>> according to your remarks I fixed the first and second patch. The third
>> patch
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 tas
Am 08.09.2016 um 13:40 schrieb Mauro Carvalho Chehab :
> Hi Jon/Markus,
>
> Em Mon, 29 Aug 2016 16:12:39 +0200
> Markus Heiser escreveu:
>
>> Am 29.08.2016 um 15:13 schrieb Mauro Carvalho Chehab
>> :
>>
>>> A macro definition is mapped via .. c:fu
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 never worked well (for
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 would be
>> grounds for NACK if you ask me. Know
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 have a new field on vers
From: Markus Heiser
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 :
>
> As others have pointed out, we generally want to hide the difference
> between functions and macros
From: Markus Heiser
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
---
Documentation/sphinx/cdomain.py | 1
From: Markus Heiser
Handle signatures of function-like macros well. Don't try to deduce
arguments types of function-like macros.
Signed-off-by: Markus Heiser
---
Documentation/sphinx/cdomain.py | 55 -
1 file changed, 54 insertions(+), 1 del
From: Markus Heiser
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
---
Documentation/sphinx/cdomain.py
Am 06.09.2016 um 14:27 schrieb Jonathan Corbet :
> 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 wrote:
>
>> +
Am 06.09.2016 um 15:34 schrieb Jani Nikula :
> On Tue, 06 Sep 2016, Jonathan Corbet wrote:
>> On Wed, 31 Aug 2016 17:29:30 +0200
>> Markus Heiser wrote:
>>
>>> +if major >= 1 and minor < 4:
>>> +# indexnode's tupl
Am 06.09.2016 um 14:19 schrieb Jonathan Corbet :
> On Wed, 31 Aug 2016 17:29:30 +0200
> Markus Heiser wrote:
>
>> +if major >= 1 and minor < 4:
>> +# indexnode's tuple changed in 1.4
>> +#
>>
s,
>>
>> Em Wed, 10 Aug 2016 11:52:19 +0200
>> Markus Heiser escreveu:
>>
>>> From: Markus Heiser
>>>
>>> From: Heiser, Markus
>>>
>>> The vdr format was broken, I got '(null)' entries
>>>
>>&g
Am 01.09.2016 um 18:22 schrieb Markus Heiser :
>
> Am 01.09.2016 um 16:29 schrieb Jani Nikula :
>
>> On Thu, 01 Sep 2016, Jonathan Corbet wrote:
>>> On Wed, 24 Aug 2016 15:35:24 +0200
>>> Markus Heiser wrote:
>>>
>>>> With metadat
Am 01.09.2016 um 16:29 schrieb Jani Nikula :
> On Thu, 01 Sep 2016, Jonathan Corbet wrote:
>> On Wed, 24 Aug 2016 15:35:24 +0200
>> Markus Heiser wrote:
>>
>>> With metadata "parallel_read_safe = True" a extension is marked as
>>> save for &q
From: Markus Heiser
Handle signatures of function-like macros well. Don't try to deduce
arguments types of function-like macros.
Signed-off-by: Markus Heiser
---
Documentation/sphinx/cdomain.py | 55 -
1 file changed, 54 insertions(+), 1 del
From: Markus Heiser
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
---
Documentation/sphinx/cdomain.py | 1
From: Markus Heiser
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
---
Documentation/sphinx/cdomain.py
From: Markus Heiser
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 instead of
'FOO (
Am 31.08.2016 um 12:26 schrieb Mauro Carvalho Chehab :
> Em Wed, 31 Aug 2016 12:09:39 +0200
> Markus Heiser escreveu:
>
>> Am 31.08.2016 um 11:02 schrieb Jani Nikula :
>>
>>> On Wed, 31 Aug 2016, Markus Heiser wrote:
>>>> I haven't tested y
Am 31.08.2016 um 11:02 schrieb Jani Nikula :
> On Wed, 31 Aug 2016, Markus Heiser wrote:
>> I haven't tested your suggestion, but since *void* is in the list
>> of stop-words:
>>
>># These C types aren't described anywhere, so don't try t
Am 29.08.2016 um 17:36 schrieb Jani Nikula :
> On Mon, 29 Aug 2016, Mauro Carvalho Chehab wrote:
>> Em Mon, 29 Aug 2016 16:12:39 +0200
>> Markus Heiser escreveu:
>>
>>> Am 29.08.2016 um 15:13 schrieb Mauro Carvalho Chehab
>>> :
>>>
>>
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
>* front-ends from the ge
Am 26.08.2016 um 13:34 schrieb Mauro Carvalho Chehab :
> Hi Markus,
>
> Em Wed, 24 Aug 2016 17:36:13 +0200
> Markus Heiser escreveu:
>
>> From: Markus Heiser
>>
>> Hi Mauro,
>>
>> here is a small patch series which extends the method to
From: Markus Heiser
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).
Builds PDFs of:
* media_uapi.pdf: Linux Media
From: Markus Heiser
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 gpu's PDF add the following
From: Markus Heiser
To build only the PDF of the media folder run::
make SPHINXDIRS=media pdfdocs
Signed-off-by: Markus Heiser
---
Documentation/media/conf.py | 5 +
1 file changed, 5 insertions(+)
diff --git a/Documentation/media/conf.py b/Documentation/media/conf.py
index 77cb2bb
From: Markus Heiser
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 Jon's doc-next.
The las
From: Markus Heiser
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 source". This is needed
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 patch series belong to docs-next. Feel free to merge them
>>> there
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.
>>>
>>> Signed-off-by: Sumit Semwal
>>> ---
Am 22.08.2016 um 14:15 schrieb Mauro Carvalho Chehab :
> Em Mon, 22 Aug 2016 14:52:42 +0300
> Jani Nikula escreveu:
>
>> On Mon, 22 Aug 2016, Markus Heiser wrote:
>>> Am 22.08.2016 um 13:16 schrieb Jani Nikula :
>>>
>>>> On Mon, 22 Aug 2016, Mauro
Am 22.08.2016 um 13:52 schrieb Jani Nikula :
> On Mon, 22 Aug 2016, Markus Heiser wrote:
>> Am 22.08.2016 um 13:16 schrieb Jani Nikula :
>>
>>> On Mon, 22 Aug 2016, Mauro Carvalho Chehab wrote:
>>>> Markus,
>>>>
>>>> Em
Am 22.08.2016 um 12:06 schrieb Mauro Carvalho Chehab :
> Markus,
>
> Em Mon, 22 Aug 2016 10:56:01 +0200
> Markus Heiser escreveu:
>
>> Am 21.08.2016 um 14:11 schrieb Mauro Carvalho Chehab
>> :
>>
>>> Right now, for a struct, kernel-doc produces th
Am 22.08.2016 um 13:16 schrieb Jani Nikula :
> On Mon, 22 Aug 2016, Mauro Carvalho Chehab wrote:
>> Markus,
>>
>> Em Mon, 22 Aug 2016 10:56:01 +0200
>> Markus Heiser escreveu:
>>
>>> Am 21.08.2016 um 14:11 schrieb Mauro Carvalho Chehab
>>&
Am 16.08.2016 um 09:10 schrieb Markus Heiser :
> Am 10.08.2016 um 11:52 schrieb Markus Heiser :
>
>> 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
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 v4l2_prio_state {
>
Am 19.08.2016 um 14:49 schrieb Jani Nikula :
> On Fri, 19 Aug 2016, Markus Heiser wrote:
>> Am 19.08.2016 um 00:35 schrieb Jonathan Corbet :
>> * the pdf goes to the "latex" folder .. since this is WIP
>> and there are different solutions conceivable ... I
Am 19.08.2016 um 00:35 schrieb Jonathan Corbet :
> On Sat, 13 Aug 2016 16:12:42 +0200
> Markus Heiser wrote:
>
>> Add a generic way to build only a reST sub-folder with or
>> without a individual *build-theme*.
>>
>> * control *sub-folders* by environment SPH
Am 17.08.2016 um 07:44 schrieb Markus Heiser :
>
> @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 :
>
>> Em Mon, 15 Aug 2016 10:21:0
@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 :
> Em Mon, 15 Aug 2016 10:21:07 +0200
> Markus Heiser escreveu:
>
>> Am 14.08.2016 um 20:09 s
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 1.4 yet -
> I suspect it req
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 xelatex. One easy solution would be to
> not use Make -C $BU
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 accepts such characters.
Rig
Am 10.08.2016 um 11:52 schrieb Markus Heiser :
> 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 the VDR Wikis ...
>
>
From: Markus Heiser
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
---
Documentation/gpu/conf.py | 2 ++
Documentation/gpu/index.rst | 7 +++
Documentation
From: Markus Heiser
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", "ioctl"),
]
See Sphinx d
From: Markus Heiser
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. ioctl) remains
From: Markus Heiser
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` is no longer
needed, we can
1 - 100 of 177 matches
Mail list logo
