[Intel-gfx] [PATCH v3 0/6] Documentation patch for batchbuffer submission

[kevin.rogovin at intel.com]

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

Note: I want to make a one or two follow-up series that provide
narration and potentially additional documentation for GUC submission
and the breadcrumbs.

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 (6):
  i915.rst: Narration overview on GEM + minor reorder to improve
    narration
  i915.rst: rename section Batchbuffer Parsing to Command Buffer Parsing
  i915: add documentation of what happens at the bottom of submitting a
    batchbuffer
  i915: add documentation for a bit on batchbuffer submission backend
  i915: add doc for synchronization
  i915.rst: narration for batchbuffer submission + links to source code
    doc entries on the subject

 Documentation/gpu/i915.rst              | 189 ++++++++++++++++++++++++++------
 drivers/gpu/drm/i915/i915_request.h     |  28 +++++
 drivers/gpu/drm/i915/i915_vma.h         |  10 +-
 drivers/gpu/drm/i915/intel_ringbuffer.h |  71 ++++++++++++
 4 files changed, 262 insertions(+), 36 deletions(-)

-- 
2.16.2