From 6587adfd7e630934b0b4f984b4650b3d4dc39097 Mon Sep 17 00:00:00 2001
From: Boris Zbarsky <bzbarsky@apple.com>
Date: Wed, 8 Nov 2023 19:25:25 -0500
Subject: [PATCH] Disable -Wdocumentation for libwebsocket. (#30341)

It triggers tens of thousands of those warnings.

For the Xcode build of darwin-framework-tool, this just disables -Wdocumentation
across the board, since I don't see a way to do it for particular files.
---
 examples/common/websocket-server/BUILD.gn          |  8 ++++++--
 .../Framework/Matter.xcodeproj/project.pbxproj     | 14 ++++++++++++++
 2 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/examples/common/websocket-server/BUILD.gn b/examples/common/websocket-server/BUILD.gn
index d3f2aa35ff8ac9..1ea2687ce6afda 100644
--- a/examples/common/websocket-server/BUILD.gn
+++ b/examples/common/websocket-server/BUILD.gn
@@ -16,8 +16,12 @@ import("//build_overrides/build.gni")
 import("//build_overrides/chip.gni")
 
 config("websocket_server_config_disable_warnings") {
-  # Unfortunately, some of the libwebsockets headers include -Wshadow failures.
-  cflags = [ "-Wno-shadow" ]
+  # Unfortunately, some of the libwebsockets headers include -Wshadow failures,
+  # and have tons of -Wdocumentation issues.
+  cflags = [
+    "-Wno-shadow",
+    "-Wno-documentation",
+  ]
 }
 
 static_library("websocket-server") {
diff --git a/src/darwin/Framework/Matter.xcodeproj/project.pbxproj b/src/darwin/Framework/Matter.xcodeproj/project.pbxproj
index 68816fa9dd27b1..a7f00d50661487 100644
--- a/src/darwin/Framework/Matter.xcodeproj/project.pbxproj
+++ b/src/darwin/Framework/Matter.xcodeproj/project.pbxproj
@@ -1901,6 +1901,13 @@
 				SDKROOT = macosx;
 				STRIP_INSTALLED_PRODUCT = NO;
 				USER_HEADER_SEARCH_PATHS = "";
+				WARNING_CFLAGS = (
+					"-Wformat",
+					"-Wformat-nonliteral",
+					"-Wformat-security",
+					"-Wconversion",
+					"-Wno-documentation",
+				);
 			};
 			name = Debug;
 		};
@@ -1970,6 +1977,13 @@
 				PROVISIONING_PROFILE_SPECIFIER = "";
 				SDKROOT = macosx;
 				USER_HEADER_SEARCH_PATHS = "";
+				WARNING_CFLAGS = (
+					"-Wformat",
+					"-Wformat-nonliteral",
+					"-Wformat-security",
+					"-Wconversion",
+					"-Wno-documentation",
+				);
 			};
 			name = Release;
 		};