Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit a9eaa996 authored by Daniel Vetter's avatar Daniel Vetter
Browse files

drm/doc: Spinx leftovers 



This is unfortunately not all the sphinx noise when building the gpu
documentations. But the remaining warnings have completely bogus line
and probably also file sources, and I just can't find them.

Probably some serious debuggging of the line annotations in the
sphinx/kernel-doc toolchain needed first.

Acked-by: default avatarChris Wilson <chris@chris-wilson.co.uk>
Signed-off-by: default avatarDaniel Vetter <daniel.vetter@intel.com>
Link: http://patchwork.freedesktop.org/patch/msgid/1468612088-9721-11-git-send-email-daniel.vetter@ffwll.ch
parent 132d49d7

Documentation/gpu/drm-internals.rst

+9 −6
Original line number Diff line number Diff line
@@ -188,7 +188,8 @@ Manual IRQ Registration 
Drivers that require multiple interrupt handlers can't use the managed

IRQ registration functions. In that case IRQs must be registered and

unregistered manually (usually with the :c:func:`request_irq()` and

:c:func:`free_irq()` functions, or their devm_\* equivalent).

:c:func:`free_irq()` functions, or their :c:func:`devm_request_irq()` and

:c:func:`devm_free_irq()` equivalents).



When manually registering IRQs, drivers must not set the

DRIVER_HAVE_IRQ driver feature flag, and must not provide the
@@ -242,11 +243,13 @@ Open/Close, File Operations and IOCTLs 
Open and Close

--------------



int (\*firstopen) (struct drm_device \*); void (\*lastclose) (struct

drm_device \*); int (\*open) (struct drm_device \*, struct drm_file

\*); void (\*preclose) (struct drm_device \*, struct drm_file \*);

void (\*postclose) (struct drm_device \*, struct drm_file \*);

    Open and close handlers. None of those methods are mandatory.

Open and close handlers. None of those methods are mandatory::



    int (*firstopen) (struct drm_device *);

    void (*lastclose) (struct drm_device *);

    int (*open) (struct drm_device *, struct drm_file *);

    void (*preclose) (struct drm_device *, struct drm_file *);

    void (*postclose) (struct drm_device *, struct drm_file *);



The firstopen method is called by the DRM core for legacy UMS (User Mode

Setting) drivers only when an application opens a device that has no