[PATCH] doc: botching-up-ioctls: Make it clearer why structs must be padded

2018-05-02 Thread Daniel Vetter
This came up in discussions when reviewing drm patches. Cc: Eric Anholt <e...@anholt.net> Cc: linux-doc@vger.kernel.org Cc: Jonathan Corbet <cor...@lwn.net> Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> -- Aside: I wonder whether we shouldn't move this to some other

Re: [Intel-gfx] [PATCH 0/6] Add support for in-line nested struct comments

2018-02-19 Thread Daniel Vetter
> Intel-gfx mailing list > intel-...@lists.freedesktop.org > https://lists.freedesktop.org/mailman/listinfo/intel-gfx -- Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a

[PATCH 2/5] drm/print: Unconfuse kerneldoc

2017-12-14 Thread Daniel Vetter
is in the .c file, but the special annotations are all in the header. Cc'ing kernel-doc maintainers as fyi. Cc: linux-doc@vger.kernel.org Cc: Jonathan Corbet <cor...@lwn.net> Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- include/drm/drm_print.h | 2 +- 1 file changed,

Re: [PATCH] docs: fix, intel_guc_loader.c has been moved to intel_guc_fw.c

2017-12-12 Thread Daniel Vetter
> > > Thanks for pointing out. I miss the ":doc: GuC-specific firmware loader" > fix in that patch (doc section was removed in d9e2e0143c). Can you or > someone else from @intel fix this also? I've rebased the patch from you to only take that remaining part. Thanks for fixing this. -Daniel -- Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [PATCH] documentation/gpu/i915: fix docs build error after file rename

2017-12-04 Thread Daniel Vetter
ne "unsubscribe linux-doc" in > the body of a message to majord...@vger.kernel.org > More majordomo info at http://vger.kernel.org/majordomo-info.html -- Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [PATCH] drm/todo: Add s/dev_*/DRM_DEV_*/ coversion to TODO

2017-09-08 Thread Daniel Vetter
u/todo.rst > +++ b/Documentation/gpu/todo.rst > @@ -177,6 +177,17 @@ following drivers still use ``struct_mutex``: ``msm``, > ``omapdrm`` and > > Contact: Daniel Vetter, respective driver maintainers > > +Convert instances o

Re: [PATCH 6/7] docs: Do not include from include/drm/drm_color_mgmt.h

2017-07-18 Thread Daniel Vetter
4, but if you want to fix all the warnings in 4.13 already I think that makes sense. But I'll leave that to you and merging through docs-fixes. Acked-by: Daniel Vetter <daniel.vet...@ffwll.ch> > Documentation/gpu/drm-kms.rst | 3 --- > 1 file changed, 3 deletions(-) > > diff -

Re: [PULL] Docs for 4.13

2017-07-15 Thread Daniel Vetter
a) not have to wait more than a few seconds b) be sure it did rebuild everything that had to be rebuild. Makes things much nicer for developers, not so much for maintainers unfortunately, not sure how much faster we could make that. -Daniel -- Daniel Vetter Software Engineer, Intel Corporation ht

Re: [PATCH 0/5] Make PDF builds work again

2017-07-03 Thread Daniel Vetter
| 3 +- > .../media/uapi/v4l/vidioc-g-selection.rst | 4 +- > include/drm/bridge/dw_hdmi.h | 70 > +++------- > 4 files changed, 43 insertions(+), 44 deletions(-) > > -- > 2.13.1 > -- Daniel Vetter Software Engineer,

Re: [PATCH] kernel-doc parser mishandles declarations split into lines

2017-07-03 Thread Daniel Vetter
} Or do I miss something? -Daniel > $prototype .= $1 . $2; > ($2 eq '{') && $brcount++; > ($2 eq '}') && $brcount--; > -- > 2.7.4 > > -- > To unsubscribe from this list: send the line "unsubscribe linux-doc&

