gpu/doc: Convert to markdown harder

l1k · danvet · commit f71a6d609578 · 2015-10-16T15:50:59.000+02:00
This snippet...

    * Lock VMA manager for extended lookups. Only *_locked() VMA function calls
    * are allowed while holding this lock. All other contexts are blocked from VMA
    * until the lock is released via drm_vma_offset_unlock_lookup().

...causes markdown-enabled kernel-doc to barf:

    debian/build/build-doc/Documentation/DocBook/gpu.aux.xml:3247: parser error : Opening and ending tag mismatch: emphasis line 3247 and function
       *&lt;function&gt;&lt;emphasis&gt;locked&lt;/function&gt; VMA function calls are allowed while
                                             ^
    /root/airlied/debian/build/build-doc/Documentation/DocBook/gpu.aux.xml:3249: parser error : Opening and ending tag mismatch: function line 3249 and emphasis
       released via &lt;function&gt;drm&lt;/emphasis&gt;vma_offset_unlock_lookup&lt;/function&gt;.
                                            ^
    unable to parse /root/airlied/debian/build/build-doc/Documentation/DocBook/gpu.aux.xml

A quick workaround is to replace *_locked() by X_locked().

Cc: Danilo Cesar Lemes de Paula &lt;danilo.cesar@collabora.co.uk&gt;
Signed-off-by: Lukas Wunner &lt;lukas@wunner.de&gt;
[danvet: Just drop the X_ too, the usual style is _unlocked, except
that _ seems to be what annoys markdown.]
Signed-off-by: Daniel Vetter &lt;daniel.vetter@ffwll.ch&gt;
diff --git a/include/drm/drm_vma_manager.h b/include/drm/drm_vma_manager.h
@@ -97,7 +97,7 @@ drm_vma_offset_exact_lookup(struct drm_vma_offset_manager *mgr,
  * drm_vma_offset_lock_lookup() - Lock lookup for extended private use
  * @mgr: Manager object
  *
- * Lock VMA manager for extended lookups. Only *_locked() VMA function calls
+ * Lock VMA manager for extended lookups. Only locked VMA function calls
  * are allowed while holding this lock. All other contexts are blocked from VMA
  * until the lock is released via drm_vma_offset_unlock_lookup().
  *

Original file line number	Diff line number	Diff line change
`@@ -97,7 +97,7 @@ drm_vma_offset_exact_lookup(struct drm_vma_offset_manager *mgr,`
`97`	`97`	`* drm_vma_offset_lock_lookup() - Lock lookup for extended private use`
`98`	`98`	`* @mgr: Manager object`
`99`	`99`	`*`
`100`		`- * Lock VMA manager for extended lookups. Only *_locked() VMA function calls`
	`100`	`+ * Lock VMA manager for extended lookups. Only locked VMA function calls`
`101`	`101`	`* are allowed while holding this lock. All other contexts are blocked from VMA`
`102`	`102`	`* until the lock is released via drm_vma_offset_unlock_lookup().`
`103`	`103`	`*`