From f9d3d9f458c93797942e880554c5ef784e04a4a7 Mon Sep 17 00:00:00 2001
From: Julien Viet <julien@julienviet.com>
Date: Mon, 5 Jun 2023 16:28:32 +0200
Subject: [PATCH] Improve documentation about Mac native dependencies.

---
 src/main/asciidoc/index.adoc                  | 12 +++++++++
 .../override/hostname-resolution.adoc         | 26 ++++++++++++++++++-
 2 files changed, 37 insertions(+), 1 deletion(-)

diff --git a/src/main/asciidoc/index.adoc b/src/main/asciidoc/index.adoc
index 15df2dbc10f..c691b5355d8 100644
--- a/src/main/asciidoc/index.adoc
+++ b/src/main/asciidoc/index.adoc
@@ -1285,6 +1285,7 @@ Native on Linux gives you extra networking options:
 
 You need to add the following dependency in your classpath:
 
+.Intel-based Mac
 [source,xml]
 ----
 <dependency>
@@ -1295,6 +1296,17 @@ You need to add the following dependency in your classpath:
 </dependency>
 ----
 
+.M1/M2 Mac
+[source,xml]
+----
+<dependency>
+<groupId>io.netty</groupId>
+<artifactId>netty-transport-native-kqueue</artifactId>
+<classifier>osx-aarch_64</classifier>
+<!--<version>Should align with netty version that Vert.x uses</version>-->
+</dependency>
+----
+
 MacOS Sierra and above are supported.
 
 Native on BSD gives you extra networking options:
diff --git a/src/main/asciidoc/override/hostname-resolution.adoc b/src/main/asciidoc/override/hostname-resolution.adoc
index dc81c292d4d..e5a53ca2f81 100644
--- a/src/main/asciidoc/override/hostname-resolution.adoc
+++ b/src/main/asciidoc/override/hostname-resolution.adoc
@@ -80,13 +80,15 @@ This extension is not required as its absence does not prevent Vert.x to execute
 
 You can use add it to your classpath to improve the integration and remove the warning.
 
+.Intel-based Mac
 [source,xml]
 ----
 <profile>
-  <id>mac</id>
+  <id>mac-intel</id>
   <activation>
     <os>
       <family>mac</family>
+      <arch>x86_64</arch>
     </os>
   </activation>
   <dependencies>
@@ -99,3 +101,25 @@ You can use add it to your classpath to improve the integration and remove the w
   </dependencies>
 </profile>
 ----
+
+.M1/M2 Mac
+[source,xml]
+----
+<profile>
+  <id>mac-silicon</id>
+  <activation>
+    <os>
+      <family>mac</family>
+      <arch>aarch64</arch>
+    </os>
+  </activation>
+  <dependencies>
+    <dependency>
+      <groupId>io.netty</groupId>
+      <artifactId>netty-resolver-dns-native-macos</artifactId>
+      <classifier>osx-aarch_64</classifier>
+      <!--<version>Should align with netty version that Vert.x uses</version>-->
+    </dependency>
+  </dependencies>
+</profile>
+----