 }
 { $description "Compiles an instance of " { $snippet "shader" } " for the current graphics context. If an instance already exists for " { $snippet "shader" } " in the current context, it is reused." } ;
 
-HELP: <vertex-array>
+HELP: <multi-vertex-array>
 { $values
     { "program-instance" program-instance } { "vertex-formats" "a list of " { $link buffer-ptr } "/" { $link vertex-format } " pairs" }
     { "vertex-array" vertex-array }

"Render data inside GPU " { $link buffer } "s is organized into " { $link vertex-array } "s for consumption by shader code:"
{ $subsections
    vertex-array
    <vertex-array>
    buffer>vertex-array
    POSTPONE: VERTEX-FORMAT:
} ;


{ $class-description "This " { $link shader-kind } " indicates that a " { $link shader } " is a vertex shader." } ;

HELP: vertex-array
{ $class-description "A " { $snippet "vertex-array" } " object associates a shader " { $link program-instance } " with vertex attribute data from one or more " { $link buffer } "s. The format of the binary data inside these buffers is described using " { $link vertex-format } "s. " { $snippet "vertex-array" } "s are constructed using the " { $link <multi-vertex-array> } " or " { $link <vertex-array*> } " words." } ;

HELP: vertex-array-buffer
{ $values
