Update docuemntation for V2.3

Author: chesik-amd

README.md

@@ -20,8 +20,8 @@ In order to use the latest features of RGP, it is strongly recommended that user
    * Help web pages can be accessed from the **Help** button in the Radeon Developer Panel
    * Help web pages can be accessed from the Welcome screen in the Radeon GPU Profiler, or from the **Help** menu
    * The documentation is hosted publicly at:
-     * https://radeon-developer-panel.readthedocs.io/en/latest/
-     * https://radeon-gpuprofiler.readthedocs.io/en/latest/
+     * https://gpuopen.com/manuals/rdp_manual/rdp_manual-index/
+     * https://gpuopen.com/manuals/rgp_manual/rgp_manual-index/
 
 ## Graphics APIs, RDNA™ hardware, and operating systems
 ### Supported APIs
@@ -38,6 +38,7 @@ In order to use the latest features of RGP, it is strongly recommended that user
 * Windows® 10
 * Windows® 11
 * Ubuntu 22.04 LTS (Vulkan only)
+* Ubuntu 24.04 LTS (Vulkan only)
 
 
 ## Compute APIs, RDNA hardware, and operating systems

RELEASE_NOTES.txt

@@ -1,14 +1,15 @@
-Radeon™ GPU Profiler V2.2 07-01-2024
+Radeon™ GPU Profiler V2.3 10-01-2024
 -------------------------------------
 
-V2.2 Changes
+V2.3 Changes
 -------------------------------------
 
-1) Updated to use Qt 6.7.0
-2) Fix a crash when loading a RADV-exported profile (https://github.com/GPUOpen-Tools/radeon_gpu_profiler/issues/98)
-3) Enabling shader instrumentation (to support showing thread divergence in the ray tracing shader table UI) for Vulkan® is now supported starting with 24.10-based drivers
-4) Reduced profile load time for certain profiles, especially for those captured on RDNA™ 3 hardware
-5) Bug/stability fixes
+1) The System information pane (which has been renamed from "Device configuration") will now indicate if any driver experiments were enabled when the loaded profile data set was captured
+2) The event tree view in the Event timing and Pipeline state panes will show when multiple indirect draw calls or dispatches are launched from a single ExecuteIndirect call
+3) Adapt to changes in the way that ray tracing pipelines are compiled by the ray tracing runtime and the shader compiler. This results in minor changes in the display names of the individual shaders in the RGP UI. The UI elements affected are the ray tracing shader table in the Pipeline state pane and the "Export name" drop down and the "Call targets" table in the Instruction timing pane.
+4) Fix an issue when attempting to scroll horizontally using the input device when the mouse cursor is over select rows in the Wavefront occupancy pane (https://github.com/GPUOpen-Tools/radeon_gpu_profiler/issues/79)
+5) Fix an issue where the last column in the Barriers pane is not visible at lower resolutions (https://github.com/GPUOpen-Tools/radeon_gpu_profiler/issues/103)
+6) Bug/stability fixes
 
 Known Issues
 -------------------------------------
@@ -22,15 +23,14 @@ Known Issues
 
 * Windows®
 
-1)  D3D12 command list calls of ExecuteIndirect() may show in RGP as multiple compute events.
-2)  Some Radeon Software hotkeys may conflict with Radeon GPU Profiler shortcut keys. The Radeon Software hotkeys can be reconfigured by opening the Radeon Software panel (from the system tray), selecting the Hotkeys tab under Settings then changing or unbinding any conflicting hotkeys.
-3)  If a DirectX® 12 profile is missing GPU synchronization primitive data (i.e. signals and waits) on the Frame summary pane, please try running the included scripts\AddUserToGroup.bat batch file and then recapturing the profile. This batch file must be run as Administrator.
+1)  Some Radeon Software hotkeys may conflict with Radeon GPU Profiler shortcut keys. The Radeon Software hotkeys can be reconfigured by opening the Radeon Software panel (from the system tray), selecting the Hotkeys tab under Settings then changing or unbinding any conflicting hotkeys.
+2)  If a DirectX® 12 profile is missing GPU synchronization primitive data (i.e. signals and waits) on the Frame summary pane, please try running the included scripts\AddUserToGroup.bat batch file and then recapturing the profile. This batch file must be run as Administrator.
 
 * Linux®
 
