Merge pull request #2385 from rabbitmq/shovel-rejections

Document shovel rejections

Author: michaelklishin

docs/shovel.md

@@ -59,8 +59,8 @@ and [Erlang AMQP 1.0](https://github.com/rabbitmq/rabbitmq-server/tree/main/deps
 RabbitMQ 4.2 introduced a new protocol type, the `local` shovels. Local shovels do not
 use any of the existing protocols to connect to the source or destination, but
 use an internal API to consume and/or publish directly from the queues in the local
-cluster. They can only be used on the cluster the shovel is being declared. 
-A local shovel shares most features and configuration with AMQP 0-9-1 shovels. 
+cluster. They can only be used on the cluster the shovel is being declared.
+A local shovel shares most features and configuration with AMQP 0-9-1 shovels.
 
 ## Why Use Shovel {#benefits}
 
@@ -141,6 +141,9 @@ The Shovel's consumer will [acknowledge](./confirms) messages
 automatically on receipt, after (re-)publication, or after
 [confirmation of its publication](./confirms) from the destination server.
 
+Messages rejected by the destination will be requeued in the case of AMQP 0-9-1
+and local shovels. For AMQP 1.0, messages rejected by the destination will be dropped.
+
 ### Re-publishing
 
 Most publishing and message properties are controlled by the operator.

versioned_docs/version-3.13/shovel.md

@@ -128,6 +128,9 @@ The Shovel's consumer will [acknowledge](./confirms) messages
 automatically on receipt, after (re-)publication, or after
 [confirmation of its publication](./confirms) from the destination server.
 
+Messages rejected by the destination will be requeued in the case of AMQP 0-9-1.
+For AMQP 1.0, messages rejected by the destination will be dropped.
+
 ### Re-publishing
 
 Most publishing and message properties are controlled by the operator.

versioned_docs/version-4.0/shovel.md

@@ -134,6 +134,9 @@ The Shovel's consumer will [acknowledge](./confirms) messages
 automatically on receipt, after (re-)publication, or after
 [confirmation of its publication](./confirms) from the destination server.
 
+Messages rejected by the destination will be requeued in the case of AMQP 0-9-1.
+For AMQP 1.0, messages rejected by the destination will be dropped.
+
 ### Re-publishing
 
 Most publishing and message properties are controlled by the operator.

versioned_docs/version-4.1/shovel.md

@@ -135,6 +135,9 @@ The Shovel's consumer will [acknowledge](./confirms) messages
 automatically on receipt, after (re-)publication, or after
 [confirmation of its publication](./confirms) from the destination server.
 
+Messages rejected by the destination will be requeued in the case of AMQP 0-9-1.
+For AMQP 1.0, messages rejected by the destination will be dropped.
+
 ### Re-publishing
 
 Most publishing and message properties are controlled by the operator.