Mark SOCKET_WEBRTC as deprecated (emscripten-core#27371)

See emscripten-core#27366

If we don't get any feedback after a few releases we can followup with emscripten-core#27367.

Author: sbc100

site/source/docs/tools_reference/settings_reference.rst

@@ -563,6 +563,8 @@ You can set 'subprotocol' to null, if you don't want to specify it.
 Run time configuration may be useful as it lets an application select
 multiple different services.
 
+.. note:: This setting is deprecated
+
 Default value: false
 
 .. _websocket_url:
@@ -3542,6 +3544,7 @@ these settings please open a bug (or reply to one of the existing bugs).
  - ``DETERMINISTIC``: under consideration for removal (https://github.com/emscripten-core/emscripten/issues/26647)
  - ``USE_PTHREADS``: prefer the standard -pthread flag
  - ``MEMORY64``: prefer the standard -m64 or --target=wasm64 flags
+ - ``SOCKET_WEBRTC``: under consideration for removal (https://github.com/emscripten-core/emscripten/issues/27366)
 
 .. _legacy-settings:
 

src/settings.js

@@ -404,6 +404,7 @@ var FS_DEBUG = false;
 // Run time configuration may be useful as it lets an application select
 // multiple different services.
 // [link]
+// [deprecated]
 var SOCKET_WEBRTC = false;
 
 // A string containing either a WebSocket URL prefix (ws:// or wss://) or a

tools/settings.py

@@ -117,6 +117,7 @@
     'DETERMINISTIC': 'under consideration for removal (https://github.com/emscripten-core/emscripten/issues/26647)',
     'USE_PTHREADS': 'prefer the standard -pthread flag',
     'MEMORY64': 'prefer the standard -m64 or --target=wasm64 flags',
+    'SOCKET_WEBRTC': 'under consideration for removal (https://github.com/emscripten-core/emscripten/issues/27366)',
 }
 
 # Settings that don't need to be externalized when serializing to json because they