=== modified file 'docs/hooks.php'
--- docs/hooks.php	2009-08-17 18:54:05 +0000
+++ docs/hooks.php	2009-09-14 19:58:05 +0000
@@ -781,6 +781,50 @@
 }
 
 /**
+ * Register static order states.
+ *
+ * Order states are module-defined categories for order statuses. Each state
+ * will have a default status that is used when modules need to move orders to
+ * new state, but don't know which status to use.
+ *
+ * @return
+ *   An array of order state definitions. Each definition is an array with the
+ *   following keys:
+ *   - id: The machine-readable name of the order state.
+ *   - title: The human-readable, translated name.
+ *   - weight: The list position of the state.
+ *   - scope: Either "specific" or "general".
+ */
+function hook_order_state() {
+  $states[] = array(
+    'id' => 'canceled',
+    'title' => t('Canceled'),
+    'weight' => -20,
+    'scope' => 'specific',
+  );
+  $states[] = array(
+    'id' => 'in_checkout',
+    'title' => t('In checkout'),
+    'weight' => -10,
+    'scope' => 'specific',
+  );
+  $states[] = array(
+    'id' => 'post_checkout',
+    'title' => t('Post checkout'),
+    'weight' => 0,
+    'scope' => 'general',
+  );
+  $states[] = array(
+    'id' => 'completed',
+    'title' => t('Completed'),
+    'weight' => 20,
+    'scope' => 'general',
+  );
+
+  return $states;
+}
+
+/**
  * Register payment gateway callbacks.
  *
  * @see @link http://www.ubercart.org/docs/api/hook_payment_gateway @endlink