improve NA_action= docs

njsmith · njsmith · commit 3dc8a5f3be13 · 2013-02-25T11:30:52.000Z
diff --git a/patsy/build.py b/patsy/build.py
@@ -807,10 +807,10 @@ def build_design_matrices(builders, data,
     :arg builders: A list of :class:`DesignMatrixBuilders` specifying the
       design matrices to be built.
     :arg data: A dict-like object which will be used to look up data.
-    :arg NA_action: What to do with rows that contain missing values. Either
-      ``"drop"``, ``"raise"``, or an :class:`NAAction` object. See
-      :class:`NAAction` for details on what values count as 'missing' (and how
-      to alter this).
+    :arg NA_action: What to do with rows that contain missing values. You can
+      ``"drop"`` them, ``"raise"`` an error, or for customization, pass an
+      :class:`NAAction` object. See :class:`NAAction` for details on what
+      values count as 'missing' (and how to alter this).
     :arg return_type: Either ``"matrix"`` or ``"dataframe"``. See below.
     :arg dtype: The dtype of the returned matrix. Useful if you want to use
       single-precision or extended-precision.
diff --git a/patsy/highlevel.py b/patsy/highlevel.py
@@ -215,10 +215,10 @@ def dmatrix(formula_like, data={}, eval_env=0,
       :func:`dmatrix` for lookups. If calling this function from a library,
       you probably want ``eval_env=1``, which means that variables should be
       resolved in *your* caller's namespace.
-    :arg NA_action: What to do with rows that contain missing values. Either
-      ``"drop"``, ``"raise"``, or an :class:`NAAction` object. See
-      :class:`NAAction` for details on what values count as 'missing' (and how
-      to alter this).
+    :arg NA_action: What to do with rows that contain missing values. You can
+      ``"drop"`` them, ``"raise"`` an error, or for customization, pass an
+      :class:`NAAction` object. See :class:`NAAction` for details on what
+      values count as 'missing' (and how to alter this).
     :arg return_type: Either ``"matrix"`` or ``"dataframe"``. See below.
 
     The `formula_like` can take a variety of forms:
