mv some stuff into Pass; hardware->device;

api/lovr/graphics/Buffer/init.lua

@@ -1,8 +1,4 @@
 return {
   summary = 'A block of memory on the GPU.',
-  description = 'TODO',
-  constructors = {
-    'lovr.graphics.newBuffer',
-    'lovr.graphics.getBuffer'
-  }
+  description = 'TODO'
 }

api/lovr/graphics/Pass/init.lua

@@ -0,0 +1,4 @@
+return {
+  summary = 'A self-contained stream of graphics commands.',
+  description = 'TODO'
+}

api/lovr/graphics/begin.lua

@@ -1,59 +0,0 @@
-return {
-  tag = 'work-submission',
-  summary = 'Begin a pass of graphics work.',
-  description = 'TODO',
-  arguments = {
-    type = {
-      type = 'PassType',
-      description = 'The type of pass to start.'
-    },
-    canvas = {
-      type = 'table',
-      description = 'The set of textures to render to, along with other rendering options.'
-    },
-    texture = {
-      type = 'Texture',
-      description = 'The texture to render to.'
-    },
-    batch = {
-      type = 'Batch',
-      description = 'The Batch to record commands to.'
-    },
-    order = {
-      type = 'number',
-      default = 'nil',
-      description = [[
-        A number between 1 and 100 used to define the order passes run in.  Passes with a smaller
-        order run before passes with a larger order.  Passes with the same order may run in any
-        order.  If `nil`, an autoincrementing number will be used, causing passes to run in the
-        order they are started.
-      ]]
-    }
-  },
-  returns = {},
-  variants = {
-    {
-      description = 'TODO (compute and transfer pass)',
-      arguments = { 'type', 'order' },
-      returns = {}
-    },
-    {
-      description = 'TODO',
-      arguments = { 'type', 'texture', 'order' },
-      returns = {}
-    },
-    {
-      description = 'TODO',
-      arguments = { 'type', 'canvas', 'order' },
-      returns = {}
-    },
-    {
-      description = 'TODO (batch pass)',
-      arguments = { 'type', 'batch', 'order' },
-      returns = {}
-    }
-  },
-  related = {
-    'lovr.graphics.finish'
-  }
-}

api/lovr/graphics/finish.lua

@@ -1,10 +0,0 @@
-return {
-  tag = 'work-submission',
-  summary = 'Finish a pass.',
-  description = 'TODO',
-  arguments = {},
-  returns = {},
-  related = {
-    'lovr.graphics.begin'
-  }
-}

api/lovr/graphics/getBackground.lua

@@ -24,8 +24,5 @@ return {
       type = 'number',
       description = 'The alpha component of the background color.',
     }
-  },
-  related = {
-    'lovr.graphics.begin'
   }
 }

api/lovr/graphics/getHardware.lua → api/lovr/graphics/getDevice.lua

@@ -5,7 +5,7 @@ return {
   arguments = {},
   returns = {
     {
-      name = 'hardware',
+      name = 'device',
       type = 'table',
       description = 'Information about the GPU device.',
       table = {
@@ -15,17 +15,17 @@ return {
           description = 'TODO'
         },
         {
-          name = 'name',
-          type = 'string',
+          name = 'vendor',
+          type = 'number',
           description = 'TODO'
         },
         {
-          name = 'vendor',
-          type = 'number',
+          name = 'name',
+          type = 'string',
           description = 'TODO'
         },
         {
-          name = 'driver',
+          name = 'renderer',
           type = 'string',
           description = 'TODO'
         },
@@ -38,11 +38,6 @@ return {
           name = 'discrete',
           type = 'boolean',
           description = 'TODO'
-        },
-        {
-          name = 'renderer',
-          type = 'string',
-          description = 'TODO'
         }
       }
     }

api/lovr/graphics/getFeatures.lua

@@ -74,7 +74,7 @@ return {
   },
   related = {
     'lovr.graphics.isFormatSupported',
-    'lovr.graphics.getHardware',
+    'lovr.graphics.getDevice',
     'lovr.graphics.getLimits',
     'lovr.graphics.getStats'
   }

api/lovr/graphics/getLimits.lua

@@ -119,7 +119,7 @@ return {
   },
   related = {
     'lovr.graphics.isFormatSupported',
-    'lovr.graphics.getHardware',
+    'lovr.graphics.getDevice',
     'lovr.graphics.getFeatures',
     'lovr.graphics.getStats'
   }

api/lovr/graphics/getStats.lua

@@ -151,7 +151,7 @@ return {
     }
   },
   related = {
-    'lovr.graphics.getHardware',
+    'lovr.graphics.getDevice',
     'lovr.graphics.getFeatures',
     'lovr.graphics.getLimits'
   }

api/lovr/graphics/isFormatSupported.lua

@@ -22,7 +22,7 @@ return {
     }
   },
   related = {
-    'lovr.graphics.getHardware',
+    'lovr.graphics.getDevice',
     'lovr.graphics.getFeatures',
     'lovr.graphics.getLimits'
   }

api/lovr/graphics/prepare.lua

@@ -1,10 +0,0 @@
-return {
-  tag = 'work-submission',
-  summary = 'Start recording graphics work.',
-  description = 'TODO',
-  arguments = {},
-  returns = {},
-  related = {
-    'lovr.graphics.submit'
-  }
-}

api/lovr/graphics/setBackground.lua

@@ -48,8 +48,5 @@ return {
       arguments = { 'color' },
       returns = {}
     }
-  },
-  related = {
-    'lovr.graphics.begin'
   }
 }

api/lovr/graphics/submit.lua

@@ -5,7 +5,6 @@ return {
   arguments = {},
   returns = {},
   related = {
-    'lovr.graphics.prepare',
     'lovr.graphics.wait'
   }
 }

api/lovr/graphics/wait.lua

@@ -5,7 +5,6 @@ return {
   arguments = {},
   returns = {},
   related = {
-    'lovr.graphics.prepare',
     'lovr.graphics.submit'
   }
 }