[PATCH v1 00/14] uAPI Alignment - Documentation

Francois Dugast francois.dugast at intel.com
Thu Dec 7 13:49:55 UTC 2023


This series is an attempt to improve the documentation in xe_drm.h in order
to make its use easier by user space. The structure of the file is made
explicit, the same rules are applied everywhere, the generated kernel doc
is more complete. The series addresses some comments made by Oded:
https://lists.freedesktop.org/archives/intel-xe/2023-May/004704.html

There is no functional change.

Francois Dugast (11):
  drm/xe/uapi: Add a comment to each struct
  drm/xe/uapi: Add missing documentation for struct members
  drm/xe/uapi: Document use of size in drm_xe_device_query
  drm/xe/uapi: Document drm_xe_query_config keys
  drm/xe/uapi: Document DRM_XE_DEVICE_QUERY_HWCONFIG
  drm/xe/uapi: Make constant comments visible in kernel doc
  drm/xe/uapi: Replace BO with GEM in documentation
  drm/xe/uapi: Add block diagram of a device
  drm/xe/uapi: Add examples of user space code
  drm/xe/uapi: Move CPU_CACHING defines before doc
  drm/xe/uapi: Move DRM_XE_ACC_GRANULARITY_* where they are used

Rodrigo Vivi (3):
  drm/xe/uapi: Order sections
  drm/xe/uapi: More uAPI documentation additions and cosmetic updates
  drm/xe/uapi: Document the memory_region bitmask

 drivers/gpu/drm/xe/xe_query.c |  19 +
 include/uapi/drm/xe_drm.h     | 758 +++++++++++++++++++++++-----------
 2 files changed, 544 insertions(+), 233 deletions(-)

-- 
2.34.1



More information about the Intel-xe mailing list