nmcli*: refresh pages (#17258)

pages/linux/nmcli-agent.md

@@ -1,17 +1,16 @@
 # nmcli agent
 
 > Run `nmcli` as a NetworkManager secret agent or polkit agent.
-> This subcommand can also be called with `nmcli a`.
 > More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html>.
 
 - Register `nmcli` as a secret agent and listen for secret requests:
 
-`nmcli agent secret`
+`nmcli {{[a|agent]}} {{[s|secret]}}`
 
 - Register `nmcli` as a polkit agent and listen for authorization requests:
 
-`nmcli agent polkit`
+`nmcli {{[a|agent]}} {{[p|polkit]}}`
 
 - Register `nmcli` as a secret agent and a polkit agent:
 
-`nmcli agent all`
+`nmcli {{[a|agent]}} {{[a|all]}}`

pages/linux/nmcli-connection.md

@@ -1,33 +1,32 @@
 # nmcli connection
 
 > Manage connections with NetworkManager.
-> This subcommand can also be called with `nmcli c`.
 > More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html>.
 
 - List all NetworkManager connections (shows name, UUID, type and device):
 
-`nmcli connection`
+`nmcli {{[c|connection]}}`
 
 - Activate a connection:
 
-`nmcli connection up uuid {{uuid}}`
+`nmcli {{[c|connection]}} {{[u|up]}} {{uuid}}`
 
 - Deactivate a connection:
 
-`nmcli connection down uuid {{uuid}}`
+`nmcli {{[c|connection]}} {{[d|down]}} {{uuid}}`
 
 - Create an auto-configured dual stack connection:
 
-`nmcli connection add ifname {{interface_name}} type {{ethernet}} ipv4.method {{auto}} ipv6.method {{auto}}`
+`nmcli {{[c|connection]}} {{[a|add]}} ifname {{interface_name}} type {{ethernet}} ipv4.method {{auto}} ipv6.method {{auto}}`
 
 - Create a static IPv6-only connection:
 
-`nmcli connection add ifname {{interface_name}} type {{ethernet}} ip6 {{2001:db8::2/64}} gw6 {{2001:db8::1}} ipv6.dns {{2001:db8::1}} ipv4.method {{ignore}}`
+`nmcli {{[c|connection]}} {{[a|add]}} ifname {{interface_name}} type {{ethernet}} ip6 {{2001:db8::2/64}} gw6 {{2001:db8::1}} ipv6.dns {{2001:db8::1}} ipv4.method {{ignore}}`
 
 - Create a static IPv4-only connection:
 
-`nmcli connection add ifname {{interface_name}} type {{ethernet}} ip4 {{10.0.0.7/8}} gw4 {{10.0.0.1}} ipv4.dns {{10.0.0.1}} ipv6.method {{ignore}}`
+`nmcli {{[c|connection]}} {{[a|add]}} ifname {{interface_name}} type {{ethernet}} ip4 {{10.0.0.7/8}} gw4 {{10.0.0.1}} ipv4.dns {{10.0.0.1}} ipv6.method {{ignore}}`
 
 - Create a VPN connection using OpenVPN from an OVPN file:
 
-`nmcli connection import type {{openvpn}} file {{path/to/vpn_config.ovpn}}`
+`nmcli {{[c|connection]}} {{[i|import]}} type {{openvpn}} file {{path/to/vpn_config.ovpn}}`

pages/linux/nmcli-device.md

@@ -1,21 +1,20 @@
 # nmcli device
 
 > Manage network interfaces and establish new Wi-Fi connections using NetworkManager.
-> This subcommand can also be called with `nmcli d`.
 > More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html>.
 
 - Print the statuses of all network interfaces:
 
-`nmcli device status`
+`nmcli {{[d|device]}}`
 
 - Print the available Wi-Fi access points:
 
-`nmcli device wifi`
+`nmcli {{[d|device]}} {{[w|wifi]}}`
 
 - Connect to a Wi-Fi network with the specified SSID (you will be prompted for a password):
 
-`nmcli --ask device wifi connect {{ssid}}`
+`nmcli {{[d|device]}} {{[w|wifi]}} {{[c|connect]}} {{ssid}} {{[-a|--ask]}}`
 
 - Print the password and QR code for the current Wi-Fi network:
 
-`nmcli device wifi show-password`
+`nmcli {{[d|device]}} {{[w|wifi]}} {{[s|show-password]}}`

pages/linux/nmcli-general.md

@@ -1,29 +1,28 @@
 # nmcli general
 
 > Manage general settings of NetworkManager.
-> This subcommand can also be called with `nmcli g`.
 > More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html>.
 
 - Show the general status of NetworkManager:
 
-`nmcli general`
+`nmcli {{[g|general]}}`
 
 - Show the hostname of the current device:
 
-`nmcli general hostname`
+`nmcli {{[g|general]}} {{[h|hostname]}}`
 
 - Change the hostname of the current device:
 
-`sudo nmcli general hostname {{new_hostname}}`
+`sudo nmcli {{[g|general]}} {{[h|hostname]}} {{new_hostname}}`
 
 - Show the permissions of NetworkManager:
 
-`nmcli general permissions`
+`nmcli {{[g|general]}} {{[p|permissions]}}`
 
 - Show the current logging level and domains:
 
-`nmcli general logging`
+`nmcli {{[g|general]}} {{[l|logging]}}`
 
 - Set the logging level and/or domains (see `man NetworkManager.conf` for all available domains):
 
-`nmcli general logging level {{INFO|OFF|ERR|WARN|DEBUG|TRACE}} domain {{domain_1,domain_2,...}}`
+`sudo nmcli {{[g|general]}} {{[l|logging]}} {{[l|level]}} {{INFO|OFF|ERR|WARN|DEBUG|TRACE}} domain {{domain_1,domain_2,...}}`

pages/linux/nmcli-monitor.md

@@ -1,9 +1,8 @@
 # nmcli monitor
 
 > Monitor changes to the NetworkManager connection status.
-> This subcommand can also be called with `nmcli m`.
 > More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html>.
 
 - Start monitoring NetworkManager changes:
 
-`nmcli monitor`
+`nmcli {{[m|monitor]}}`

pages/linux/nmcli-networking.md

@@ -1,21 +1,20 @@
 # nmcli networking
 
 > Manage the networking status of NetworkManager.
-> This subcommand can also be called with `nmcli n`.
 > More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html>.
 
 - Show the networking status of NetworkManager:
 
-`nmcli networking`
+`nmcli {{[n|networking]}}`
 
 - Enable or disable networking and all interfaces managed by NetworkManager:
 
-`nmcli networking {{on|off}}`
+`nmcli {{[n|networking]}} {{on|off}}`
 
 - Show the last known connectivity state:
 
-`nmcli networking connectivity`
+`nmcli {{[n|networking]}} {{[c|connectivity]}}`
 
 - Show the current connectivity state:
 
-`nmcli networking connectivity check`
+`nmcli {{[n|networking]}} {{[c|connectivity]}} {{[c|check]}}`

pages/linux/nmcli-radio.md

@@ -1,29 +1,28 @@
 # nmcli radio
 
 > Show the status of radio switches or enable/disable them using NetworkManager.
-> This subcommand can also be called with `nmcli r`.
 > More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html>.
 
 - Show status of Wi-Fi:
 
-`nmcli radio wifi`
+`nmcli {{[r|radio]}} {{[w|wifi]}}`
 
 - Turn Wi-Fi on or off:
 
-`nmcli radio wifi {{on|off}}`
+`nmcli {{[r|radio]}} {{[w|wifi]}} {{on|off}}`
 
 - Show status of WWAN:
 
-`nmcli radio wwan`
+`nmcli {{[r|radio]}} {{[ww|wwan]}}`
 
 - Turn WWAN on or off:
 
-`nmcli radio wwan {{on|off}}`
+`nmcli {{[r|radio]}} {{[ww|wwan]}} {{on|off}}`
 
 - Show status of both switches:
 
-`nmcli radio all`
+`nmcli {{[r|radio]}}`
 
 - Turn both switches on or off:
 
-`nmcli radio all {{on|off}}`
+`nmcli {{[r|radio]}} {{[a|all]}} {{on|off}}`

pages/linux/nmcli.md

@@ -3,17 +3,17 @@
 > Manage the network configuration using NetworkManager.
 > More information: <https://networkmanager.pages.freedesktop.org/NetworkManager/NetworkManager/nmcli.html>.
 
-- View documentation for running `nmcli` as a NetworkManager secret/polkit agent:
+- View documentation for managing network interfaces and establishing new Wi-Fi connections:
 
-`tldr nmcli agent`
+`tldr nmcli device`
 
 - View documentation for managing network connections:
 
 `tldr nmcli connection`
 
-- View documentation for managing network interfaces and establishing new Wi-Fi connections:
+- View documentation for running `nmcli` as a NetworkManager secret/polkit agent:
 
-`tldr nmcli device`
+`tldr nmcli agent`
 
 - View documentation for managing general settings of NetworkManager: