From 5d625c2231fbe98b2ed31d00659d7753a04671c7 Mon Sep 17 00:00:00 2001
From: Sullivan SENECHAL <soullivaneuh@gmail.com>
Date: Mon, 7 Dec 2015 15:20:46 +0100
Subject: [PATCH] Improve PHPDoc for package requires

---
 src/Composer/Package/AliasPackage.php         | 11 ++++++++---
 src/Composer/Package/Package.php              | 15 ++++++++++-----
 src/Composer/Package/RootPackageInterface.php | 10 +++++-----
 3 files changed, 23 insertions(+), 13 deletions(-)

diff --git a/src/Composer/Package/AliasPackage.php b/src/Composer/Package/AliasPackage.php
index c4c5346df..f6849a234 100644
--- a/src/Composer/Package/AliasPackage.php
+++ b/src/Composer/Package/AliasPackage.php
@@ -27,10 +27,15 @@ class AliasPackage extends BasePackage implements CompletePackageInterface
     protected $rootPackageAlias = false;
     protected $stability;
 
+    /** @var Link[] */
     protected $requires;
+    /** @var Link[] */
     protected $devRequires;
+    /** @var Link[] */
     protected $conflicts;
+    /** @var Link[] */
     protected $provides;
+    /** @var Link[] */
     protected $replaces;
 
     /**
@@ -160,10 +165,10 @@ class AliasPackage extends BasePackage implements CompletePackageInterface
     }
 
     /**
-     * @param array  $links
+     * @param Link[]  $links
      * @param string $linkType
-     * @internal param string $prettyVersion
-     * @return array
+     *
+     * @return Link[]
      */
     protected function replaceSelfVersionDependencies(array $links, $linkType)
     {
diff --git a/src/Composer/Package/Package.php b/src/Composer/Package/Package.php
index 7f813887e..03d595f3b 100644
--- a/src/Composer/Package/Package.php
+++ b/src/Composer/Package/Package.php
@@ -43,10 +43,15 @@ class Package extends BasePackage
     protected $stability;
     protected $notificationUrl;
 
+    /** @var Link[] */
     protected $requires = array();
+    /** @var Link[] */
     protected $conflicts = array();
+    /** @var Link[] */
     protected $provides = array();
+    /** @var Link[] */
     protected $replaces = array();
+    /** @var Link[] */
     protected $devRequires = array();
     protected $suggests = array();
     protected $autoload = array();
@@ -369,7 +374,7 @@ class Package extends BasePackage
     /**
      * Set the required packages
      *
-     * @param array $requires A set of package links
+     * @param Link[] $requires A set of package links
      */
     public function setRequires(array $requires)
     {
@@ -387,7 +392,7 @@ class Package extends BasePackage
     /**
      * Set the conflicting packages
      *
-     * @param array $conflicts A set of package links
+     * @param Link[] $conflicts A set of package links
      */
     public function setConflicts(array $conflicts)
     {
@@ -405,7 +410,7 @@ class Package extends BasePackage
     /**
      * Set the provided virtual packages
      *
-     * @param array $provides A set of package links
+     * @param Link[] $provides A set of package links
      */
     public function setProvides(array $provides)
     {
@@ -423,7 +428,7 @@ class Package extends BasePackage
     /**
      * Set the packages this one replaces
      *
-     * @param array $replaces A set of package links
+     * @param Link[] $replaces A set of package links
      */
     public function setReplaces(array $replaces)
     {
@@ -441,7 +446,7 @@ class Package extends BasePackage
     /**
      * Set the recommended packages
      *
-     * @param array $devRequires A set of package links
+     * @param Link[] $devRequires A set of package links
      */
     public function setDevRequires(array $devRequires)
     {
diff --git a/src/Composer/Package/RootPackageInterface.php b/src/Composer/Package/RootPackageInterface.php
index 5f59a3717..c1cf8c1be 100644
--- a/src/Composer/Package/RootPackageInterface.php
+++ b/src/Composer/Package/RootPackageInterface.php
@@ -61,35 +61,35 @@ interface RootPackageInterface extends CompletePackageInterface
     /**
      * Set the required packages
      *
-     * @param array $requires A set of package links
+     * @param Link[] $requires A set of package links
      */
     public function setRequires(array $requires);
 
     /**
      * Set the recommended packages
      *
-     * @param array $devRequires A set of package links
+     * @param Link[] $devRequires A set of package links
      */
     public function setDevRequires(array $devRequires);
 
     /**
      * Set the conflicting packages
      *
-     * @param array $conflicts A set of package links
+     * @param Link[] $conflicts A set of package links
      */
     public function setConflicts(array $conflicts);
 
     /**
      * Set the provided virtual packages
      *
-     * @param array $provides A set of package links
+     * @param Link[] $provides A set of package links
      */
     public function setProvides(array $provides);
 
     /**
      * Set the packages this one replaces
      *
-     * @param array $replaces A set of package links
+     * @param Link[] $replaces A set of package links
      */
     public function setReplaces(array $replaces);