From 98f6ff65234203efb56252c00a0e3c78411f6dc4 Mon Sep 17 00:00:00 2001
From: Kenneth Russell <kbrussel@alum.mit.edu>
Date: Wed, 4 Sep 2024 22:28:37 -0700
Subject: [PATCH] Clarify GLES/WebGL difference with uninitialized compressed
 textures.

Fixes #3686.
---
 specs/latest/2.0/index.html | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/specs/latest/2.0/index.html b/specs/latest/2.0/index.html
index 27fb563c6..aeba54ff2 100644
--- a/specs/latest/2.0/index.html
+++ b/specs/latest/2.0/index.html
@@ -4467,6 +4467,19 @@ <h3><a name="GENERIC_TRANSFORM_FEEDBACK_BUFFER">Generic TRANSFORM_FEEDBACK_BUFFE
       A similar change was made in OpenGL ES 3.2.
     </div>
 
+    <h3><a name="UNINITIALIZED_COMPRESSED_TEXTURES">Uninitialized Compressed Textures</a></h3>
+
+    <p>
+      In OpenGL ES 2.0 the specification omitted declaring whether it should be possible to create a
+      compressed 2D texture with uninitialized data. In WebGL 1.0, this is explicitly disallowed.
+    </p>
+    <p>
+      In OpenGL ES 3.0 it is explicitly allowed to create a compressed 2D texture with uninitialized
+      data by passing <code>null</code> to <code>glCompressedTexImage2D</code>. In WebGL 2.0,
+      however, this is still explicitly disallowed. Users can call <code>texStorage2D</code> to work
+      around this functional difference.
+    </p>
+
 <!-- ======================================================================================================= -->
 
     <h2>References</h2>