Re: converting Documentation/security/* to .rst

2017-05-05 Thread Daniel Vetter
correctly after all), but it's also useful for userspace developers. And it might grow in the future to include more. How should we organize this? I admit that I'd like to keep it in Documentation/gpu/ (because it is primarily aimed at kernel devs), but at least linking it somewhere else might be use

Re: [PATCH] drm/doc: Document feature merge deadlines

2017-03-22 Thread Daniel Vetter
On Tue, Mar 21, 2017 at 03:38:26PM -0400, Sean Paul wrote: > On Tue, Mar 21, 2017 at 04:52:28PM +0100, Daniel Vetter wrote: > > The discussion pretty much concluded without objections, let's > > document what we agreed on. > > > > Cc'ing linux-doc for the new t

[PATCH] drm/doc: Document feature merge deadlines

2017-03-21 Thread Daniel Vetter
Paul <seanp...@chromium.org> Cc: Jani Nikula <jani.nik...@linux.intel.com> Cc: Alex Deucher <alexdeuc...@gmail.com> Cc: Lukas Wunner <lu...@wunner.de> Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- Documentation/gpu/introduction.rst | 25 + Do

Re: [PATCH 6/6] drm/doc: atomic overview, with graph

2017-03-14 Thread Daniel Vetter
On Thu, Mar 02, 2017 at 12:24:25PM -0300, Gabriel Krisman Bertazi wrote: > Daniel Vetter <daniel.vet...@ffwll.ch> writes: > > > I want to split up a few more things and document some details better > > (like how exactly to subclass drm_atomic_state). And maybe also split

Re: [PATCH] [PATCH v6] docs-rst: automatically convert Graphviz and SVG images

2017-03-14 Thread Daniel Vetter
On Mon, Mar 13, 2017 at 04:41:08PM -0600, Jonathan Corbet wrote: > On Mon, 13 Mar 2017 19:16:54 +0100 > Daniel Vetter <dan...@ffwll.ch> wrote: > > > > Awesome! Can you pls send me/dri-devel a pull request with a stable tag > > > for drm-misc, so that I can

Re: [PATCH] [PATCH v6] docs-rst: automatically convert Graphviz and SVG images

2017-03-13 Thread Daniel Vetter
On Thu, Mar 09, 2017 at 06:48:29PM +0100, Daniel Vetter wrote: > On Thu, Mar 09, 2017 at 03:02:49AM -0700, Jonathan Corbet wrote: > > On Mon, 6 Mar 2017 14:09:27 +0100 > > Markus Heiser <markus.hei...@darmarit.de> wrote: > > > > > This patch brings scalable

Re: [PATCH] [PATCH v6] docs-rst: automatically convert Graphviz and SVG images

2017-03-09 Thread Daniel Vetter
le tag for drm-misc, so that I can apply all the drm diagram patches? Thanks, Daniel -- Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [PATCH] docs: Fix htmldocs build failure

2017-03-08 Thread Daniel Vetter
ripted bulk conversion of them to rst > unless people step up to do a better job. Give them a release cycle or > so to do it. Maybe shove the rst files under Documentation/staging, or > label them as such. Documentation/staging might be a good idea in general. There's a lot of outdated gunk

Re: [PATCH 1/6] doc: Explain light-handed markup preference a bit better

2017-03-07 Thread Daniel Vetter
On Thu, Mar 02, 2017 at 04:16:33PM +0100, Daniel Vetter wrote: > We already had a super-short blurb, but worth extending it I think: > We're still pretty far away from anything like a consensus, but > there's clearly a lot of people who prefer an as-light as possible > approach t

Re: [PATCH] [PATCH v6] docs-rst: automatically convert Graphviz and SVG images

2017-03-07 Thread Daniel Vetter
ww.mail-archive.com/linux-doc@vger.kernel.org/msg09828.html > [2] https://www.mail-archive.com/linux-doc@vger.kernel.org/msg09821.html > > Cc: Jonathan Corbet <cor...@lwn.net> > Cc: linux-doc@vger.kernel.org > Cc: Jani Nikula <jani.nik...@linux.intel.com> > Cc: Mauro C

Re: [PATCH 2/6] docs-rst: automatically convert Graphviz and SVG images

2017-03-06 Thread Daniel Vetter
On Mon, Mar 06, 2017 at 02:13:00PM +0100, Markus Heiser wrote: > > Am 06.03.2017 um 11:12 schrieb Daniel Vetter <dan...@ffwll.ch>: > > > Just to avoid confusion: Markus chatted a bit in private, and he > > volunteered to take over, and fix the few issues that need to b

Re: [PATCH 2/6] docs-rst: automatically convert Graphviz and SVG images

2017-03-06 Thread Daniel Vetter
On Tue, Feb 28, 2017 at 06:13:15PM +0100, Daniel Vetter wrote: > From: Markus Heiser <markus.hei...@darmarit.de> > > This patch brings scalable figure, image handling and a concept to > embed *render* markups: > > * DOT (http://www.graphviz.org) > * SVG > >

[PATCH 3/6] drm/doc: Add KMS overview graphs

2017-03-03 Thread Daniel Vetter
board.com> Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- Documentation/gpu/drm-kms-helpers.rst | 4 + Documentation/gpu/drm-kms.rst | 134 +- 2 files changed, 137 insertions(+), 1 deletion(-) diff --git a/Documentation/gpu/drm-kms-helpers.rs

Re: [PATCH 2/6] docs-rst: automatically convert Graphviz and SVG images

2017-03-02 Thread Daniel Vetter
On Thu, Mar 02, 2017 at 01:01:36PM -0300, Mauro Carvalho Chehab wrote: > Em Thu, 2 Mar 2017 16:53:04 +0100 > Daniel Vetter <dan...@ffwll.ch> escreveu: > > > On Thu, Mar 2, 2017 at 4:22 PM, Jonathan Corbet <cor...@lwn.net> wrote: > > > On Thu, 2 Mar 2017 16:

Re: [PATCH] docs-rst: automatically convert Graphviz and SVG images

2017-03-02 Thread Daniel Vetter
(err)) > + > +exit_code = p.returncode > +return bool(exit_code == 0) Yes, I very much want stderr to be forward. Without that you don't see error output from dot or convert, and that makes it impossible to debug anything. If I want a direct forwarding of the bytes, how

[PATCH 5/6] drm/doc: diagram for mode objects and properties

2017-03-02 Thread Daniel Vetter
el Krisman Bertazi <kris...@collabora.co.uk> Reviewed-by: Laurent Pinchart <laurent.pinch...@ideasonboard.com> Signed-off-by: Daniel Vetter <daniel.vet...@ffwll.ch> --- Documentation/gpu/drm-kms.rst | 22 ++ 1 file changed, 22 insertions(+) diff --git a/Documentati

[PATCH 1/6] doc: Explain light-handed markup preference a bit better

2017-03-02 Thread Daniel Vetter
on for details. Cc: Jonathan Corbet <cor...@lwn.net> Cc: linux-doc@vger.kernel.org Cc: Christoph Hellwig <h...@infradead.org> Cc: Peter Zijlstra <pet...@infradead.org> Cc: Jani Nikula <jani.nik...@linux.intel.com> Cc: Mauro Carvalho Chehab <mche...@s-opensource.com> Signed-off

[PATCH 6/6] drm/doc: atomic overview, with graph

2017-03-02 Thread Daniel Vetter
Pinchart <laurent.pinch...@ideasonboard.com> Cc: Harry Wentland <harry.wentl...@amd.com> Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- Documentation/gpu/drm-kms-helpers.rst | 2 + Documentation/gpu/drm-kms.rst | 84 ++- 2 files chan

[PATCH] docs-rst: automatically convert Graphviz and SVG images

2017-03-02 Thread Daniel Vetter
ser <markus.hei...@darmarit.de> Tested-by: Laurent Pinchart <laurent.pinch...@ideasonboard.com> Signed-off-by: Markus Heiser <markus.hei...@darmarit.de> (v1) Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- Documentation/conf.py | 2 +- Documen

Re: [PATCH 2/6] docs-rst: automatically convert Graphviz and SVG images

2017-03-02 Thread Daniel Vetter
On Thu, Mar 2, 2017 at 4:22 PM, Jonathan Corbet <cor...@lwn.net> wrote: > On Thu, 2 Mar 2017 16:11:08 +0100 > Daniel Vetter <dan...@ffwll.ch> wrote: > >> I'll give it a shot at implementing it, but I can't (easily at least) test >> on sphinx 1.3. > > Virtuale

[PATCH 4/6] drm/doc: Consistent kerneldoc include order

2017-03-02 Thread Daniel Vetter
-section index, so include order didn't really matter. Acked-by: Eric Anholt <e...@anholt.net> Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- Documentation/gpu/drm-internals.rst | 6 +++--- Documentation/gpu/drm-kms-helpers.rst | 22 +++--- Documentation/gpu

[PATCH 2/6] docs-rst: automatically convert Graphviz and SVG images

2017-03-02 Thread Daniel Vetter
ernel.org Cc: Jani Nikula <jani.nik...@linux.intel.com> Cc: Mauro Carvalho Chehab <mche...@s-opensource.com> Cc: Markus Heiser <markus.hei...@darmarit.de> Cc: Laurent Pinchart <laurent.pinch...@ideasonboard.com> Signed-off-by: Markus Heiser <markus.hei...@darmarit.de> (v1) Signed-o

Re: [PATCH 3/6] drm/doc: Add KMS overview graphs

2017-03-02 Thread Daniel Vetter
On Thu, Mar 02, 2017 at 04:34:18PM +0200, Laurent Pinchart wrote: > Hi Daniel, > > Thank you for the patch. > > On Tuesday 28 Feb 2017 18:13:16 Daniel Vetter wrote: > > Oh, the shiny and pretties! > > > > Cc: Laurent Pinchart <laurent.pinch...@ideasonboard.c

Re: [PATCH 2/6] docs-rst: automatically convert Graphviz and SVG images

2017-03-02 Thread Daniel Vetter
ective.patches got introduced in Sphinx 1.4. If you want to bump the > minimum required version I think a notice is needed. Ugh. But this also goes completely over my head, no idea whether we must require sphinx 1.4 (it was released Mar 28, 2016), or whether there's some way to work around thi

Re: [PATCH 6/6] drm/doc: atomic overview, with graph

2017-03-02 Thread Daniel Vetter
On Wed, Mar 01, 2017 at 02:42:02PM -0300, Gabriel Krisman Bertazi wrote: > Daniel Vetter <dan...@ffwll.ch> writes: > > > I've spent quite some time trying to beat DOT into submission, this is the > > best I can do. The FIXME really is just a hint for someone with mor

[PATCH] drm/doc: atomic overview, with graph

2017-03-02 Thread Daniel Vetter
suggestion from Gabriel to fix the graph. Cc: Gabriel Krisman Bertazi <kris...@collabora.co.uk> Acked-by: Eric Anholt <e...@anholt.net> Cc: Eric Anholt <e...@anholt.net> Cc: Laurent Pinchart <laurent.pinch...@ideasonboard.com> Cc: Harry Wentland <harry.wentl...@amd.com>

Re: [PATCH 2/6] docs-rst: automatically convert Graphviz and SVG images

2017-03-02 Thread Daniel Vetter
On Wed, Mar 01, 2017 at 12:56:36PM -0300, Gabriel Krisman Bertazi wrote: > Daniel Vetter <daniel.vet...@ffwll.ch> writes: > > Hi Daniel, > > > +if dst_fname: > > +name = dst_fname[len(out_dir) + 1:] > > +# the builder needs not to cop

Re: [PATCH 6/6] drm/doc: atomic overview, with graph

2017-03-01 Thread Daniel Vetter
On Tue, Feb 28, 2017 at 03:48:47PM -0800, Eric Anholt wrote: > Daniel Vetter <daniel.vet...@ffwll.ch> writes: > > > I want to split up a few more things and document some details better > > (like how exactly to subclass drm_atomic_state). And maybe also split > >

[PATCH] drm/doc: diagram for mode objects and properties

2017-03-01 Thread Daniel Vetter
Resulted in confusion a few times in the past. v2: Spelling fix (Eric). Cc: Eric Anholt <e...@anholt.net> Acked-by: Eric Anholt <e...@anholt.net> Cc: Laurent Pinchart <laurent.pinch...@ideasonboard.com> Cc: Manasi Navare <manasi.d.nav...@intel.com> Signed-off-by: D

[PATCH] drm/doc: atomic overview, with graph

2017-03-01 Thread Daniel Vetter
y too wide for proper rendering. Ideas appreciated. v2: Spelling and clarifications (Eric). Cc: Eric Anholt <e...@anholt.net> Cc: Laurent Pinchart <laurent.pinch...@ideasonboard.com> Cc: Harry Wentland <harry.wentl...@amd.com> Signed-off-by: Daniel Vetter <daniel.vet...@intel.com&

[PATCH 3/6] drm/doc: Add KMS overview graphs

2017-02-28 Thread Daniel Vetter
Oh, the shiny and pretties! Cc: Laurent Pinchart <laurent.pinch...@ideasonboard.com> Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- Documentation/gpu/drm-kms-helpers.rst | 4 ++ Documentation/gpu/drm-kms.rst | 132 ++ 2 files

[PATCH 1/6] doc: Explain light-handed markup preference a bit better

2017-02-28 Thread Daniel Vetter
on for details. Cc: Jonathan Corbet <cor...@lwn.net> Cc: linux-doc@vger.kernel.org Cc: Christoph Hellwig <h...@infradead.org> Cc: Peter Zijlstra <pet...@infradead.org> Cc: Jani Nikula <jani.nik...@linux.intel.com> Cc: Mauro Carvalho Chehab <mche...@s-opensource.com> Signed-off

[PATCH 5/6] drm/doc: diagram for mode objects and properties

2017-02-28 Thread Daniel Vetter
Resulted in confusion a few times in the past. Cc: Laurent Pinchart <laurent.pinch...@ideasonboard.com> Cc: Manasi Navare <manasi.d.nav...@intel.com> Signed-off-by: Daniel Vetter <daniel.vet...@ffwll.ch> --- Documentation/gpu/drm-kms.rst | 22 ++ 1 file chan

[PATCH 4/6] drm/doc: Consistent kerneldoc include order

2017-02-28 Thread Daniel Vetter
-section index, so include order didn't really matter. Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- Documentation/gpu/drm-internals.rst | 6 +++--- Documentation/gpu/drm-kms-helpers.rst | 22 +++--- Documentation/gpu/drm-kms.rst

[PATCH 2/6] docs-rst: automatically convert Graphviz and SVG images

2017-02-28 Thread Daniel Vetter
le. Cc: Jonathan Corbet <cor...@lwn.net> Cc: linux-doc@vger.kernel.org Cc: Jani Nikula <jani.nik...@linux.intel.com> Cc: Mauro Carvalho Chehab <mche...@s-opensource.com> Signed-off-by: Markus Heiser <markus.hei...@darmarit.de> (v1) Signed-off-by: Daniel Vetter

[PATCH 6/6] drm/doc: atomic overview, with graph

2017-02-28 Thread Daniel Vetter
y too wide for proper rendering. Ideas appreciated. Cc: Laurent Pinchart <laurent.pinch...@ideasonboard.com> Cc: Harry Wentland <harry.wentl...@amd.com> Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- Documentation/gpu/drm-kms-helpers.rst | 2 + Documentation/

[PATCH 0/6] more kernel-doc patches

2017-02-28 Thread Daniel Vetter
landed, to unblock the DRM doc work - I orignally wrote these for 4.10. Cheers, Daniel Daniel Vetter (5): doc: Explain light-handed markup preference a bit better drm/doc: Add KMS overview graphs drm/doc: Consistent kerneldoc include order drm/doc: diagram for mode objects and properties

Re: [PATCH] drm/doc: Add TODO list

2017-02-07 Thread Daniel Vetter
.c`` > +and ``drm_platform.c``. The goal is to get rid of the driver's ``->load`` / > +``->unload`` callbacks and open-code the load/unload sequence properly, using > +the new two-stage ``drm_device`` setup/teardown. > + > +Once all existing drivers are converted we can als

Re: [RFC PATCH v1 2/6] kernel-doc: replace kernel-doc perl parser with a pure python one (WIP)

2017-01-25 Thread Daniel Vetter
o avoid breaking the world. But there's definitely better ways out there to write parsers than cobbling together regexes in a state machine that uses globals :-) -Daniel -- Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch -- To unsubscribe from this list: send the line "uns

Re: [RFC PATCH v1 3/6] kernel-doc: add kerneldoc-lint command

2017-01-24 Thread Daniel Vetter
--- > + > +fname = fname.relpath(CMD.srctree) > +opts = kerneldoc.ParseOptions( > +rel_fname = fname > +, src_tree = CMD.srctree > +, verbose_warn = not (CMD.slop

Re: [RFC PATCH v1 2/6] kernel-doc: replace kernel-doc perl parser with a pure python one (WIP)

2017-01-24 Thread Daniel Vetter
clear benefits. I think bug-for-bug compatibility would be much better. Later on we could do changes, on a change-by-change basis. -Daniel > - I'll have to try it out to see how noisy it is. I'm not opposed to >stricter checks; indeed, they could be a good thing. But we might want >

Re: [PATCH v2 7/7] uapi: export all headers under uapi directories

2017-01-09 Thread Daniel Vetter
nux/genwqe > linux/genwqe/.install > linux/genwqe/genwqe_card.h > linux/genwqe/..install.cmd > linux/seg6.h > linux/cifs > linux/cifs/.install > linux/cifs/cifs_mount.h > linux/cifs/..install.cmd > linux/auto_dev-ioctl.h > > Thanks to Julien Floret <julien.flo..

[PATCH 4/6] drm/doc: Consistent kerneldoc include order

2016-12-18 Thread Daniel Vetter
-section index, so include order didn't really matter. Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- Documentation/gpu/drm-internals.rst | 6 +++--- Documentation/gpu/drm-kms-helpers.rst | 22 +++--- Documentation/gpu/drm-kms.rst

[PATCH 0/6] diagrams for drm docs

2016-12-18 Thread Daniel Vetter
more work, but I'm probably not the best one to do that. I can take a stab at improving things a bit, but I think better if Jani/Jon/Markus help out here. Cheers, Daniel Daniel Vetter (5): HACKS: pass stderr along in kfigure.py drm/doc: Add KMS overview graphs drm/doc: Consistent kerneldoc

[PATCH 1/6] docs-rst: automatically convert Graphviz and SVG images

2016-12-18 Thread Daniel Vetter
nder embedded Scalable Vector Graphics (**SVG**) v2: s/DOC/DOT/ in a few places. Cc: Jonathan Corbet <cor...@lwn.net> Cc: linux-doc@vger.kernel.org Cc: Jani Nikula <jani.nik...@linux.intel.com> Cc: Mauro Carvalho Chehab <mche...@s-opensource.com> Signed-off-by: Markus Heiser <mar

Re: [RFC PATCH v3 1/1] docs-rst: automatically convert Graphviz and SVG images

2016-12-15 Thread Daniel Vetter
s' % (srclang, sha1(hashobj).hexdigest()) > +tmp_fname = path.join( > +self.builder.outdir, self.builder.imagedir, fname + tmp_ext) > + > +if not path.isfile(tmp_fname): > +mkdir(path.dirname(tmp_fname)) > +with open(tmp_fname, &q

[PATCH] doc: Explain light-handed markup preference a bit better

2016-12-14 Thread Daniel Vetter
on for details. Cc: Jonathan Corbet <cor...@lwn.net> Cc: linux-doc@vger.kernel.org Cc: Christoph Hellwig <h...@infradead.org> Cc: Peter Zijlstra <pet...@infradead.org> Cc: Jani Nikula <jani.nik...@linux.intel.com> Cc: Mauro Carvalho Chehab <mche...@s-opensource.com> Signed-off

Re: [PATCH] doc: Explain light-handed markup preference a bit better

2016-12-08 Thread Daniel Vetter
On Thu, Dec 8, 2016 at 10:10 AM, Mauro Carvalho Chehab <mche...@s-opensource.com> wrote: > Em Wed, 7 Dec 2016 12:39:24 -0700 > Jonathan Corbet <cor...@lwn.net> escreveu: > >> On Wed, 7 Dec 2016 16:42:58 +0100 >> Daniel Vetter <daniel.vet...@ffwll.ch> wrot

[PATCH] doc: Explain light-handed markup preference a bit better

2016-12-07 Thread Daniel Vetter
fradead.org> Cc: Jani Nikula <jani.nik...@linux.intel.com> Cc: Mauro Carvalho Chehab <mche...@s-opensource.com> Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- Documentation/kernel-documentation.rst | 28 ++-- 1 file changed, 26 inser

Re: [PATCH 0/2] Add maintainers to the admin guide

2016-12-07 Thread Daniel Vetter
re's some in-flight patches to document the new B: tag a bit better. Anyway: Reviewed-by: Daniel Vetter <daniel.vet...@ffwll.ch> > > > Mauro Carvalho Chehab (2): > MAINTAINERS: convert first part to ReST markup > MAINTAINERS: add it to the admin-guide > > Docume

Re: [PATCH] doc: Explain light-handed markup preference a bit better

2016-12-07 Thread Daniel Vetter
On Tue, Dec 06, 2016 at 08:52:41AM +0100, Peter Zijlstra wrote: > On Tue, Nov 29, 2016 at 02:17:52PM +0100, Daniel Vetter wrote: > > Hi Peter, > > > > On Tue, Nov 29, 2016 at 10:23:14AM +0100, Daniel Vetter wrote: > > > We already had a super-short blurb,

Re: [PATCH] doc: Explain light-handed markup preference a bit better

2016-12-07 Thread Daniel Vetter
all a concise and balanced expose, but happy to change if folks object. -Daniel -- Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org Mor

Re: [PATCH] doc: Explain light-handed markup preference a bit better

2016-11-29 Thread Daniel Vetter
Hi Peter, On Tue, Nov 29, 2016 at 10:23:14AM +0100, Daniel Vetter wrote: > We already had a super-short blurb, but worth extending it I think: > We're still pretty far away from anything like a consensus, but > there's clearly a lot of people who prefer an as-light as possible &

[PATCH] doc: Explain light-handed markup preference a bit better

2016-11-29 Thread Daniel Vetter
rvalho Chehab <mche...@s-opensource.com> Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- Documentation/kernel-documentation.rst | 44 -- 1 file changed, 42 insertions(+), 2 deletions(-) diff --git a/Documentation/kernel-documentation.rst b/Do

[PATCH] doc: Explain light-handed markup preference a bit better

2016-11-28 Thread Daniel Vetter
c: Mauro Carvalho Chehab <mche...@s-opensource.com> Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- Documentation/kernel-documentation.rst | 11 ++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/Documentation/kernel-documentation.rst b/Document

Re: [PATCH v3 2/4] Documentation/atomic_ops.txt: convert to ReST markup

2016-11-28 Thread Daniel Vetter
Hi Peter, On Mon, Nov 28, 2016 at 11:20:09AM +0100, Peter Zijlstra wrote: > On Mon, Nov 28, 2016 at 09:44:42AM +0100, Daniel Vetter wrote: > > > Why change them? What was wrong with txt to begin with? > > > > In my opinion good docs matter, and one of the key things is

Re: [PATCH v3 2/4] Documentation/atomic_ops.txt: convert to ReST markup

2016-11-28 Thread Daniel Vetter
upset people who want to follow to a C symbol with clashing naming), at least not by default. But if this desired we can make it happen. -Daniel -- Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [PATCH] docs-rst: add documentation about how to insert images

2016-11-28 Thread Daniel Vetter
On Wed, Nov 23, 2016 at 07:30:21AM -0200, Mauro Carvalho Chehab wrote: > Em Wed, 23 Nov 2016 08:34:11 +0100 > Daniel Vetter <dan...@ffwll.ch> escreveu: > > > On Mon, Nov 21, 2016 at 05:42:07PM -0200, Mauro Carvalho Chehab wrote: > > > Em Mon, 21 Nov 2016 17:03:55

Re: [PATCH] docs-rst: add documentation about how to insert images

2016-11-22 Thread Daniel Vetter
On Mon, Nov 21, 2016 at 05:42:07PM -0200, Mauro Carvalho Chehab wrote: > Em Mon, 21 Nov 2016 17:03:55 +0100 > Daniel Vetter <dan...@ffwll.ch> escreveu: > > > On Mon, Nov 21, 2016 at 08:53:17AM -0200, Mauro Carvalho Chehab wrote: > > > Inserting images with Sphinx

Re: [RFC PATCH] docs-rst: move the rules for svg and graphviz to Makefile.sphinx

2016-11-21 Thread Daniel Vetter
On Mon, Nov 21, 2016 at 08:51:55AM -0200, Mauro Carvalho Chehab wrote: > Em Mon, 21 Nov 2016 11:21:27 +0100 > Daniel Vetter <dan...@ffwll.ch> escreveu: > > > On Mon, Nov 21, 2016 at 07:48:50AM -0200, Mauro Carvalho Chehab wrote: > > > Not only media docum

Re: [PATCH] docs-rst: add documentation about how to insert images

2016-11-21 Thread Daniel Vetter
umentation > :maxdepth: 1 > > sphinx.rst > + images.rst > kernel-doc.rst > parse-headers.rst > docbook.rst > -- > 2.9.3 > > > -- > To unsubscribe from this list: send the line "unsubscribe linux-doc" in > the body of a message to majord...@vger.kernel.org > More majordomo info at http://vger.kernel.org/majordomo-info.html -- Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [RFC PATCH] docs-rst: move the rules for svg and graphviz to Makefile.sphinx

2016-11-21 Thread Daniel Vetter
ee)/Documentation/media > +UAPI = $(srctree)/include/uapi/linux > +KAPI = $(srctree)/include/linux > > FILES = audio.h.rst ca.h.rst dmx.h.rst frontend.h.rst net.h.rst video.h.rst \ > videodev2.h.rst media.h.rst cec.h.rst lirc.h.rst > @@ -96,16 +77,12 @@ $(BUILDDIR)/lirc.

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

2016-11-18 Thread Daniel Vetter
just read the source and users install rpms". It's totally true, until you try to change stuff, then you have to be able to build that pile fast and with an easily-obtained toolchain. -Daniel -- Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch -- To unsubscribe from this

[PATCH] doc: Document the new inline struct member kernel-doc style

2016-11-17 Thread Daniel Vetter
We don't just need better doc toolchains, we also need better docs for our doc toolchain! v2: Make sure we don't have foo twice (Jani). Cc: Daniel Vetter <dan...@ffwll.ch> Cc: Jani Nikula <jani.nik...@intel.com> Cc: Jonathan Corbet <cor...@lwn.net> Cc: linux-doc@vger.ker

[PATCH] doc: Document the new inline struct member kernel-doc style

2016-11-17 Thread Daniel Vetter
We don't just need better doc toolchains, we also need better docs for our doc toolchain! Cc: Daniel Vetter <dan...@ffwll.ch> Cc: Jani Nikula <jani.nik...@intel.com> Cc: Jonathan Corbet <cor...@lwn.net> Cc: linux-doc@vger.kernel.org Signed-off-by: Daniel Vetter <da

Re: [PATCH] Doc: update kselftest.txt with details on how to run tests after install

2016-11-08 Thread Daniel Vetter
> > Contributing new tests > == > -- > 2.9.3 > > -- > To unsubscribe from this list: send the line "unsubscribe linux-doc" in > the body of a message to majord...@vger.kernel.org > More majordomo info at http://vger.kernel.org/m

Re: Proposing help for documentation

2016-11-08 Thread Daniel Vetter
contribution howto in the kerneldocs itself? Would be even better if we'd put it as a colophon-thingy on every page (well, a link to the right section) to temp users/readers of our docs into contributing ... -Daniel -- Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

Re: [PATCH] Documentation/sphinx: set literal block highlight language to none

2016-11-08 Thread Daniel Vetter
and ack for merging the entire pile through the doc git tree. This shouldn't conflict with ongoing drm/gpu patches (I hope). -Daniel -- Daniel Vetter Software Engineer, Intel Corporation http://blog.ffwll.ch -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the b

Re: [PATCH 00/32] Create an User's manual and improve development-process book

2016-11-08 Thread Daniel Vetter
arameters.txt,Documentation/admin-guide/kernel-parameters.rst,g > $i >a && mv a $i; done' some_origin_branch.. Iirc Andrew uses quilt, so raw sed to change the filename in the diff metadata of patches should do the job. We maintain a similar quilt patch pile monstrosity for emba

Re: [PATCH] doc: add missing docbook parameter for fence-array

2016-10-23 Thread Daniel Vetter
+53,7 @@ extern const struct fence_ops fence_array_ops; > > /** > * fence_is_array - check if a fence is from the array subsclass > + * @fence: fence to test > * > * Return true if it is a fence_array and false otherwise. > */ > -- > 2.9.3 > -- Daniel Vetter Software Engineer, In

