Add docblocks for classes and interfaces in Ramsey\Uuid\Generator namespace

src/Generator/TimeGeneratorInterface.php

@@ -14,21 +14,22 @@
 
 namespace Ramsey\Uuid\Generator;
 
+/**
+ * TimeGeneratorInterface provides functionality to generate strings of binary
+ * data for version 1 UUIDs based on a host ID, sequence number, and the current
+ * time
+ */
 interface TimeGeneratorInterface
 {
     /**
-     * Generate a version 1 UUID from a host ID, sequence number, and the current time.
-     *
-     * If $node is not given, we will attempt to obtain the local hardware
-     * address. If $clockSeq is given, it is used as the sequence number;
-     * otherwise a random 14-bit sequence number is chosen.
+     * Generate a version 1 UUID from a host ID, sequence number, and the current time
      *
      * @param int|string $node A 48-bit number representing the hardware address
      *     This number may be represented as an integer or a hexadecimal string.
      * @param int $clockSeq A 14-bit number used to help avoid duplicates that
      *     could arise when the clock is set backwards in time or if the node ID
      *     changes.
-     * @return string A 16-byte binary string representing a UUID
+     * @return string A binary string
      */
     public function generate($node = null, $clockSeq = null);
 }