Merge pull request #5413 from rgommers/link-format-nep

charris · charris · commit 3a9b3338078f · 2015-01-02T13:54:47.000-05:00
DOC: link to the npy-format NEP in numpy.npyio docs. Closes gh-4523.
diff --git a/doc/source/reference/routines.io.rst b/doc/source/reference/routines.io.rst
@@ -3,8 +3,8 @@ Input and output
 
 .. currentmodule:: numpy
 
-NPZ files
----------
+Numpy binary files (NPY, NPZ)
+-----------------------------
 .. autosummary::
    :toctree: generated/
 
@@ -13,6 +13,9 @@ NPZ files
    savez
    savez_compressed
 
+The format of these binary file types is documented in
+http://docs.scipy.org/doc/numpy/neps/npy-format.html  
+
 Text files
 ----------
 .. autosummary::
diff --git a/numpy/lib/npyio.py b/numpy/lib/npyio.py
@@ -433,7 +433,8 @@ def save(file, arr):
     Notes
     -----
     For a description of the ``.npy`` format, see the module docstring
-    of `numpy.lib.format`.
+    of `numpy.lib.format` or the Numpy Enhancement Proposal
+    http://docs.scipy.org/doc/numpy/neps/npy-format.html
 
     Examples
     --------
@@ -504,7 +505,9 @@ def savez(file, *args, **kwds):
     The ``.npz`` file format is a zipped archive of files named after the
     variables they contain.  The archive is not compressed and each file
     in the archive contains one variable in ``.npy`` format. For a
-    description of the ``.npy`` format, see `format`.
+    description of the ``.npy`` format, see `numpy.lib.format` or the
+    Numpy Enhancement Proposal
+    http://docs.scipy.org/doc/numpy/neps/npy-format.html
 
     When opening the saved ``.npz`` file with `load` a `NpzFile` object is
     returned. This is a dictionary-like object which can be queried for
