Merge pull request matplotlib#2195 from mdboom/docs-and-licensing

pelson · pelson · commit 53b5582d742a · 2013-07-15T02:40:46.000-07:00
Update copyright model for matplotlib as of v1.3.0
diff --git a/doc/conf.py b/doc/conf.py
@@ -58,7 +58,7 @@
 
 # General substitutions.
 project = 'Matplotlib'
-copyright = '2013 John Hunter, Darren Dale, Eric Firing, Michael Droettboom and the matplotlib development team'
+copyright = '2002 - 2012 John Hunter, Darren Dale, Eric Firing, Michael Droettboom and the matplotlib development team; 2012 - 2013 The matplotlib development team'
 
 # The default replacements for |version| and |release|, also used in various
 # other places throughout the built documents.
diff --git a/doc/devel/documenting_mpl.rst b/doc/devel/documenting_mpl.rst
@@ -351,7 +351,7 @@ An example save command to generate a movie looks like this
 
     ani.save('double_pendulum.mp4', fps=15)
 
-Contact John Hunter for the login password to upload youtube videos of
+Contact Michael Droettboom for the login password to upload youtube videos of
 google docs to the mplgithub account.
 
 .. _referring-to-mpl-docs:
diff --git a/doc/users/license.rst b/doc/users/license.rst
@@ -13,10 +13,86 @@ licenses. Non-BSD compatible licenses (eg LGPL) are acceptable in
 matplotlib toolkits.  For a discussion of the motivations behind the
 licencing choice, see :ref:`license-discussion`.
 
+Copyright Policy
+================
+
+John Hunter began matplotlib around 2003.  Since shortly before his
+passing in 2012, Michael Droettboom has been the lead maintainer of
+matplotlib, but, as has always been the case, matplotlib is the work
+of many.
+
+Prior to July of 2013, and the 1.3.0 release, the copyright of the
+source code was held by John Hunter.  As of July 2013, and the 1.3.0
+release, matplotlib has moved to a shared copyright model.
+
+matplotlib uses a shared copyright model. Each contributor maintains
+copyright over their contributions to matplotlib. But, it is important to
+note that these contributions are typically only changes to the
+repositories. Thus, the matplotlib source code, in its entirety, is not
+the copyright of any single person or institution.  Instead, it is the
+collective copyright of the entire matplotlib Development Team.  If
+individual contributors want to maintain a record of what
+changes/contributions they have specific copyright on, they should
+indicate their copyright in the commit message of the change, when
+they commit the change to one of the matplotlib repositories.
+
+The Matplotlib Development Team is the set of all contributors to the
+matplotlib project.  A full list can be obtained from the git version
+control logs.
 
 License agreement for matplotlib |version|
 ==============================================
 
+1. This LICENSE AGREEMENT is between the Matplotlib Development Team
+("MDT"), and the Individual or Organization ("Licensee") accessing and
+otherwise using matplotlib software in source or binary form and its
+associated documentation.
+
+. Subject to the terms and conditions of this License Agreement, MDT
+hereby grants Licensee a nonexclusive, royalty-free, world-wide license
+to reproduce, analyze, test, perform and/or display publicly, prepare
+derivative works, distribute, and otherwise use matplotlib |version|
+alone or in any derivative version, provided, however, that MDT's
+License Agreement and MDT's notice of copyright, i.e., "Copyright (c)
+2012-2013 Matplotlib Development Team; All Rights Reserved" are retained in
+matplotlib |version| alone or in any derivative version prepared by
+Licensee.
+
+3. In the event Licensee prepares a derivative work that is based on or
+incorporates matplotlib |version| or any part thereof, and wants to
+make the derivative work available to others as provided herein, then
+Licensee hereby agrees to include in any such work a brief summary of
+the changes made to matplotlib |version|.
+
+4. MDT is making matplotlib |version| available to Licensee on an "AS
+IS" basis.  MDT MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
+IMPLIED.  BY WAY OF EXAMPLE, BUT NOT LIMITATION, MDT MAKES NO AND
+DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
+FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF MATPLOTLIB |version|
+WILL NOT INFRINGE ANY THIRD PARTY RIGHTS.
+
+5. MDT SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF MATPLOTLIB
+|version| FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR
+LOSS AS A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING
+MATPLOTLIB |version|, OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF
+THE POSSIBILITY THEREOF.
+
+6. This License Agreement will automatically terminate upon a material
+breach of its terms and conditions.
+
+7. Nothing in this License Agreement shall be deemed to create any
+relationship of agency, partnership, or joint venture between MDT and
+Licensee.  This License Agreement does not grant permission to use MDT
+trademarks or trade name in a trademark sense to endorse or promote
+products or services of Licensee, or any third party.
+
+8. By copying, installing or otherwise using matplotlib |version|,
+Licensee agrees to be bound by the terms and conditions of this License
+Agreement.
+
+License agreement for matplotlib versions prior to 1.3.0
+========================================================
+
 1. This LICENSE AGREEMENT is between John D. Hunter ("JDH"), and the
 Individual or Organization ("Licensee") accessing and otherwise using
 matplotlib software in source or binary form and its associated
