   # Public: Read the text from the clipboard and return both the text and the
   # associated metadata.
   #
-  # Returns an {Object} with a `text` key and a `metadata` key if it has
-  # associated metadata.
+  # Returns an {Object} with the following keys:
+  #   :text - The {String} clipboard text.
+  #   :metadata - The metadata stored by an earlier call to {.write}.
   readWithMetadata: ->
     text = @read()
     if @signatureForMetadata is @md5(text)


  # Creates an `md5` hash of some text.
  #
  # * text: A {String} to hash.
  #
  # Returns a hashed {String}.
  md5: (text) ->

  # The metadata associated with the text is available by calling
  # {.readWithMetadata}.
  #
  # text - The {String} to store.
  # metadata - The additional info to associate with the text.
  write: (text, metadata) ->
    @signatureForMetadata = @md5(text)
    @metadata = metadata
