Documentation Issue: Parameter 'selected_port[out]' not found in the function declaration 6.31.0

[gilrodar]

[REQUIRED] Step 1: Describe your environment

• Xcode version: 11.6
• Firebase SDK version: 6.31.0
• Firebase Component: Firestore
• Component version: 1.17.0
• Installation method: CocoaPods

[REQUIRED] Step 2: Describe the problem

When you run the application, this message appears

"Parameter 'selected_port[out]' not found in the function declaration"
"Did you mean 'selected_port'?"

[paulb777]

Might be worth another try to remove this --allow-warnings? Since it catches this problem - https://github.com/firebase/firebase-ios-sdk/blob/master/.github/workflows/firestore.yml#L186

[dconeybe]

Hi @gilrodar! The warning about selected_port is actually from one of Firestore's dependencies, specifically grpc. Here is where it comes from:

https://github.com/grpc/grpc/blob/dca24b8de56272111365a2a3521f59734da9990e/include/grpcpp/server_builder.h#L131

Please open an issue in the grpc repository so that the appropriate people can prioritize and address it. Since there is no action in this repository, I'm going to close this ticket. Feel free to re-open if you feel that this resolution is inadequate.

[dconeybe]

Actually, my colleague @wilhuff pointed out to me that we can suppress this warning in Firestore using SUPPRESS_DOCUMENTATION_WARNINGS_BEGIN from

firebase-ios-sdk/Firestore/core/src/util/warnings.h

Line 72 in bdf84c0

#define SUPPRESS_DOCUMENTATION_WARNINGS_BEGIN() \

I'll open a PR to make the required change to suppress the warning.