[Summary view] [Print] [Text view]

   1  PEAR Libraries
   2  ====================================================================
   3  
   4  
   5  This directory (lib/pear) contains unmodified copies of some
   6  libraries from the standard PEAR distribution (http://pear.php.net).
   7  
   8  We include these in Moodle solely for the convenience of sites that
   9  may not have PEAR installed.
  10  
  11  If this directory is DELETED from Moodle then Moodle will search
  12  the standard PHP directories and use the PEAR libraries there instead.
  13  
  14  
  15  In detail, the libraries added here are:
  16  
  17  - PEAR HTML_Quickform:
  18      - Current version: 3.2.6
  19      - by Bertrand Mansion, Adam Daniel, Alexey Borzov
  20      - License: PHP (Permission given to Moodle to redistribute under GPL)
  21      - http://pear.php.net/package/HTML_Quickform
  22  - PEAR HTML_Quickform_Renderer_Tableless:
  23      - Current version: 0.3.4
  24      - by Mark Wiesemann
  25      - License: PHP (Permission given to Moodle to redistribute under GPL)
  26      - http://pear.php.net/package/HTML_QuickForm_Renderer_Tableless
  27  - PEAR HTML_QuickForm_DHTMLRulesTableless:
  28      - Current version: 0.1.2
  29      - by Alexey Borzov, Adam Daniel, Bertrand Mansion, Justin Patrin, Mark Wiesemann
  30      - License: PHP (Permission given to Moodle to redistribute under GPL)
  31      - http://pear.php.net/package/HTML_QuickForm_DHTMLRulesTableless
  32  - PEAR HTML_Common:
  33      - Current version: 1.2.2
  34      - by Adam Daniel, Bertrand Mansion, Klaus Guenther, Alexey Borzov,
  35      - License: PHP  (Permission given to Moodle to redistribute under GPL)
  36      - http://pear.php.net/package/HTML
  37  - PEAR main class:
  38      - Current version: 1.4.5
  39      - by Stig Bakken, Thomas V.V.Cox, Pierre-Alain Joye,
  40        Greg Beaver and Martin Jansen
  41      - License: PHP
  42      - http://pear.php.net/package/PEAR
  43  - PEAR HTML_AJAX:
  44      - Current version: 0.5.6
  45      - by Elizabeth Smith, Arpad Ray, Joshua Eichorn, David Coallier and Laurent Yaish
  46      - License: LGPL
  47      - http://pear.php.net/package/HTML_AJAX/
  48  - PEAR Auth_RADIUS:
  49      - Current version: 1.1.0 (2015-02-10)
  50      - by Michael Bretterklieber
  51      - License: BSD
  52      - http://pear.php.net/package/Auth_RADIUS
  53  - PEAR Crypt_CHAP:
  54      - Current Version: 1.0.1 (2007-03-14)
  55      - by Michael Bretterklieber
  56      - License: BSD
  57      - http://pear.php.net/package/Crypt_CHAP
  58  
  59  ----------------------------------------------------------------
  60  A NOTE TO DEVELOPERS
  61  ================================================================
  62  
  63  We must not use these classes directly ever. Instead we must build
  64  and use wrapper classes to isolate Moodle code from internal PEAR
  65  implementations, allowing us to migrate if needed to other
  66  libraries in the future. For an example of wrapped classes,
  67  see the excel.class.lib file, that includes code to build
  68  Excel files using the cool library inside PEAR, but using
  69  the old calls used before Moodle 1.6 to maintain compatibility.
  70  
  71  Please, don't forget it! Always use wrapper classes/functions!
  72  
  73  Ciao,
  74  Eloy Lafuente, 2005-12-17 :-)
  75  
  76  
  77  
  78  ----------------------------------------------------------------
  79  A NOTE ON THE PHP LICENSE AND MOODLE
  80  ================================================================
  81  
  82  Everything in Moodle in pure GPL.  This pear directory is the only
  83  part of the distribution that is not.
  84  
  85  There is some question about how PHP-licensed software can be
  86  included within a GPL-licensed distribution like Moodle, specifically
  87  the clause that annoyingly says no derivative of the software can
  88  include the name PHP.
  89  
  90  We don't intend to rename Moodle to anything of the sort, obviously,
  91  but to help people downstream who could possibly want to do so,
  92  we have sought special permission from the authors of these classes
  93  to allow us an exemption on this point so that we don't need to
  94  change our nice clean GPL license.
  95  
  96  Several authors have given Moodle explicit permission to distribute
  97  their PHP-licensed PEAR classes in the Moodle distribution, allowing
  98  anybody using these classes ONLY as part of the Moodle distribution
  99  exemption from clauses of the PHP license that could cause
 100  conflict with the main GNU Public License that Moodle uses.
 101  
 102  We are still waiting to hear back from the others but we assume
 103  for now that it will likewise be OK.
 104  
 105  If you are at all worried about this situation you can simply delete
 106  this directory from Moodle and it will use your installed PEAR
 107  libraries instead.
 108  
 109  Cheers,
 110  Martin Dougiamas, 2 April 2006