Repository: flutter
Issue: embedder.h issues documentation warnings
Labels: engine,P2,team-engine,triaged-engine

The following warnings manifest when importing `embedder.h` in the xcode 14.1:

```
In file included from /Users/aaclarke/dev/unity/HelloFlutter/Plugin/src/plugin.mm:5:
/Users/aaclarke/dev/unity/HelloFlutter/Plugin/src/flutter/embedder.h:1687:8: warning: declaration is marked with '@deprecated' command but does not have a deprecation attribute [-Wdocumentation-deprecated-sync]
  /// @deprecated     As of Dart 2, running from Dart source is no longer
      ~^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
/Users/aaclarke/dev/unity/HelloFlutter/Plugin/src/flutter/embedder.h:1697:8: warning: declaration is marked with '@deprecated' command but does not have a deprecation attribute [-Wdocumentation-deprecated-sync]
  /// @deprecated    As of Dart 2, running from Dart source is no longer
      ~^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
/Users/aaclarke/dev/unity/HelloFlutter/Plugin/src/flutter/embedder.h:1775:8: warning: declaration is marked with '@deprecated' command but does not have a deprecation attribute [-Wdocumentation-deprecated-sync]
  /// @deprecated    Prefer using `update_semantics_callback` instead. If this
      ~^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
/Users/aaclarke/dev/unity/HelloFlutter/Plugin/src/flutter/embedder.h:1789:8: warning: declaration is marked with '@deprecated' command but does not have a deprecation attribute [-Wdocumentation-deprecated-sync]
  /// @deprecated    Prefer using `update_semantics_callback` instead. If this
      ~^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
/Users/aaclarke/dev/unity/HelloFlutter/Plugin/src/flutter/embedder.h:2204:6: warning: declaration is marked with '@deprecated' command but does not have a deprecation attribute [-Wdocumentation-deprecated-sync]
/// @deprecated This API will be deprecated and is not part of the stable API.
    ~^~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
/Users/aaclarke/dev/unity/HelloFlutter/Plugin/src/flutter/embedder.h:2213:1: note: add a deprecation attribute to the declaration to silence this warning
FlutterEngineResult __FlutterEngineFlushPendingTasksNow();
^
MD_DEPRECATED 
/Users/aaclarke/dev/unity/HelloFlutter/Plugin/src/flutter/embedder.h:2335:17: warning: parameter 'engine.' not found in the function declaration [-Wdocumentation]
/// @param[in]  engine.                  A running engine instance.
                ^~~~~~~
/Users/aaclarke/dev/unity/HelloFlutter/Plugin/src/flutter/embedder.h:2335:17: note: did you mean 'engine'?
/// @param[in]  engine.                  A running engine instance.
                ^~~~~~~
                engine
/Users/aaclarke/dev/unity/HelloFlutter/Plugin/src/flutter/embedder.h:2364:17: warning: parameter 'engine.' not found in the function declaration [-Wdocumentation]
/// @param[in]  engine.                  A running engine instance.
                ^~~~~~~
/Users/aaclarke/dev/unity/HelloFlutter/Plugin/src/flutter/embedder.h:2364:17: note: did you mean 'engine'?
/// @param[in]  engine.                  A running engine instance.
                ^~~~~~~
                engine
```