diff --git a/lib/matplotlib/afm.py b/lib/matplotlib/afm.py
@@ -1,23 +1,27 @@
 """
 This is a python interface to Adobe Font Metrics Files.  Although a
-number of other python implementations exist (and may be more complete
-than mine) I decided not to go with them because either they were
-either
+number of other python implementations exist, and may be more complete
+than this, it was decided not to go with them because they were
+either:
 
   1) copyrighted or used a non-BSD compatible license
 
-  2) had too many dependencies and I wanted a free standing lib
+  2) had too many dependencies and a free standing lib was needed
 
-  3) Did more than I needed and it was easier to write my own than
-     figure out how to just get what I needed from theirs
+  3) Did more than needed and it was easier to write afresh rather than
+     figure out how to get just what was needed.
 
-It is pretty easy to use, and requires only built-in python libs::
+It is pretty easy to use, and requires only built-in python libs:
 
-    >>> from afm import AFM
-    >>> fh = open('ptmr8a.afm')
-    >>> afm = AFM(fh)
+    >>> from matplotlib import rcParams
+    >>> import os.path
+    >>> afm_fname = os.path.join(rcParams['datapath'], 
+    ...                         'fonts', 'afm', 'ptmr8a.afm')
+    >>>
+    >>> from matplotlib.afm import AFM
+    >>> afm = AFM(open(afm_fname))
     >>> afm.string_width_height('What the heck?')
-    (6220.0, 683)
+    (6220.0, 694)
     >>> afm.get_fontname()
     'Times-Roman'
     >>> afm.get_kern_dist('A', 'f')
@@ -26,12 +30,7 @@
     -92.0
     >>> afm.get_bbox_char('!')
     [130, -9, 238, 676]
-    >>> afm.get_bbox_font()
-    [-168, -218, 1000, 898]
 
-
-AUTHOR:
-  John D. Hunter <jdh2358@gmail.com>
 """
 
 from __future__ import print_function
@@ -549,14 +548,4 @@ def get_vertical_stem_width(self):
         Return the standard vertical stem width as float, or *None* if
         not specified in AFM file.
         """
-        return self._header.get(b'StdVW', None)
-
-
-if __name__ == '__main__':
-    #pathname = '/usr/local/lib/R/afm/'
-    pathname = '/usr/local/share/fonts/afms/adobe'
-
-    for fname in os.listdir(pathname):
-        with open(os.path.join(pathname, fname)) as fh:
-            afm = AFM(fh)
-            w, h = afm.string_width_height('John Hunter is the Man!')
+        return self._header.get(b'StdVW', None)
diff --git a/lib/matplotlib/backends/backend_wxagg.py b/lib/matplotlib/backends/backend_wxagg.py
@@ -1,20 +1,3 @@
-"""
-
- backend_wxagg.py
-
- A wxPython backend for Agg.  This uses the GUI widgets written by
- Jeremy O'Donoghue (jeremy@o-donoghue.com) and the Agg backend by John
- Hunter (jdhunter@ace.bsd.uchicago.edu)
-
- Copyright (C) 2003-5 Jeremy O'Donoghue, John Hunter, Illinois Institute of
- Technology
-
-
- License: This work is licensed under the matplotlib license( PSF
- compatible). A copy should be included with this source code.
-
-"""
-
 from __future__ import division, print_function
 import matplotlib
 from matplotlib.figure import Figure
@@ -26,6 +9,7 @@
     draw_if_interactive, show, Toolbar, backend_version
 import wx
 
+
 class FigureFrameWxAgg(FigureFrameWx):
     def get_canvas(self, fig):
         return FigureCanvasWxAgg(self, -1, fig)
@@ -40,6 +24,7 @@ def _get_toolbar(self, statbar):
             toolbar = None
         return toolbar
 
+
 class FigureCanvasWxAgg(FigureCanvasAgg, FigureCanvasWx):
     """
     The FigureCanvas contains the figure and does event handling.
@@ -105,6 +90,7 @@ def print_figure(self, filename, *args, **kwargs):
         if self._isDrawn:
             self.draw()
 
+
 class NavigationToolbar2WxAgg(NavigationToolbar2Wx):
     def get_canvas(self, frame, fig):
         return FigureCanvasWxAgg(frame, -1, fig)
@@ -200,5 +186,4 @@ def _WX28_clipped_agg_as_bitmap(agg, bbox):
     srcDC.SelectObject(wx.NullBitmap)
     destDC.SelectObject(wx.NullBitmap)
 
-    return destBmp
-
+    return destBmp
diff --git a/lib/matplotlib/cbook.py b/lib/matplotlib/cbook.py
@@ -1605,7 +1605,7 @@ class Grouper(object):
         >>> grp.join(b, c)
         >>> grp.join(d, e)
         >>> sorted(map(tuple, grp))
-        [(d, e), (a, b, c)]
+        [(a, b, c), (d, e)]
         >>> grp.joined(a, b)
         True
         >>> grp.joined(a, c)
