Texture Cache: Improve documentation

2 files changed, 5 insertions, 4 deletions

diff --git a/src/video_core/texture_cache/surface_params.h b/src/video_core/texture_cache/surface_params.h
index 84c8b2940..992b5c022 100644
--- a/src/video_core/texture_cache/surface_params.h
+++ b/src/video_core/texture_cache/surface_params.h
@@ -141,7 +141,7 @@ public:
     /// Get this texture Tegra Block size in guest memory layout
     u32 GetBlockSize() const;
 
-    /// Get X, Y sizes of a block
+    /// Get X, Y coordinates max sizes of a single block.
     std::pair<u32, u32> GetBlockXY() const;
 
     /// Get the offset in x, y, z coordinates from a memory offset
diff --git a/src/video_core/texture_cache/texture_cache.h b/src/video_core/texture_cache/texture_cache.h
index 9c2d108d3..f4c015635 100644
--- a/src/video_core/texture_cache/texture_cache.h
+++ b/src/video_core/texture_cache/texture_cache.h
@@ -616,8 +616,9 @@ private:
     }
 
     /**
-     * Takes care of managing 3D textures and its slices. Does some HLE methods when possible.
-     * Fallsback to LLE when it isn't possible.
+     * Takes care of managing 3D textures and its slices. Does HLE methods for reconstructing the 3D
+     * textures within the GPU if possible. Falls back to LLE when it isn't possible to use any of
+     * the HLE methods.
      *
      * @param overlaps          The overlapping surfaces registered in the cache.
      * @param params            The parameters on the new surface.
@@ -766,7 +767,7 @@ private:
             }
         }
 
-        // Look if it's a 3D texture
+        // Check if it's a 3D texture
         if (params.block_depth > 0) {
             auto surface =
                 Manage3DSurfaces(overlaps, params, gpu_addr, cache_addr, preserve_contents);