Merge pull request #2379 from rabbitmq/no-ack-autodelete-shovels

Shovels: document delete-after & no-ack incompatibility

Author: michaelklishin

docs/shovel-dynamic.md

@@ -588,7 +588,8 @@ the declaration process.
         </div>
         <div>
           If set to an integer, then the shovel will transfer that
-          number of messages before deleting itself.
+          number of messages before deleting itself. This option cannot
+          be used together with <code>ack-mode</code> set to <code>no-ack</code>.
         </div>
       </td>
     </tr>
@@ -838,15 +839,10 @@ counterparts.
           The default is <code>never</code>, meaning the
           shovel should never delete itself.
         </div>
-        <div>
-          If set to <code>queue-length</code> then the shovel will
-          measure the length of the source queue when starting up,
-          and delete itself after it has transferred that many
-          messages.
-        </div>
         <div>
           If set to an integer, then the shovel will transfer that
-          number of messages before deleting itself.
+          number of messages before deleting itself. This option cannot
+          be used in conjunction with <code>ack-mode</code>: <code>no-ack</code>.
         </div>
       </td>
     </tr>
@@ -922,7 +918,8 @@ the declaration process.
         </div>
         <div>
           If set to an integer, then the shovel will transfer that
-          number of messages before deleting itself.
+          number of messages before deleting itself. This option cannot
+          be used in conjunction with <code>ack-mode : no-ack</code>.
         </div>
       </td>
     </tr>

versioned_docs/version-3.13/shovel-dynamic.md

@@ -534,7 +534,8 @@ the declaration process.
       </div>
       <div>
       If set to an integer, then the shovel will transfer that
-      number of messages before deleting itself.
+      number of messages before deleting itself. This option cannot
+      be used together with <code>ack-mode</code> set to <code>no-ack</code>.
       </div>
       </td>
     </tr>
@@ -792,14 +793,9 @@ counterparts.
       shovel should never delete itself.
       </div>
       <div>
-      If set to <code>queue-length</code> then the shovel will
-      measure the length of the source queue when starting up,
-      and delete itself after it has transferred that many
-      messages.
-      </div>
-      <div>
       If set to an integer, then the shovel will transfer that
-      number of messages before deleting itself.
+      number of messages before deleting itself. This option cannot
+      be used in conjunction with <code>ack-mode</code>: <code>no-ack</code>.
       </div>
       </td>
     </tr>

versioned_docs/version-4.0/shovel-dynamic.md

@@ -598,7 +598,8 @@ the declaration process.
       </div>
       <div>
       If set to an integer, then the shovel will transfer that
-      number of messages before deleting itself.
+      number of messages before deleting itself. This option cannot
+      be used together with <code>ack-mode</code> set to <code>no-ack</code>.
       </div>
       </td>
     </tr>
@@ -855,14 +856,9 @@ counterparts.
       shovel should never delete itself.
       </div>
       <div>
-      If set to <code>queue-length</code> then the shovel will
-      measure the length of the source queue when starting up,
-      and delete itself after it has transferred that many
-      messages.
-      </div>
-      <div>
       If set to an integer, then the shovel will transfer that
-      number of messages before deleting itself.
+      number of messages before deleting itself. This option cannot
+      be used in conjunction with <code>ack-mode</code>: <code>no-ack</code>.
       </div>
       </td>
     </tr>

versioned_docs/version-4.1/shovel-dynamic.md

@@ -598,7 +598,8 @@ the declaration process.
       </div>
       <div>
       If set to an integer, then the shovel will transfer that
-      number of messages before deleting itself.
+      number of messages before deleting itself. This option cannot
+      be used together with <code>ack-mode</code> set to <code>no-ack</code>.
       </div>
       </td>
     </tr>
@@ -855,14 +856,9 @@ counterparts.
       shovel should never delete itself.
       </div>
       <div>
-      If set to <code>queue-length</code> then the shovel will
-      measure the length of the source queue when starting up,
-      and delete itself after it has transferred that many
-      messages.
-      </div>
-      <div>
       If set to an integer, then the shovel will transfer that
-      number of messages before deleting itself.
+      number of messages before deleting itself. This option cannot
+      be used in conjunction with <code>ack-mode</code>: <code>no-ack</code>.
       </div>
       </td>
     </tr>