chore: mark connection classes and ConnectionInterface as deprecated …

…(#6616)

src/Connection/ConnectionInterface.php

@@ -20,6 +20,8 @@
 /**
  * Represents a connection to
  * [Stackdriver Logging](https://cloud.google.com/logging/).
+ *
+ * @internal
  */
 interface ConnectionInterface
 {

src/Connection/Grpc.php

@@ -33,6 +33,8 @@
 /**
  * Implementation of the
  * [Google Stackdriver Logging gRPC API](https://cloud.google.com/logging/docs/).
+ *
+ * @internal
  */
 class Grpc implements ConnectionInterface
 {

src/Connection/Rest.php

@@ -26,6 +26,8 @@
 /**
  * Implementation of the
  * [Google Stackdriver Logging JSON API](https://cloud.google.com/logging/docs/api/reference/rest/).
+ *
+ * @internal
  */
 class Rest implements ConnectionInterface
 {

src/Entry.php

@@ -17,8 +17,6 @@
 
 namespace Google\Cloud\Logging;
 
-use Google\Cloud\Logging\Connection\ConnectionInterface;
-
 /**
  * An individual entry in a log.
  *

src/Logger.php

@@ -66,6 +66,7 @@ class Logger
 
     /**
      * @var ConnectionInterface Represents a connection to Stackdriver Logging.
+     * @internal
      */
     protected $connection;
 
@@ -114,7 +115,8 @@ class Logger
 
     /**
      * @param ConnectionInterface $connection Represents a connection to
-     *        Stackdriver Logging.
+     *        Stackdriver Logging. This object is created by LoggingClient,
+     *        and should not be instantiated outside of this client.
      * @param string $name The name of the log to write entries to.
      * @param string $projectId The project's ID.
      * @param array $resource [optional] The

src/LoggingClient.php

@@ -78,6 +78,7 @@ class LoggingClient
 
     /**
      * @var ConnectionInterface Represents a connection to Stackdriver Logging.
+     * @internal
      */
     protected $connection;
 

src/Metric.php

@@ -38,6 +38,7 @@ class Metric
 {
     /**
      * @var ConnectionInterface Represents a connection to Stackdriver Logging.
+     * @internal
      */
     protected $connection;
 
@@ -58,7 +59,8 @@ class Metric
 
     /**
      * @param ConnectionInterface $connection Represents a connection to Cloud
-     *        Logging.
+     *        Logging. This object is created by LoggingClient,
+     *        and should not be instantiated outside of this client.
      * @param string $name The metric's name.
      * @param string $projectId The project's ID.
      * @param array $info [optional] The metric's metadata.

src/Sink.php

@@ -36,6 +36,7 @@ class Sink
 {
     /**
      * @var ConnectionInterface Represents a connection to Stackdriver Logging.
+     * @internal
      */
     protected $connection;
 
@@ -56,7 +57,8 @@ class Sink
 
     /**
      * @param ConnectionInterface $connection Represents a connection to Cloud
-     *        Logging.
+     *        Logging. This object is created by LoggingClient,
+     *        and should not be instantiated outside of this client.
      * @param string $name The sink's name.
      * @param string $projectId The project's ID.
      * @param array $info [optional] The sink's metadata.