broadcom-wl: updated documentation

Author: masrlinu

apple/imac/14-2/README.md

@@ -20,6 +20,12 @@
 
 ## Wifi
 - [x] ok
+> **Note:** Enabling WiFi and Bluetooth functionality on this hardware requires the proprietary Broadcom driver. Due to outstanding security issues, you need to explicitly opt-in by setting:
+>
+> ```nix
+> hardware.broadcom.wifi.enableLegacyDriverWithKnownVulnerabilities = true;
+> ```
+
 
 ## Graphics
 - [x] Latest unsupported Nvidia drivers available are 390.157, working with Kernel 6.10.6.

apple/imac/14-2/default.nix

@@ -13,7 +13,15 @@
     ../../../common/hidpi.nix
     ../../../common/broadcom-wifi.nix
   ];
-
+  # ##############################################################################
+  # ATTENTION / IMPORTANT NOTE:
+  #
+  # Note: Enabling WiFi and Bluetooth functionality on this hardware requires
+  # the proprietary Broadcom driver. Due to outstanding security issues, you
+  # need to explicitly opt-in by setting:
+  #
+  # hardware.broadcom.wifi.enableLegacyDriverWithKnownVulnerabilities = true;
+  # ##############################################################################
   config = {
     boot = {
       initrd.kernelModules = [

apple/macbook-air/6/README.md

@@ -0,0 +1,9 @@
+# Apple MacBook Air 6,x
+
+## Wireless / Bluetooth
+
+> **Note:** Enabling WiFi and Bluetooth functionality on this hardware requires the proprietary Broadcom driver. Due to outstanding security issues, you need to explicitly opt-in by setting:
+>
+> ```nix
+> hardware.broadcom.wifi.enableLegacyDriverWithKnownVulnerabilities = true;
+> ```

apple/macbook-air/6/default.nix

@@ -5,7 +5,15 @@
     ../.
     ../../../common/broadcom-wifi.nix
   ];
-
+  # ##############################################################################
+  # ATTENTION / IMPORTANT NOTE:
+  #
+  # Note: Enabling WiFi and Bluetooth functionality on this hardware requires
+  # the proprietary Broadcom driver. Due to outstanding security issues, you
+  # need to explicitly opt-in by setting:
+  #
+  # hardware.broadcom.wifi.enableLegacyDriverWithKnownVulnerabilities = true;
+  # ##############################################################################
   config = {
     boot = {
       # Divides power consumption by two.

apple/macbook-pro/11-1/README.md

@@ -4,6 +4,13 @@ This configuration is tested on my 13" *MacBook Pro (Retina, 13-inch, Late 2013)
 
 The 6.11.5 kernel appears to work well with only minor adjustments on this notebook. Note that my machine has a BCM4360 wireless card (PCI-ID `14e4:43a0`) which appears to only work with the nonfree `wl` driver.
 
+> **Note:** Enabling WiFi and Bluetooth functionality on this hardware requires the proprietary Broadcom driver. Due to outstanding security issues, you need to explicitly opt-in by setting:
+>
+> ```nix
+> hardware.broadcom.wifi.enableLegacyDriverWithKnownVulnerabilities = true;
+> ```
+
+
 ## Additional resources
 
 * Linux Wireless Documentation: [List of hardware](https://wireless.docs.kernel.org/en/latest/en/users/drivers/b43.html#list-of-hardware)

apple/macbook-pro/11-1/default.nix

@@ -6,7 +6,15 @@
     ../../../common/cpu/intel/haswell
     ../../../common/broadcom-wifi.nix
   ];
-
+  # ##############################################################################
+  # ATTENTION / IMPORTANT NOTE:
+  #
+  # Note: Enabling WiFi and Bluetooth functionality on this hardware requires
+  # the proprietary Broadcom driver. Due to outstanding security issues, you
+  # need to explicitly opt-in by setting:
+  #
+  # hardware.broadcom.wifi.enableLegacyDriverWithKnownVulnerabilities = true;
+  # ##############################################################################
   config = {
     hardware.enableRedistributableFirmware = lib.mkDefault true; # broadcom-wl
   };

dell/inspiron/3442/README.md

@@ -25,6 +25,14 @@ $ lspci -nn
 
 ### Extra Configuration
 
+#### Broadcom WiFi/Bluetooth
+
+> **Note:** Enabling WiFi and Bluetooth functionality on this hardware requires the proprietary Broadcom driver. Due to outstanding security issues, you need to explicitly opt-in by setting:
+>
+> ```nix
+> hardware.broadcom.wifi.enableLegacyDriverWithKnownVulnerabilities = true;
+> ```
+
 #### Bluetooth
 
 To enable bluetooth support, set `hardware.bluetooth.enable = true;`.

dell/inspiron/3442/default.nix

@@ -6,7 +6,15 @@
     ../../../common/pc/laptop
     ../../../common/broadcom-wifi.nix
   ];
-
+  # ##############################################################################
+  # ATTENTION / IMPORTANT NOTE:
+  #
+  # Note: Enabling WiFi and Bluetooth functionality on this hardware requires
+  # the proprietary Broadcom driver. Due to outstanding security issues, you
+  # need to explicitly opt-in by setting:
+  #
+  # hardware.broadcom.wifi.enableLegacyDriverWithKnownVulnerabilities = true;
+  # ##############################################################################
   config = {
     services = {
       fwupd.enable = lib.mkDefault true;

dell/xps/13-9343/README.md

@@ -0,0 +1,9 @@
+# Dell XPS 13 (9343)
+
+## Wireless / Bluetooth
+
+> **Note:** Enabling WiFi and Bluetooth functionality on this hardware requires the proprietary Broadcom driver. Due to outstanding security issues, you need to explicitly opt-in by setting:
+>
+> ```nix
+> hardware.broadcom.wifi.enableLegacyDriverWithKnownVulnerabilities = true;
+> ```

dell/xps/13-9343/default.nix

@@ -7,7 +7,15 @@
     ../../../common/pc/ssd
     ../../../common/broadcom-wifi.nix
   ];
-
+  # ##############################################################################
+  # ATTENTION / IMPORTANT NOTE:
+  #
+  # Note: Enabling WiFi and Bluetooth functionality on this hardware requires
+  # the proprietary Broadcom driver. Due to outstanding security issues, you
+  # need to explicitly opt-in by setting:
+  #
+  # hardware.broadcom.wifi.enableLegacyDriverWithKnownVulnerabilities = true;
+  # ##############################################################################
   config = {
     boot.kernelModules = [
       "kvm-intel"