Commit 76bce773 authored by Paul Kocialkowski's avatar Paul Kocialkowski Committed by Arkadiusz Hiler

docs: Update documentation generation with missing entries

This adds missing entries for documentation generation, both for tests
and the API reference.

The list of tests is made complete and ordered alphabetically, with
modified descriptions for consistency.

More files are added to the API reference, with a minimalistic
description block added to them when it was missing.
Signed-off-by: 's avatarPaul Kocialkowski <paul.kocialkowski@linux.intel.com>
Reviewed-by: Arkadiusz Hiler's avatarArkadiusz Hiler <arkadiusz.hiler@intel.com>
parent 9f49776f
......@@ -134,7 +134,11 @@ IGNORE_HFILES=gen6_render.h gen7_media.h gen7_render.h gen8_media.h \
# e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png
HTML_IMAGES=
test_program_files = xml/igt_test_programs_core_description.xml \
test_program_files = xml/igt_test_programs_amdgpu_description.xml \
xml/igt_test_programs_amdgpu_programs.xml \
xml/igt_test_programs_chamelium_description.xml \
xml/igt_test_programs_chamelium_programs.xml \
xml/igt_test_programs_core_description.xml \
xml/igt_test_programs_core_programs.xml \
xml/igt_test_programs_debugfs_description.xml \
xml/igt_test_programs_debugfs_programs.xml \
......@@ -146,14 +150,28 @@ test_program_files = xml/igt_test_programs_core_description.xml \
xml/igt_test_programs_gem_programs.xml \
xml/igt_test_programs_gen3_description.xml \
xml/igt_test_programs_gen3_programs.xml \
xml/igt_test_programs_gen7_description.xml \
xml/igt_test_programs_gen7_programs.xml \
xml/igt_test_programs_gvt_description.xml \
xml/igt_test_programs_gvt_programs.xml \
xml/igt_test_programs_kms_description.xml \
xml/igt_test_programs_kms_programs.xml \
xml/igt_test_programs_meta_description.xml \
xml/igt_test_programs_meta_programs.xml \
xml/igt_test_programs_perf_description.xml \
xml/igt_test_programs_perf_programs.xml \
xml/igt_test_programs_pm_description.xml \
xml/igt_test_programs_pm_programs.xml \
xml/igt_test_programs_prime_description.xml \
xml/igt_test_programs_prime_programs.xml \
xml/igt_test_programs_sysfs_description.xml \
xml/igt_test_programs_sysfs_programs.xml \
xml/igt_test_programs_sw_sync_description.xml \
xml/igt_test_programs_sw_sync_programs.xml \
xml/igt_test_programs_testdisplay_description.xml \
xml/igt_test_programs_testdisplay_programs.xml \
xml/igt_test_programs_tools_description.xml \
xml/igt_test_programs_tools_programs.xml \
xml/igt_test_programs_vgem_description.xml \
xml/igt_test_programs_vgem_programs.xml \
$(NULL)
# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
......
......@@ -100,19 +100,46 @@
</refsect1>
</refentry>
<refentry id="igt-amdgpu-tests">
<refnamediv>
<refname>AMDGPU Tests</refname>
<refpurpose>Tests for amdgpu driver behaviour</refpurpose>
</refnamediv>
<xi:include href="igt_test_programs_amdgpu_programs.xml"/>
<xi:include href="igt_test_programs_amdgpu_description.xml"/>
</refentry>
<refentry id="igt-chamelium-tests">
<refnamediv>
<refname>Chamelium Tests</refname>
<refpurpose>Tests using the Chamelium platform</refpurpose>
</refnamediv>
<xi:include href="igt_test_programs_chamelium_programs.xml"/>
<xi:include href="igt_test_programs_chamelium_description.xml"/>
</refentry>
<refentry id="igt-core-tests">
<refnamediv>
<refname>Core Tests</refname>
<refpurpose>Tests for core drm ioctls and behaviour.</refpurpose>
<refpurpose>Tests for core drm ioctls and behaviour</refpurpose>
</refnamediv>
<xi:include href="igt_test_programs_core_programs.xml"/>
<xi:include href="igt_test_programs_core_description.xml"/>
</refentry>
<refentry id="igt-debugfs-tests">
<refnamediv>
<refname>Debugfs Tests</refname>
<refpurpose>Tests for debugfs behaviour</refpurpose>
</refnamediv>
<xi:include href="igt_test_programs_debugfs_programs.xml"/>
<xi:include href="igt_test_programs_debugfs_description.xml"/>
</refentry>
<refentry id="igt-drm-tests">
<refnamediv>
<refname>DRM Tests</refname>
<refpurpose>Tests for libdrm behaviour.</refpurpose>
<refpurpose>Tests for libdrm behaviour</refpurpose>
</refnamediv>
<xi:include href="igt_test_programs_drm_programs.xml"/>
<xi:include href="igt_test_programs_drm_description.xml"/>
......@@ -121,7 +148,7 @@
<refentry id="igt-drv-tests">
<refnamediv>
<refname>DRV Tests</refname>
<refpurpose>Tests for overall driver behaviour.</refpurpose>
<refpurpose>Tests for overall driver behaviour</refpurpose>
</refnamediv>
<xi:include href="igt_test_programs_drv_programs.xml"/>
<xi:include href="igt_test_programs_drv_description.xml"/>
......@@ -130,21 +157,66 @@
<refentry id="igt-gem-tests">
<refnamediv>
<refname>GEM Tests</refname>
<refpurpose>Tests for core drm ioctls and behaviour.</refpurpose>
<refpurpose>Tests for the graphics execution manager</refpurpose>
</refnamediv>
<xi:include href="igt_test_programs_gem_programs.xml"/>
<xi:include href="igt_test_programs_gem_description.xml"/>
</refentry>
<refentry id="igt-gen3-tests">
<refnamediv>
<refname>Gen 3 Tests</refname>
<refpurpose>Tests specific to gen 3</refpurpose>
</refnamediv>
<xi:include href="igt_test_programs_gen3_programs.xml"/>
<xi:include href="igt_test_programs_gen3_description.xml"/>
</refentry>
<refentry id="igt-gen7-tests">
<refnamediv>
<refname>Gen 7 Tests</refname>
<refpurpose>Tests specific to gen 7</refpurpose>
</refnamediv>
<xi:include href="igt_test_programs_gen7_programs.xml"/>
<xi:include href="igt_test_programs_gen7_description.xml"/>
</refentry>
<refentry id="igt-gvt-tests">
<refnamediv>
<refname>GVT Tests</refname>
<refpurpose>Tests for graphics virtualization technology</refpurpose>
</refnamediv>
<xi:include href="igt_test_programs_gvt_programs.xml"/>
<xi:include href="igt_test_programs_gvt_description.xml"/>
</refentry>
<refentry id="igt-kms-tests">
<refnamediv>
<refname>KMS Tests</refname>
<refpurpose>Mode setting tests</refpurpose>
<refpurpose>Tests for kernel mode setting</refpurpose>
</refnamediv>
<xi:include href="igt_test_programs_kms_programs.xml"/>
<xi:include href="igt_test_programs_kms_description.xml"/>
</refentry>
<refentry id="igt-meta-tests">
<refnamediv>
<refname>Meta Tests</refname>
<refpurpose>Tests for the CI system itself</refpurpose>
</refnamediv>
<xi:include href="igt_test_programs_meta_programs.xml"/>
<xi:include href="igt_test_programs_meta_description.xml"/>
</refentry>
<refentry id="igt-perf-tests">
<refnamediv>
<refname>Perf Tests</refname>
<refpurpose>Tests for the performance metrics</refpurpose>
</refnamediv>
<xi:include href="igt_test_programs_perf_programs.xml"/>
<xi:include href="igt_test_programs_perf_description.xml"/>
</refentry>
<refentry id="igt-pm-tests">
<refnamediv>
<refname>PM Tests</refname>
......@@ -157,37 +229,46 @@
<refentry id="igt-prime-tests">
<refnamediv>
<refname>Prime Tests</refname>
<refpurpose>Buffer sharing tests</refpurpose>
<refpurpose>Tests for buffer sharding</refpurpose>
</refnamediv>
<xi:include href="igt_test_programs_prime_programs.xml"/>
<xi:include href="igt_test_programs_prime_description.xml"/>
</refentry>
<refentry id="igt-gen3-tests">
<refentry id="igt-sw-sync-tests">
<refnamediv>
<refname>Gen 3 Tests</refname>
<refpurpose>Gen 3 specific tests</refpurpose>
<refname>SW Sync Tests</refname>
<refpurpose>Tests for software sync (fencing)</refpurpose>
</refnamediv>
<xi:include href="igt_test_programs_gen3_programs.xml"/>
<xi:include href="igt_test_programs_gen3_description.xml"/>
<xi:include href="igt_test_programs_sw_sync_programs.xml"/>
<xi:include href="igt_test_programs_sw_sync_description.xml"/>
</refentry>
<refentry id="igt-sysfs-tests">
<refentry id="igt-testdisplay-tests">
<refnamediv>
<refname>Sysfs Tests</refname>
<refpurpose>Sysfs tests</refpurpose>
<refname>Display Tests</refname>
<refpurpose>Tests for display validation</refpurpose>
</refnamediv>
<xi:include href="igt_test_programs_sysfs_programs.xml"/>
<xi:include href="igt_test_programs_sysfs_description.xml"/>
<xi:include href="igt_test_programs_testdisplay_programs.xml"/>
<xi:include href="igt_test_programs_testdisplay_description.xml"/>
</refentry>
<refentry id="igt-debugfs-tests">
<refentry id="igt-tools-tests">
<refnamediv>
<refname>Debugfs Tests</refname>
<refpurpose>Debugfs tests</refpurpose>
<refname>Tools Tests</refname>
<refpurpose>Tests for IGT tools behaviour</refpurpose>
</refnamediv>
<xi:include href="igt_test_programs_debugfs_programs.xml"/>
<xi:include href="igt_test_programs_debugfs_description.xml"/>
<xi:include href="igt_test_programs_tools_programs.xml"/>
<xi:include href="igt_test_programs_tools_description.xml"/>
</refentry>
<refentry id="igt-vgem-tests">
<refnamediv>
<refname>vGEM Tests</refname>
<refpurpose>Tests for the vitual graphics execution manager</refpurpose>
</refnamediv>
<xi:include href="igt_test_programs_vgem_programs.xml"/>
<xi:include href="igt_test_programs_vgem_description.xml"/>
</refentry>
<glossary>
......
......@@ -16,25 +16,31 @@
<chapter>
<title>API Reference</title>
<xi:include href="xml/drmtest.xml"/>
<xi:include href="xml/igt_aux.xml"/>
<xi:include href="xml/igt_chamelium.xml"/>
<xi:include href="xml/igt_core.xml"/>
<xi:include href="xml/igt_stats.xml"/>
<xi:include href="xml/igt_debugfs.xml"/>
<xi:include href="xml/igt_sysfs.xml"/>
<xi:include href="xml/igt_draw.xml"/>
<xi:include href="xml/igt_kms.xml"/>
<xi:include href="xml/igt_kmod.xml"/>
<xi:include href="xml/igt_dummyload.xml"/>
<xi:include href="xml/igt_fb.xml"/>
<xi:include href="xml/igt_aux.xml"/>
<xi:include href="xml/igt_frame.xml"/>
<xi:include href="xml/igt_gt.xml"/>
<xi:include href="xml/igt_gvt.xml"/>
<xi:include href="xml/igt_kmod.xml"/>
<xi:include href="xml/igt_kms.xml"/>
<xi:include href="xml/igt_pm.xml"/>
<xi:include href="xml/ioctl_wrappers.xml"/>
<xi:include href="xml/igt_primes.xml"/>
<xi:include href="xml/igt_rand.xml"/>
<xi:include href="xml/igt_stats.xml"/>
<xi:include href="xml/igt_sysfs.xml"/>
<xi:include href="xml/igt_vc4.xml"/>
<xi:include href="xml/igt_vgem.xml"/>
<xi:include href="xml/igt_x86.xml"/>
<xi:include href="xml/intel_batchbuffer.xml"/>
<xi:include href="xml/intel_chipset.xml"/>
<xi:include href="xml/intel_io.xml"/>
<xi:include href="xml/igt_vc4.xml"/>
<xi:include href="xml/igt_vgem.xml"/>
<xi:include href="xml/igt_dummyload.xml"/>
<xi:include href="xml/igt_chamelium.xml"/>
<xi:include href="xml/ioctl_wrappers.xml"/>
<xi:include href="xml/sw_sync.xml"/>
</chapter>
<xi:include href="xml/igt_test_programs.xml"/>
......
......@@ -31,6 +31,13 @@
#include <unistd.h>
#include <fcntl.h>
/**
* SECTION:igt_gvt
* @short_description: Graphics virtualization technology library
* @title: GVT
* @include: igt_gvt.h
*/
static bool is_gvt_enabled(void)
{
bool enabled = false;
......
......@@ -28,6 +28,13 @@
#include <string.h>
#include <math.h>
/**
* SECTION:igt_primes
* @short_description: Prime numbers helper library
* @title: Primes
* @include: igt_primes.h
*/
#define BITS_PER_CHAR 8
#define BITS_PER_LONG (sizeof(long)*BITS_PER_CHAR)
......
#include "igt_rand.h"
/**
* SECTION:igt_rand
* @short_description: Random numbers helper library
* @title: Random
* @include: igt_rand.h
*/
static uint32_t global = 0x12345678;
uint32_t hars_petruska_f54_1_random_seed(uint32_t new_state)
......
......@@ -40,6 +40,13 @@
#include "igt_x86.h"
#include <stdio.h>
/**
* SECTION:igt_x86
* @short_description: x86 helper library
* @title: x86
* @include: igt_x86.h
*/
#define BASIC_CPUID 0x0
#define EXTENDED_CPUID 0x80000000
......
......@@ -41,6 +41,13 @@
#include "drmtest.h"
#include "ioctl_wrappers.h"
/**
* SECTION:sw_sync
* @short_description: Software sync (fencing) support library
* @title: SW Sync
* @include: sw_sync.h
*/
struct int_sync_create_fence_data {
__u32 value;
char name[32];
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment