[Intel-gfx] [PATCH v5 0/3] Documentation patch for batchbuffer submission

[kevin.rogovin at intel.com]

From: Kevin Rogovin <kevin.rogovin at intel.com>

v5:
   In interest of getting reviewed patches in sonner, last two patches
   dropped for a later series.

   Permute patch order of 2 and 3 (this is what the v4 series should
   have had).

v4:
   Drop some details from narration to provide better focus.
   (suggested/requested by Chris Wilson)

   Spelling and grammar fixes.
   (errors caught by Tvrtko Ursuli)

   Move "at the bottom" details to part of documentation in
   i915_gem_execbuffer.c.
   (suggested by Chris Wilson)

   Place additional documentation of intel_engine_cs function
   pointers to inlined in struct.

   Fix documentation error about lazy creation of intel_ringbuffer
   and backing store in intel_lrc.c.
   (Caught by Chris Wilson)

v3:
   More documentation: emphasize that handling of batchbuffer
   requests creates a request struct that is added to the
   dependency tree and that the inform to the hardware that
   there is new data on a ringbuffer is deferred until dependencies
   are satsified.

   Break patch into more digestable chunks.  

v2:
   More documentation: intel_ringbuffer, sequence number.
   Expose to i915.rst existing documentation

   Call out GEM_EXECBUFFER as deprecated.
   Place code detailed documentation in source files.
   Call out INTEL_EXEC_RENDER.
   Reorder text to make it more readable.
   Refer to Command Buffer Parser instead of Batchbuffer Parser.
   (suggested by Joonas Lahtinen)

Kevin Rogovin (3):
  i915.rst: Narration overview on GEM + minor reorder to improve
    narration
  i915.rst: add link to documentation in i915_gem_execbuffer.c
  i915: add a text about what happens at bottom of stack in processing a
    batchbuffer

 Documentation/gpu/i915.rst                 | 126 +++++++++++++++++++++++------
 drivers/gpu/drm/i915/i915_gem_execbuffer.c |  29 +++++++
 2 files changed, 132 insertions(+), 23 deletions(-)

-- 
2.16.2