Building pdfdocs shows errors with !includes and <sect>s such as: jade:/Documentation/DocBook/drm.xml:666:11:E: document type does not allow element "para" here; missing one of "glossary", "bibliography", "index" start-tag Fix by adding <title> items and add/shuffle <sect>, <title> and !include items.
Signed-off-by: Graham Whaley graham.whaley@linux.intel.com --- Documentation/DocBook/drm.tmpl | 32 ++++++++++++++++++++++---------- 1 file changed, 22 insertions(+), 10 deletions(-)
diff --git a/Documentation/DocBook/drm.tmpl b/Documentation/DocBook/drm.tmpl index 66bc646..586f1b8 100644 --- a/Documentation/DocBook/drm.tmpl +++ b/Documentation/DocBook/drm.tmpl @@ -303,6 +303,9 @@ char *date;</synopsis> </para> !Edrivers/gpu/drm/drm_pci.c !Edrivers/gpu/drm/drm_platform.c + </sect2> + <sect2> + <title>Calling Registration Directly</title> <para> New drivers that no longer rely on the services provided by the <structname>drm_bus</structname> structure can call the low-level @@ -2352,7 +2355,7 @@ void intel_crt_init(struct drm_device *dev) </itemizedlist> </sect2> <sect2> - <title>Atomic Modeset Helper Functions Reference</title> + <title>Atomic Modeset Helper Functions Introduction</title> <sect3> <title>Overview</title> !Pdrivers/gpu/drm/drm_atomic_helper.c overview @@ -2365,14 +2368,20 @@ void intel_crt_init(struct drm_device *dev) <title>Atomic State Reset and Initialization</title> !Pdrivers/gpu/drm/drm_atomic_helper.c atomic state reset and initialization </sect3> + </sect2> + <sect2> + <title>Atomic Modeset Helper Functions Reference</title> !Iinclude/drm/drm_atomic_helper.h !Edrivers/gpu/drm/drm_atomic_helper.c </sect2> <sect2> + <title>Modeset Helper Functions Introduction</title> +!Pdrivers/gpu/drm/drm_crtc_helper.c overview + </sect2> + <sect2> <title>Modeset Helper Functions Reference</title> !Iinclude/drm/drm_crtc_helper.h !Edrivers/gpu/drm/drm_crtc_helper.c -!Pdrivers/gpu/drm/drm_crtc_helper.c overview </sect2> <sect2> <title>Output Probing Helper Functions Reference</title> @@ -2432,8 +2441,8 @@ void intel_crt_init(struct drm_device *dev) </sect2> <sect2> <title id="drm-kms-planehelpers">Plane Helper Reference</title> -!Edrivers/gpu/drm/drm_plane_helper.c !Pdrivers/gpu/drm/drm_plane_helper.c overview +!Edrivers/gpu/drm/drm_plane_helper.c </sect2> <sect2> <title>Tile group</title> @@ -2449,6 +2458,9 @@ void intel_crt_init(struct drm_device *dev) <title>Default bridge callback sequence</title> !Pdrivers/gpu/drm/drm_bridge.c bridge callbacks </sect3> + </sect2> + <sect2> + <title>Bridges Function Reference</title> !Edrivers/gpu/drm/drm_bridge.c </sect2> </sect1> @@ -4114,19 +4126,19 @@ int num_ioctls;</synopsis> <sect2> <title>GTT Fences and Swizzling</title> !Idrivers/gpu/drm/i915/i915_gem_fence.c - <sect3> - <title>Global GTT Fence Handling</title> + </sect2> + <sect2> + <title>Global GTT Fence Handling</title> !Pdrivers/gpu/drm/i915/i915_gem_fence.c fence register handling - </sect3> - <sect3> - <title>Hardware Tiling and Swizzling Details</title> + </sect2> + <sect2> + <title>Hardware Tiling and Swizzling Details</title> !Pdrivers/gpu/drm/i915/i915_gem_fence.c tiling swizzling details - </sect3> </sect2> <sect2> <title>Object Tiling IOCTLs</title> -!Idrivers/gpu/drm/i915/i915_gem_tiling.c !Pdrivers/gpu/drm/i915/i915_gem_tiling.c buffer object tiling +!Idrivers/gpu/drm/i915/i915_gem_tiling.c </sect2> <sect2> <title>Buffer Object Eviction</title>