-1)  Installations of Ubuntu 20.04 or newer may have the RADV open source Vulkan driver installed by default on the system. As a result, after an amdgpu-pro driver install, the default Vulkan ICD may be the RADV ICD. In order to capture a profile, Vulkan applications must be using the amdgpu-pro Vulkan ICD. The default Vulkan ICD can be overridden by setting the following environment variable before launching a Vulkan application: VK_ICD_FILENAMES=/etc/vulkan/icd.d/amd_icd64.json
+1)  Installations of Ubuntu 20.04 or newer may have the RADV open source Vulkan® driver installed by default on the system. As a result, after an amdgpu-pro driver install, the default Vulkan ICD may be the RADV ICD. In order to capture a profile, Vulkan applications must be using the amdgpu-pro Vulkan ICD. The default Vulkan ICD can be overridden by setting the following environment variable before launching a Vulkan application: VK_ICD_FILENAMES=/etc/vulkan/icd.d/amd_icd64.json
 
-* RDNA
+* RDNA™
 
 1)  The Device configuration does not show the correct Work group processor per Shader engine for certain parts with harvested CUs.
 
@@ -42,6 +42,15 @@ Known Issues
 Release Notes History
 -------------------------------------
 
+V2.2 Changes
+-------------------------------------
+
+1) Updated to use Qt 6.7.0
+2) Fix a crash when loading a RADV-exported profile (https://github.com/GPUOpen-Tools/radeon_gpu_profiler/issues/98)
+3) Enabling shader instrumentation (to support showing thread divergence in the ray tracing shader table UI) for Vulkan is now supported starting with 24.10-based drivers
+4) Reduced profile load time for certain profiles, especially for those captured on RDNA 3 hardware
+5) Bug/stability fixes
+
 V2.1 Changes
 -------------------------------------
 
@@ -79,7 +88,7 @@ V1.16 Changes
 * Radeon GPU Profiler
 
 1)  Support for additional AMD RDNA 3 hardware
-2)  The vertical scroll bars in the ISA disassembly view (in Instruction timing and Pipeline state panes) now indicate the location of search matches and instruction latency hotspot
+2)  The vertical scroll bars in the ISA disassembly view (in the Instruction timing and Pipeline state panes) now indicate the location of search matches and instruction latency hotspot
 3)  Added support for showing the ray tracing pipeline in the Pipeline state pane for profiles generated by the RADV driver (the bulk of this work was implemented by the RADV team, but this RGP release contains some corresponding changes to support this)
 4)  The Output Merger (OM) Pipeline state pane now shows the Stencil reference value as part of the Depth/Stencil state
 5)  The Output Merger (OM) Pipeline state pane now shows the correct value for "Alpha to coverage enable" on recent hardware
@@ -541,5 +550,3 @@ V1.01 Changes
 * Radeon GPU Profiler
 
 1) Fixed crash when loading certain profiles
-
-

docs/source/conf.py

@@ -56,9 +56,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = u'2.2.0'
+version = u'2.3.0'
 # The full version, including alpha/beta/rc tags.
-release = u'2.2.0'
+release = u'2.3.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

docs/source/events_windows.rst

@@ -163,7 +163,7 @@ The description of each counter can be viewed by hovering the mouse over the
 counter name in the legend left of the counter graph.
 
 The sizes of the L0, L1 and L2 caches, which may vary depending on the GPU, are
-reported in the Device configuration pane in the Overview tab.
+reported in the System information pane in the Overview tab.
 
 Users may use the legend on the left to choose which counters to
 include in the graph.
@@ -582,6 +582,14 @@ Grouping by hardware context is shown below:
 
 .. image:: media_rgp/rgp_event_timing_2.png
 
+Note that when profiling an application that uses indirect drawing via the
+**ExecuteIndirect** D3D12 call, the event tree view will logically group the
+individual draw calls under the same parent node. This can be seen below where
+the individidual **DrawInstanced** events are grouped under a parent node with
+the same name:
+
+.. image:: media_rgp/rgp_event_treeview_multidraw.png
+
 **Color modes**
 
 The events can be rendered using different color schemes in the same manner

docs/source/index.rst

@@ -79,6 +79,8 @@ Graphics APIs, RDNA hardware, and operating systems
 
 -  Ubuntu 22.04 LTS (Vulkan only)
 
+-  Ubuntu 24.04 LTS (Vulkan only)
+
 Compute APIs, RDNA hardware, and operating systems
 --------------------------------------------------