Cleanup all the @see's

thephpleague · Nov 1, 2018 · 301f680 · 301f680
1 parent 8b9f038
commit 301f680
Show file tree

Hide file tree

Showing 17 changed files with 4 additions and 34 deletions.
diff --git a/src/Common/AbstractGateway.php b/src/Common/AbstractGateway.php
@@ -40,7 +40,6 @@
  *
  * For further code examples see the *omnipay-example* repository on github.
  *
- * @see GatewayInterface
  */
 abstract class AbstractGateway implements GatewayInterface
 {
@@ -290,7 +289,6 @@ public function supportsUpdateCard()
      *   $myRequest = $gw->myRequest($someParameters);
      * </code>
      *
-     * @see \Omnipay\Common\Message\AbstractRequest
      * @param string $class The request class name
      * @param array $parameters
      * @return \Omnipay\Common\Message\AbstractRequest

diff --git a/src/Common/CreditCard.php b/src/Common/CreditCard.php
@@ -151,7 +151,6 @@ public function __construct($parameters = null)
      * Note: The fact that this class knows about a particular card brand does not imply
      * that your gateway supports it.
      *
-     * @see self::$supported_cards
      * @return array
      */
     public function getSupportedBrands()

diff --git a/src/Common/GatewayFactory.php b/src/Common/GatewayFactory.php
@@ -26,7 +26,6 @@
  *   $gateway = Omnipay::create('ExpressGateway');
  * </code>
  *
- * @see Omnipay\Omnipay
  */
 class GatewayFactory
 {

diff --git a/src/Common/GatewayInterface.php b/src/Common/GatewayInterface.php
@@ -11,7 +11,6 @@
  * This interface class defines the standard functions that any
  * Omnipay gateway needs to define.
  *
- * @see AbstractGateway
  *
  * @method \Omnipay\Common\Message\NotificationInterface acceptNotification(array $options = array()) (Optional method)
  *         Receive and handle an instant payment notification (IPN)

diff --git a/src/Common/Issuer.php b/src/Common/Issuer.php
@@ -29,18 +29,14 @@ class Issuer
 
     /**
      * The ID of a payment method that the issuer belongs to.
-     *
-     * @see PaymentMethod
-     *
+     **
      * @var string
      */
     protected $paymentMethod;
 
     /**
      * Create a new Issuer
      *
-     * @see PaymentMethod
-     *
      * @param string      $id            The identifier of this issuer
      * @param string      $name          The name of this issuer
      * @param string|null $paymentMethod The ID of a payment method this issuer belongs to
@@ -75,8 +71,6 @@ public function getName()
     /**
      * The ID of a payment method this issuer belongs to
      *
-     * @see PaymentMethod
-     *
      * @return string
      */
     public function getPaymentMethod()

diff --git a/src/Common/Item.php b/src/Common/Item.php
@@ -12,7 +12,6 @@
  *
  * This class defines a single cart item in the Omnipay system.
  *
- * @see ItemInterface
  */
 class Item implements ItemInterface
 {

diff --git a/src/Common/ItemBag.php b/src/Common/ItemBag.php
@@ -11,14 +11,12 @@
  * This class defines a bag (multi element set or array) of single cart items
  * in the Omnipay system.
  *
- * @see Item
  */
 class ItemBag implements \IteratorAggregate, \Countable
 {
     /**
      * Item storage
      *
-     * @see Item
      *
      * @var array
      */
@@ -37,7 +35,6 @@ public function __construct(array $items = array())
     /**
      * Return all the items
      *
-     * @see Item
      *
      * @return array An array of items
      */
@@ -49,7 +46,6 @@ public function all()
     /**
      * Replace the contents of this bag with the specified items
      *
-     * @see Item
      *
      * @param array $items An array of items
      */
@@ -65,7 +61,6 @@ public function replace(array $items = array())
     /**
      * Add an item to the bag
      *
-     * @see Item
      *
      * @param ItemInterface|array $item An existing item, or associative array of item parameters
      */

diff --git a/src/Common/Message/AbstractRequest.php b/src/Common/Message/AbstractRequest.php
@@ -62,8 +62,6 @@
  *   // now do something with the $myResponse object, test for success, etc.
  * </code>
  *
- * @see RequestInterface
- * @see AbstractResponse
  */
 abstract class AbstractRequest implements RequestInterface
 {

diff --git a/src/Common/Message/AbstractResponse.php b/src/Common/Message/AbstractResponse.php
@@ -26,7 +26,6 @@
  *   // now do something with the $myResponse object, test for success, etc.
  * </code>
  *
- * @see ResponseInterface
  */
 abstract class AbstractResponse implements ResponseInterface
 {

diff --git a/src/Common/Message/FetchIssuersResponseInterface.php b/src/Common/Message/FetchIssuersResponseInterface.php
@@ -15,8 +15,6 @@
  * This happens when the gateway needs the customer to choose a
  * card issuer.
  *
- * @see ResponseInterface
- * @see Omnipay\Common\Issuer
  */
 interface FetchIssuersResponseInterface extends ResponseInterface
 {

diff --git a/src/Common/Message/FetchPaymentMethodsResponseInterface.php b/src/Common/Message/FetchPaymentMethodsResponseInterface.php
@@ -15,8 +15,6 @@
  * This happens when the gateway needs the customer to choose a
  * payment method.
  *
- * @see ResponseInterface
- * @see Omnipay\Common\PaymentMethod
  */
 interface FetchPaymentMethodsResponseInterface extends ResponseInterface
 {

diff --git a/src/Common/Message/NotificationInterface.php b/src/Common/Message/NotificationInterface.php
@@ -21,8 +21,8 @@ public function getTransactionReference();
     /**
      * Was the transaction successful?
      *
-     * @return string Transaction status, one of {@see STATUS_COMPLETED}, {@see #STATUS_PENDING},
-     * or {@see #STATUS_FAILED}.
+     * @return string Transaction status, one of {@link NotificationInterface::STATUS_COMPLETED},
+     * {@link NotificationInterface::STATUS_PENDING}, or {@link NotificationInterface::STATUS_FAILED}.
      */
     public function getTransactionStatus();
 

diff --git a/src/Common/Message/RedirectResponseInterface.php b/src/Common/Message/RedirectResponseInterface.php
@@ -13,7 +13,6 @@
  * interface class with some extra functions relating to the
  * specifics of a redirect response from the gateway.
  *
- * @see ResponseInterface
  */
 interface RedirectResponseInterface extends ResponseInterface
 {

diff --git a/src/Common/Message/RequestInterface.php b/src/Common/Message/RequestInterface.php
@@ -11,7 +11,6 @@
  * This interface class defines the standard functions that any Omnipay request
  * interface needs to be able to provide.  It is an extension of MessageInterface.
  *
- * @see MessageInterface
  */
 interface RequestInterface extends MessageInterface
 {

diff --git a/src/Common/Message/ResponseInterface.php b/src/Common/Message/ResponseInterface.php
@@ -11,7 +11,6 @@
  * This interface class defines the standard functions that any Omnipay response
  * interface needs to be able to provide.  It is an extension of MessageInterface.
  *
- * @see MessageInterface
  */
 interface ResponseInterface extends MessageInterface
 {

diff --git a/src/Common/PaymentMethod.php b/src/Common/PaymentMethod.php
@@ -10,7 +10,6 @@
  *
  * This class defines a payment method to be used in the Omnipay system.
  *
- * @see Issuer
  */
 class PaymentMethod
 {
@@ -19,8 +18,6 @@ class PaymentMethod
      * The ID of the payment method.  Used as the payment method ID in the
      * Issuer class.
      *
-     * @see Issuer
-     *
      * @var string
      */
     protected $id;

diff --git a/src/Omnipay.php b/src/Omnipay.php
@@ -50,7 +50,7 @@
  * @method static \Omnipay\Common\GatewayInterface create(string $class, ClientInterface $httpClient = null, \Symfony\Component\HttpFoundation\Request $httpRequest = null)
  * @codingStandardsIgnoreEnd
  *
- * @see Omnipay\Common\GatewayFactory
+ * @see \Omnipay\Common\GatewayFactory
  */
 class Omnipay
 {