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

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

diff --git a/inc/3rdparty/simplepie/SimplePie/Copyright.php b/inc/3rdparty/libraries/simplepie/library/SimplePie/Copyright.php
similarity index 72%
rename from inc/3rdparty/simplepie/SimplePie/Copyright.php
rename to inc/3rdparty/libraries/simplepie/library/SimplePie/Copyright.php
index cc16f9c4717dd4e13b94ea91adfe1767e5cdc00b..57c535a64a4eb43626f74cae9766d851a92297f8 100644 (file)
--- a/inc/3rdparty/simplepie/SimplePie/Copyright.php
+++ b/inc/3rdparty/libraries/simplepie/library/SimplePie/Copyright.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,35 +33,71 @@
  * 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
  */
 
-
+/**
+ * Manages `<media:copyright>` copyright tags as defined in Media RSS
+ *
+ * Used by {@see SimplePie_Enclosure::get_copyright()}
+ *
+ * This class can be overloaded with {@see SimplePie::set_copyright_class()}
+ *
+ * @package SimplePie
+ * @subpackage API
+ */
 class SimplePie_Copyright
 {
+       /**
+        * Copyright URL
+        *
+        * @var string
+        * @see get_url()
+        */
        var $url;
+
+       /**
+        * Attribution
+        *
+        * @var string
+        * @see get_attribution()
+        */
        var $label;
 
-       // Constructor, used to input the data
+       /**
+        * Constructor, used to input the data
+        *
+        * For documentation on all the parameters, see the corresponding
+        * properties and their accessors
+        */
        public function __construct($url = null, $label = null)
        {
                $this->url = $url;
                $this->label = $label;
        }
 
+       /**
+        * String-ified version
+        *
+        * @return string
+        */
        public function __toString()
        {
                // There is no $this->data here
                return md5(serialize($this));
        }
 
+       /**
+        * Get the copyright URL
+        *
+        * @return string|null URL to copyright information
+        */
        public function get_url()
        {
                if ($this->url !== null)
@@ -74,6 +110,11 @@ class SimplePie_Copyright
                }
        }
 
+       /**
+        * Get the attribution text
+        *
+        * @return string|null
+        */
        public function get_attribution()
        {
                if ($this->label !== null)