Merge pull request #380 from bcipolli/doc

MRG: 5 small documentation changes

1. Add 3rd party copyright notice for `six`  (#375)
2. Fix openhub.net badge (#378); see issue for images.
3. Update URL to numpy's docstrings (partial #376 fix).
4. Prevent content from overflowing sidebar (discovered solving #378)
5. Make all copyright notices enclosed in greyed boxes (see image below)

Currently, some copyright notices are contained in greyed boxes, others were plain text (white background, no border). Changed all to be in greyed boxes.

Author: matthew-brett

COPYING

@@ -128,27 +128,29 @@ In ``nibabel/externals/ordereddict.py``
 
 Copied from: https://pypi.python.org/packages/source/o/ordereddict/ordereddict-1.1.tar.gz#md5=a0ed854ee442051b249bfad0f638bbec
 
-Copyright (c) 2009 Raymond Hettinger
-
-Permission is hereby granted, free of charge, to any person
-obtaining a copy of this software and associated documentation files
-(the "Software"), to deal in the Software without restriction,
-including without limitation the rights to use, copy, modify, merge,
-publish, distribute, sublicense, and/or sell copies of the Software,
-and to permit persons to whom the Software is furnished to do so,
-subject to the following conditions:
-
-    The above copyright notice and this permission notice shall be
-    included in all copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-    EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
-    OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-    NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
-    HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
-    WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
-    OTHER DEALINGS IN THE SOFTWARE.
+::
+
+  Copyright (c) 2009 Raymond Hettinger
+
+  Permission is hereby granted, free of charge, to any person
+  obtaining a copy of this software and associated documentation files
+  (the "Software"), to deal in the Software without restriction,
+  including without limitation the rights to use, copy, modify, merge,
+  publish, distribute, sublicense, and/or sell copies of the Software,
+  and to permit persons to whom the Software is furnished to do so,
+  subject to the following conditions:
+
+      The above copyright notice and this permission notice shall be
+      included in all copies or substantial portions of the Software.
+
+      THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+      EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+      OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+      NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+      HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+      WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+      FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+      OTHER DEALINGS IN THE SOFTWARE.
 
 mni_icbm152_t1_tal_nlin_asym_09a
 --------------------------------
@@ -158,6 +160,8 @@ The file ``doc/source/someone.nii.gz`` is a subsampled version of the file
 archive ``mni_icbm152_t1_tal_nlin_asym_09a``.  The original image has the
 following license (where 'softwware' refers to the image):
 
+::
+
     Copyright (C) 1993-2004 Louis Collins, McConnell Brain Imaging Centre,
     Montreal Neurological Institute, McGill University.
 
@@ -209,3 +213,34 @@ the PDDL version 1.0 available at http://opendatacommons.org/licenses/pddl/1.0/
 
 is courtesy of the University of Massachusetts Medical School, also released
 under the PDDL.
+
+
+Six
+--------------------
+
+In ``nibabel/externals/six.py``
+
+Copied from: https://pypi.python.org/packages/source/s/six/six-1.3.0.tar.gz#md5=ec47fe6070a8a64c802363d2c2b1e2ee
+
+::
+
+    Copyright (c) 2010-2013 Benjamin Peterson
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy of
+    this software and associated documentation files (the "Software"), to deal in
+    the Software without restriction, including without limitation the rights to
+    use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+    the Software, and to permit persons to whom the Software is furnished to do so,
+    subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+    FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+    COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+    IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+    CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+

doc/source/_static/nibabel.css

@@ -31,3 +31,8 @@ div.footer {
 div.body {
     background-color: white;
 }
+
+.sphinxsidebarwrapper {
+    /* don't let anything exceed sidebar boundaries */
+    overflow: hidden;
+}

doc/source/_templates/indexsidebar.html

@@ -6,7 +6,7 @@ <h3>Quick links</h3>
     <li><a href="https://mail.python.org/pipermail/neuroimaging">Mailing list archive</a></li>
 </ul>
 
-<script type="text/javascript" src="https://www.ohloh.net/projects/480908/widgets/project_partner_badge"></script>
+<script type='text/javascript' src='https://www.openhub.net/p/nibabel/widgets/project_thin_badge?format=js'></script>
 
 <h3>Search mailing list archive</h3>
 <script type="text/javascript">

doc/source/devel/devguide.rst

@@ -28,7 +28,7 @@ Code Documentation
 
 All documentation should be written using Numpy documentation conventions:
 
-  http://projects.scipy.org/numpy/wiki/CodingStyleGuidelines#docstring-standard
+  https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt#docstring-standard
 
 
 Git Repository