delete_message.rb in fog-maestrodev-1.18.0.20131126122111

- old
+ new

@@ -1,8 +1,22 @@
 module Fog
   module Rackspace
     class Queues
       class Real
+
+        # This operation immediately deletes the specified message.
+        # @note If you do not specify claim_id, but the message is claimed, the operation fails. You can only delete claimed messages by providing an appropriate claim_id.
+        #
+        # @param [String] queue_name Specifies the name of the queue.
+        # @param [String] message_id Specifies the message ID.
+        # @param [Hash] options
+        # @option options [Integer] :claim_id - Identifies the claim.
+        # @return [Excon::Response] response
+        # @raise [Fog::Rackspace::Queues::NotFound] - HTTP 404
+        # @raise [Fog::Rackspace::Queues::BadRequest] - HTTP 400
+        # @raise [Fog::Rackspace::Queues::InternalServerError] - HTTP 500
+        # @raise [Fog::Rackspace::Queues::ServiceError]
+        # @see http://docs.rackspace.com/queues/api/v1.0/cq-devguide/content/DELETE_deleteMessage__version__queues__queue_name__messages__messageId__message-operations-dle001.html
         def delete_message(queue_name, message_id, options = {})
           query = {}
           query[:claim_id] = options[:claim_id] if options.has_key? :claim_id
           request(
             :expects => 204,