Re: [PATCH v11 2/4] drm: Add API for capturing frame CRCs

2016-10-17 Thread Daniel Vetter
t;), > + * to deal in the Software without restriction, including without limitation > + * the rights to use, copy, modify, merge, publish, distribute, sublicense, > + * and/or sell copies of the Software, and to permit persons to whom the > + * Software is furnished to do so, subject to the fol

Re: [PATCH v8 2/4] drm: Add API for capturing frame CRCs

2016-10-04 Thread Daniel Vetter
ad/unload hooks. That didn't mesh well with Tomeu's patches (and Tomeu's patches have been thrown out meanwhile because of that). Still would be neat if tegra could be demidlayered and loose it's load/unload hooks. See the kerneldoc in drm_drv.c (especially the DOC: section). -Daniel -- Daniel Vetter So

Re: [PATCH v2 2/5] firmware: annotate thou shalt not request fw on init or probe

2016-08-24 Thread Daniel Vetter
t; able to remove the usermode helper. > > [0] > https://lkml.kernel.org/r/1440811107-861-1-git-send-email-mcg...@do-not-panic.com > > Cc: Alessandro Rubini <rub...@gnudd.com> > Cc: Kevin Cernekee <cerne...@gmail.com> > Cc: Daniel Vetter <daniel.vet...@ffwll.

Re: [PATCH] drm/doc: Add a few words on validation with IGT

2016-08-23 Thread Daniel Vetter
On Tue, Aug 23, 2016 at 11:15:31AM +0200, Tomeu Vizoso wrote: > Also provide some pointers for building IGT as some kernel hackers might > not be that familiar with building stuff on Linux distros. > > Signed-off-by: Tomeu Vizoso <tomeu.viz...@collabora.com> > Cc: Dani

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

2016-08-17 Thread Daniel Vetter
of our kernel-doc directive. But really this was just an idea, atm it's a media exclusive feature of our doc toolchain. -Daniel -- Daniel Vetter Software Engineer, Intel Corporation +41 (0) 79 365 57 48 - http://blog.ffwll.ch -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

[PATCH 20/21] vgaarbiter: rst-ifiy and polish kerneldoc

2016-08-12 Thread Daniel Vetter
why the new vgaarbiter.rst sometimes drops out of the sidebar index. v3: Drop one level of headings and clarify the vgaarb one a bit. v4: Fix some typos (Sean). Cc: Jonathan Corbet <cor...@lwn.net> Cc: linux-doc@vger.kernel.org Cc: Sean Paul <seanp...@chromium.org> Signed-off-by: D

[PATCH 01/21] drm/doc: Fix more kerneldoc/sphinx warnings

2016-08-12 Thread Daniel Vetter
c: linux-doc@vger.kernel.org Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- drivers/gpu/drm/drm_crtc.c | 4 ++-- drivers/gpu/drm/drm_fb_helper.c | 2 +- drivers/gpu/drm/drm_irq.c | 8 +++ drivers/gpu/drm/drm_simple_kms_helper.c | 2 +- dr

Re: [RFC 2/4] dma-buf/fence: kerneldoc: remove spurious section header

2016-08-12 Thread Daniel Vetter
a4 ("fence: dma-buf cross-device synchronization (v18)") > > Signed-off-by: Sumit Semwal <sumit.sem...@linaro.org> On patches 1&2 Reviewed-by: Daniel Vetter <daniel.vet...@ffwll.ch> > --- > include/linux/fence.h | 2 +- > 1 file changed, 1 insertion(+

Re: [RFC 0/4] doc: dma-buf: sphinx conversion and cleanup

2016-08-12 Thread Daniel Vetter
xtracting dma-buf stuff (dma_buf, fence, reservation and all that) is ok though, it is a fairly stand-alone topic. -Daniel > > > Does that make sense? > > > I do hope that my proposal above finds some merit with everyone. > > > Thanks, > > > > jon > > BR

[PATCH] vgaarbiter: rst-ifiy and polish kerneldoc

2016-08-09 Thread Daniel Vetter
why the new vgaarbiter.rst sometimes drops out of the sidebar index. v3: Drop one level of headings and clarify the vgaarb one a bit. Cc: Jonathan Corbet <cor...@lwn.net> Cc: linux-doc@vger.kernel.org Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- Documentation/g

[PATCH 01/20] drm/doc: Fix more kerneldoc/sphinx warnings

2016-08-09 Thread Daniel Vetter
c: linux-doc@vger.kernel.org Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- drivers/gpu/drm/drm_crtc.c | 4 ++-- drivers/gpu/drm/drm_fb_helper.c | 2 +- drivers/gpu/drm/drm_irq.c | 8 +++ drivers/gpu/drm/drm_simple_kms_helper.c | 2 +- dr

[PATCH 00/20] more drm doc work

2016-08-09 Thread Daniel Vetter
ux-doc@vger.kernel.org Daniel Vetter (20): drm/doc: Fix more kerneldoc/sphinx warnings drm/doc: Light drm-kms-helper.rst cleanup drm/kms-helpers: Extract drm_modeset_helper.[hc] drm/doc: Reorg drm-mm.rst drm/doc: Reorg for drm-kms.rst drm/etnaviv: Don't set drm_device->platformdev drm/hisilic

Re: [PATCH 03/10] docs: sphinxify sparse.txt and move to dev-tools

2016-08-09 Thread Daniel Vetter
Old hats like us don't need that, but it definitely has value in bringing new folks on board. And yes I want that, at least for everything that's at least half-relevant to drm/gpu/i915 topics. And given that we just started on a large-scale effort to roll out rcu in our driver (besides all t

Re: [PATCH v3 2/3] drm: Add API for capturing frame CRCs

2016-08-03 Thread Daniel Vetter
arguments, as > > +* provided from the configured source. Drivers should accept a "auto" > > +* source name that will select a default source for this CRTC. > > +* > > +* This callback is optional if the driver does not support any CRC > &

Re: [PATCH 1/2] doc/sphinx: Enable keep_warnings

2016-07-20 Thread Daniel Vetter
On Wed, Jul 20, 2016 at 12:55 PM, Markus Heiser <markus.hei...@darmarit.de> wrote: > Hi Daniel, hi Mauro, > > Am 19.07.2016 um 17:32 schrieb Daniel Vetter <daniel.vet...@ffwll.ch>: > >> On Tue, Jul 19, 2016 at 5:25 PM, Daniel Vetter <daniel.vet...@ffwll.ch> >

[PATCH] docs: Remove kernel-doc-nano-HOWTO.txt

2016-07-20 Thread Daniel Vetter
oc Cc: Jani Nikula <jani.nik...@intel.com> Cc: Jonathan Corbet <cor...@lwn.net> Cc: linux-doc@vger.kernel.org Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- Documentation/kernel-doc-nano-HOWTO.txt | 362 1 file changed, 362 deletion

Re: [PATCH 1/2] doc/sphinx: Enable keep_warnings

2016-07-19 Thread Daniel Vetter
On Tue, Jul 19, 2016 at 5:25 PM, Daniel Vetter <daniel.vet...@ffwll.ch> wrote: > On Tue, Jul 19, 2016 at 4:59 PM, Markus Heiser > <markus.hei...@darmarit.de> wrote: >> >> Am 19.07.2016 um 13:42 schrieb Daniel Vetter <daniel.vet...@ffwll.ch>: >> >>

[PATCH 2/2] drm/doc: Fix more kerneldoc/sphinx warnings

2016-07-19 Thread Daniel Vetter
c: linux-doc@vger.kernel.org Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- drivers/gpu/drm/drm_crtc.c | 4 ++-- drivers/gpu/drm/drm_fb_helper.c | 2 +- drivers/gpu/drm/drm_irq.c | 8 +++ drivers/gpu/drm/drm_simple_kms_helper.c | 2 +- dr

[PATCH] kernel-doc: Fix up warning output

2016-07-15 Thread Daniel Vetter
g Signed-off-by: Daniel Vetter <daniel.vet...@intel.com> --- scripts/kernel-doc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/scripts/kernel-doc b/scripts/kernel-doc index 27757c21551a..e067cfb59321 100755 --- a/scripts/kernel-doc +++ b/scripts/kernel-doc @@ -2969,7 +2969,7 @

Re: [PATCH v5 00/44] dma-mapping: Use unsigned long for dma_attrs

2016-07-12 Thread Daniel Vetter
uld be squashed together when > applying. For all the drm driver patches: Acked-by: Daniel Vetter <daniel.vet...@ffwll.ch> Should I pull these in through drm-misc, or do you prefer to merge them through a special topic branch (with everything else) instead on your own? -Daniel > >

  1   2   >