[change] we now use Full-Text RSS 3.1, thank you so much @fivefilters

[github/wallabag/wallabag.git] / inc / 3rdparty / libraries / simplepie / library / SimplePie / Cache.php

diff --git a/inc/3rdparty/simplepie/SimplePie/Cache.php b/inc/3rdparty/libraries/simplepie/library/SimplePie/Cache.php
similarity index 74%
rename from inc/3rdparty/simplepie/SimplePie/Cache.php
rename to inc/3rdparty/libraries/simplepie/library/SimplePie/Cache.php
index 819ddeeaec9b6d39689b8621e32c09d7736d23f2..75586d7497ab48bd04a11dcad8abeab34bcec0ec 100644 (file)
--- a/inc/3rdparty/simplepie/SimplePie/Cache.php
+++ b/inc/3rdparty/libraries/simplepie/library/SimplePie/Cache.php
@@ -5,7 +5,7 @@
  * A PHP-Based RSS and Atom Feed Framework.
  * Takes the hard work out of managing a complete RSS/Atom solution.
  *
- * Copyright (c) 2004-2009, Ryan Parman, Geoffrey Sneddon, Ryan McCue, and contributors
+ * Copyright (c) 2004-2012, Ryan Parman, Geoffrey Sneddon, Ryan McCue, and contributors
  * All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without modification, are
@@ -33,17 +33,25 @@
  * POSSIBILITY OF SUCH DAMAGE.
  *
  * @package SimplePie
- * @version 1.3-dev
- * @copyright 2004-2010 Ryan Parman, Geoffrey Sneddon, Ryan McCue
+ * @version 1.3.1
+ * @copyright 2004-2012 Ryan Parman, Geoffrey Sneddon, Ryan McCue
  * @author Ryan Parman
  * @author Geoffrey Sneddon
  * @author Ryan McCue
  * @link http://simplepie.org/ SimplePie
  * @license http://www.opensource.org/licenses/bsd-license.php BSD License
- * @todo phpDoc comments
  */
 
-
+/**
+ * Used to create cache objects
+ *
+ * This class can be overloaded with {@see SimplePie::set_cache_class()},
+ * although the preferred way is to create your own handler
+ * via {@see register()}
+ *
+ * @package SimplePie
+ * @subpackage Caching
+ */
 class SimplePie_Cache
 {
        /**
@@ -65,8 +73,13 @@ class SimplePie_Cache
 
        /**
         * Create a new SimplePie_Cache object
+        *
+        * @param string $location URL location (scheme is used to determine handler)
+        * @param string $filename Unique identifier for cache object
+        * @param string $extension 'spi' or 'spc'
+        * @return SimplePie_Cache_Base Type of object depends on scheme of `$location`
         */
-       public static function create($location, $filename, $extension)
+       public static function get_handler($location, $filename, $extension)
        {
                $type = explode(':', $location, 2);
                $type = $type[0];
@@ -79,6 +92,17 @@ class SimplePie_Cache
                return new SimplePie_Cache_File($location, $filename, $extension);
        }
 
+       /**
+        * Create a new SimplePie_Cache object
+        *
+        * @deprecated Use {@see get_handler} instead
+        */
+       public function create($location, $filename, $extension)
+       {
+               trigger_error('Cache::create() has been replaced with Cache::get_handler(). Switch to the registry system to use this.', E_USER_DEPRECATED);
+               return self::get_handler($location, $filename, $extension);
+       }
+
        /**
         * Register a handler
         *