From fec72ba342f535ba5d6336e69a530ddf6f124854 Mon Sep 17 00:00:00 2001 From: Dominique Hazael-Massieux Date: Tue, 29 Jun 2021 08:13:14 +0200 Subject: [PATCH] Markup definitions with their type (#3294) As defined in the [definition markup contract](https://tabatkins.github.io/bikeshed/#dfn-contract) that many Web specs are adhering to - these conventions are not specific to bikeshed (they are [being moved to a document on their own](https://github.com/tabatkins/bikeshed/issues/2088#issuecomment-864169459)). Adhering to these conventions makes it easier for other specifications to reference items defined in WebGL, through projects such as [webref](github.com/w3c/webref/) and [shepherd](http://hg.csswg.org/dev/shepherd/) which themseves are integrated in bikeshed and respec, widely used by other specs. If this type of changes are acceptable and welcome, I would be happy to provide additional patches for other IDL items, at least those that are known to be referenced from other specs - if so, I might need guidance on what convention to follow to assign `id`s to these definitions. --- specs/latest/1.0/index.html | 28 ++++++++++++++-------------- specs/latest/2.0/index.html | 16 ++++++++-------- 2 files changed, 22 insertions(+), 22 deletions(-) diff --git a/specs/latest/1.0/index.html b/specs/latest/1.0/index.html index b941de3604..a29e044a24 100644 --- a/specs/latest/1.0/index.html +++ b/specs/latest/1.0/index.html @@ -743,7 +743,7 @@

WebGLContextAttributes

- 
dictionary WebGLContextAttributes {
+    
dictionary WebGLContextAttributes {
     boolean alpha = true;
     boolean depth = true;
     boolean stencil = false;
@@ -945,7 +945,7 @@ 
WebGLObject

         an invalidated flag, which is initially unset.
     

     
[Exposed=(Window,Worker)]
-interface WebGLObject {
+interface WebGLObject {
 };

 
 
@@ -963,7 +963,7 @@ 
WebGLBuffer

         .
     

     
[Exposed=(Window,Worker)]
-interface WebGLBuffer : WebGLObject {
+interface WebGLBuffer : WebGLObject {
 };

 
 
@@ -981,7 +981,7 @@ 
WebGLFramebuffer

         .
     

     
[Exposed=(Window,Worker)]
-interface WebGLFramebuffer : WebGLObject {
+interface WebGLFramebuffer : WebGLObject {
 };

 
 
@@ -999,7 +999,7 @@ 
WebGLProgram

         .
     

     
[Exposed=(Window,Worker)]
-interface WebGLProgram : WebGLObject {
+interface WebGLProgram : WebGLObject {
 };

 
 
@@ -1017,7 +1017,7 @@ 
WebGLRenderbuffer

         .
     

     
[Exposed=(Window,Worker)]
-interface WebGLRenderbuffer : WebGLObject {
+interface WebGLRenderbuffer : WebGLObject {
 };

 
 
@@ -1035,7 +1035,7 @@ 
WebGLShader

         .
     

     
[Exposed=(Window,Worker)]
-interface WebGLShader : WebGLObject {
+interface WebGLShader : WebGLObject {
 };

 
 
@@ -1053,7 +1053,7 @@ 
WebGLTexture

         .
     

     
[Exposed=(Window,Worker)]
-interface WebGLTexture : WebGLObject {
+interface WebGLTexture : WebGLObject {
 };

 
 
@@ -1065,7 +1065,7 @@ 
WebGLUniformLocation

         in a shader program.
     

     
[Exposed=(Window,Worker)]
-interface WebGLUniformLocation {
+interface WebGLUniformLocation {
 };

 
 
@@ -1077,7 +1077,7 @@ 
WebGLActiveInfo

         from the getActiveAttrib and getActiveUniform calls.
     

     
[Exposed=(Window,Worker)]
-interface WebGLActiveInfo {
+interface WebGLActiveInfo {
     readonly attribute GLint size;
     readonly attribute GLenum type;
     readonly attribute DOMString name;
@@ -1128,7 +1128,7 @@ 
WebGLShaderPrecisionFormat

         from the getShaderPrecisionFormat call.
     

     
[Exposed=(Window,Worker)]
-interface WebGLShaderPrecisionFormat {
+interface WebGLShaderPrecisionFormat {
     readonly attribute GLint rangeMin;
     readonly attribute GLint rangeMax;
     readonly attribute GLint precision;
@@ -1296,7 +1296,7 @@ 
The WebGL context

 typedef ([AllowShared] Float32Array or sequence<GLfloat>) Float32List;
 typedef ([AllowShared] Int32Array or sequence<GLint>) Int32List;
 
-interface mixin WebGLRenderingContextBase
+interface mixin WebGLRenderingContextBase
 {
 
     /* ClearBufferMask */
@@ -1930,7 +1930,7 @@ 
The WebGL context

 };
 
 [Exposed=(Window,Worker)]
-interface WebGLRenderingContext
+interface WebGLRenderingContext
 {
 };
 WebGLRenderingContext includes WebGLRenderingContextBase;
@@ -3463,7 +3463,7 @@ 
WebGLContextEvent

     

     
 [Exposed=(Window,Worker)]
-interface WebGLContextEvent : Event {
+interface WebGLContextEvent : Event {
     constructor(DOMString type, optional WebGLContextEventInit eventInit = {});
     readonly attribute DOMString statusMessage;
 };
diff --git a/specs/latest/2.0/index.html b/specs/latest/2.0/index.html
index 756cf41cae..c7854393c1 100644
--- a/specs/latest/2.0/index.html
+++ b/specs/latest/2.0/index.html
@@ -300,7 +300,7 @@ 
WebGLQuery

         .
     

     
[Exposed=(Window,Worker)]
-interface WebGLQuery : WebGLObject {
+interface WebGLQuery : WebGLObject {
 };

 
 
@@ -326,7 +326,7 @@ 
WebGLSampler

         .
     

     
[Exposed=(Window,Worker)]
-interface WebGLSampler : WebGLObject {
+interface WebGLSampler : WebGLObject {
 };

 
 
@@ -364,7 +364,7 @@ 
WebGLSync

     

     

     
[Exposed=(Window,Worker)]
-interface WebGLSync : WebGLObject {
+interface WebGLSync : WebGLObject {
 };

 
 
@@ -390,7 +390,7 @@ 
WebGLTransformFeedback

         .
     

     
[Exposed=(Window,Worker)]
-interface WebGLTransformFeedback : WebGLObject {
+interface WebGLTransformFeedback : WebGLObject {
 };

 
 
@@ -416,7 +416,7 @@ 
WebGLVertexArrayObject

         .
     

     
[Exposed=(Window,Worker)]
-interface WebGLVertexArrayObject : WebGLObject {
+interface WebGLVertexArrayObject : WebGLObject {
 };

 
 
@@ -431,7 +431,7 @@ 
The WebGL context

     
 typedef ([AllowShared] Uint32Array or sequence<GLuint>) Uint32List;
 
-interface mixin WebGL2RenderingContextBase
+interface mixin WebGL2RenderingContextBase
 {
   const GLenum READ_BUFFER                                   = 0x0C02;
   const GLenum UNPACK_ROW_LENGTH                             = 0x0CF2;
@@ -882,7 +882,7 @@ 
The WebGL context

   undefined bindVertexArray(WebGLVertexArrayObject? array);
 };
 
-interface mixin WebGL2RenderingContextOverloads
+interface mixin WebGL2RenderingContextOverloads
 {
   // WebGL1:
   undefined bufferData(GLenum target, GLsizeiptr size, GLenum usage);
@@ -977,7 +977,7 @@ 
The WebGL context

 };
 
 [Exposed=(Window,Worker)]
-interface WebGL2RenderingContext
+interface WebGL2RenderingContext
 {
 };
 WebGL2RenderingContext includes WebGLRenderingContextBase;