First man page updates for 4.0

deps/rabbit/docs/README.md

@@ -1,29 +1,36 @@
 # Manual Pages and Documentation Extras
 
-This directory contains [CLI tool](https://rabbitmq.com/cli.html) man page sources as well as a few documentation extras:
+This directory contains [CLI tools](https://rabbitmq.com/docs/cli/) man page sources as well as a few documentation extras:
 
- * An [annotated rabbitmq.conf example](./rabbitmq.conf.example) (see [new style configuration format](https://www.rabbitmq.com/configure.html#config-file-formats))
- * An [annotated advanced.config example](./advanced.config.example) (see [The advanced.config file](https://www.rabbitmq.com/configure.html#advanced-config-file))
+ * An [annotated rabbitmq.conf example](./rabbitmq.conf.example) (see [new style configuration format](https://www.rabbitmq.com/docs/configure#config-file-formats))
+ * An [annotated advanced.config example](./advanced.config.example) (see [The advanced.config file](https://www.rabbitmq.com/docs/configure#advanced-config-file))
  * A [systemd unit file example](./rabbitmq-server.service.example)
 
-Please [see rabbitmq.com](https://rabbitmq.com/documentation.html) for documentation guides.
+Please [see rabbitmq.com](https://rabbitmq.com/docs/) for documentation guides.
 
 
-## Classic Config File Format Example
-
-Feeling nostalgic and looking for the [classic configuration file example](https://github.com/rabbitmq/rabbitmq-server/blob/v3.7.x/docs/rabbitmq.config.example)?
-Now that's old school! Keep in mind that classic configuration file **should be considered deprecated**.
-Prefer `rabbitmq.conf` (see [new style configuration format](https://www.rabbitmq.com/configure.html#config-file-formats))
-with an `advanced.config` to complement it as needed.
 
 
 ## man Pages
 
 ### Source Files
 
-This directory contains man pages that are converted to HTML using `mandoc`:
+This directory contains man pages in ntroff, the man page format.
+
+To inspect a local version, use `man`:
+
+``` shell
+man docs/rabbitmq-diagnostics.8
+
+man docs/rabbitmq-queues.8
+```
+
+
+To converted all man pages to HTML using `mandoc`:
 
-    gmake web-manpages
+``` shell
+gmake web-manpages
+```
 
 The result is then copied to the [website repository](https://github.com/rabbitmq/rabbitmq-website/tree/live/site/man)
 

deps/rabbit/docs/rabbitmq-diagnostics.8

@@ -697,10 +697,10 @@ See
 .Cm quorum_status
 in
 .Xr rabbitmq-queues 8
-.It Cm check_if_node_is_mirror_sync_critical
+.It Cm check_if_cluster_has_classic_queue_mirroring_policy
 .Pp
 See
-.Cm check_if_node_is_mirror_sync_critical
+.Cm check_if_cluster_has_classic_queue_mirroring_policy
 in
 .Xr rabbitmq-queues 8
 .It Cm check_if_node_is_quorum_critical
@@ -723,4 +723,4 @@ in
 .\" ------------------------------------------------------------------
 .Sh AUTHOR
 .\" ------------------------------------------------------------------
-.An The RabbitMQ Team Aq Mt rabbitmq-core@groups.vmware.com
+.An The RabbitMQ Team Aq Mt contact-tanzu-data.pdl@broadcom.com

deps/rabbit/docs/rabbitmq-echopid.8

@@ -67,4 +67,4 @@ The short-name form of the RabbitMQ node name.
 .\" ------------------------------------------------------------------
 .Sh AUTHOR
 .\" ------------------------------------------------------------------
-.An The RabbitMQ Team Aq Mt rabbitmq-core@groups.vmware.com
+.An The RabbitMQ Team Aq Mt contact-tanzu-data.pdl@broadcom.com

deps/rabbit/docs/rabbitmq-env.conf.5

@@ -84,4 +84,4 @@ file RabbitMQ configuration file location is changed to "/data/services/rabbitmq
 .\" ------------------------------------------------------------------
 .Sh AUTHOR
 .\" ------------------------------------------------------------------
-.An The RabbitMQ Team Aq Mt rabbitmq-core@groups.vmware.com
+.An The RabbitMQ Team Aq Mt contact-tanzu-data.pdl@broadcom.com

deps/rabbit/docs/rabbitmq-plugins.8

@@ -252,4 +252,4 @@ plugin and its dependencies and disables everything else:
 .\" ------------------------------------------------------------------
 .Sh AUTHOR
 .\" ------------------------------------------------------------------
-.An The RabbitMQ Team Aq Mt rabbitmq-core@groups.vmware.com
+.An The RabbitMQ Team Aq Mt contact-tanzu-data.pdl@broadcom.com

deps/rabbit/docs/rabbitmq-queues.8

@@ -182,13 +182,14 @@ This command is currently only supported by quorum queues.
 Example:
 .Sp
 .Dl rabbitmq-queues peek --vhost Qo a-vhost Qc Qo a-queue Qc Qo 1 Qc
-.It Cm check_if_node_is_mirror_sync_critical
+.It Cm check_if_cluster_has_classic_queue_mirroring_policy
 .Pp
-Health check that exits with a non-zero code if there are classic mirrored queues without online synchronised mirrors (queues that would potentially lose data if the target node is shut down).
+Health check that exits with a non-zero code if there are policies in the cluster that enable classic queue mirroring.
+Classic queue mirroring has been deprecated since 2021 and was completely removed in the RabbitMQ 4.0 development cycle.
 .Pp
 Example:
 .Sp
-.Dl rabbitmq-queues check_if_node_is_mirror_sync_critical
+.Dl rabbitmq-queues check_if_cluster_has_classic_queue_mirroring_policy
 .It Cm check_if_node_is_quorum_critical
 .Pp
 Health check that exits with a non-zero code if there are queues with minimum online quorum (queues that would lose their quorum if the target node is shut down).
@@ -210,4 +211,4 @@ Example:
 .\" ------------------------------------------------------------------
 .Sh AUTHOR
 .\" ------------------------------------------------------------------
-.An The RabbitMQ Team Aq Mt rabbitmq-core@groups.vmware.com
+.An The RabbitMQ Team Aq Mt contact-tanzu-data.pdl@broadcom.com

deps/rabbit/docs/rabbitmq-server.8

@@ -96,4 +96,4 @@ For example, runs RabbitMQ AMQP server in the background:
 .\" ------------------------------------------------------------------
 .Sh AUTHOR
 .\" ------------------------------------------------------------------
-.An The RabbitMQ Team Aq Mt rabbitmq-core@groups.vmware.com
+.An The RabbitMQ Team Aq Mt contact-tanzu-data.pdl@broadcom.com

deps/rabbit/docs/rabbitmq-service.8

@@ -150,4 +150,4 @@ is to discard the server output.
 .\" ------------------------------------------------------------------
 .Sh AUTHOR
 .\" ------------------------------------------------------------------
-.An The RabbitMQ Team Aq Mt rabbitmq-core@groups.vmware.com
+.An The RabbitMQ Team Aq Mt contact-tanzu-data.pdl@broadcom.com

deps/rabbit/docs/rabbitmq-streams.8

@@ -447,4 +447,4 @@ for each consumer attached to the stream-1 stream and belonging to the stream-1
 .\" ------------------------------------------------------------------
 .Sh AUTHOR
 .\" ------------------------------------------------------------------
-.An The RabbitMQ Team Aq Mt rabbitmq-core@groups.vmware.com
+.An The RabbitMQ Team Aq Mt contact-tanzu-data.pdl@broadcom.com

deps/rabbit/docs/rabbitmq-upgrade.8

@@ -127,4 +127,4 @@ To learn more, see the
 .\" ------------------------------------------------------------------
 .Sh AUTHOR
 .\" ------------------------------------------------------------------
-.An The RabbitMQ Team Aq Mt rabbitmq-core@groups.vmware.com
+.An The RabbitMQ Team Aq Mt contact-tanzu-data.pdl@broadcom.com

deps/rabbit/docs/rabbitmqctl.8

@@ -2457,4 +2457,4 @@ Reset the stats database for all nodes in the cluster.
 .\" ------------------------------------------------------------------------------------------------
 .Sh AUTHOR
 .\" ------------------------------------------------------------------------------------------------
-.An The RabbitMQ Team Aq Mt rabbitmq-core@groups.vmware.com
+.An The RabbitMQ Team Aq Mt contact-tanzu-data.pdl@broadcom.com