docs: add status --diff to the docs

Update the manpage and autocomplete files.

doc/netplan-status.md

@@ -34,6 +34,23 @@ Currently, **`netplan status`** depends on `systemd-networkd` as a source of dat
 `-a`, `--all`
 :   Show all interface data including inactive.
 
+`--diff`
+:   Analyze and display differences between the current system configuration and network definitions present in the YAML files.
+    The configuration analyzed includes IP addresses, routes, MAC addresses, DNS addresses, search domains and missing network interfaces.
+
+    The output format is similar to popular diff tools, such `diff` and `git diff`. Configuration present only in the system (and therefore missing in the Netplan YAMLs)
+    will be displayed with a `+` sign and will be highlighted in green. Configuration present only in Netplan (and therefore missing in the system) will be displayed
+    with a `-` sign and highlighted in red. The same is applied to network interfaces.
+
+`--diff-only`
+:   Same as `--diff` but omits all the information that is not a difference.
+
+`--root-dir`
+:   Read YAML files from this root instead of `/`.
+
+`--verbose`
+:   Show extra information.
+
 `-f` *`FORMAT`*, `--format` *`FORMAT`*
 :   Output in machine-readable `json` or `yaml` format.
 

netplan.completions

@@ -37,7 +37,7 @@ _netplan_completions() {
       ;;
 
     'status'*)
-      while read -r; do COMPREPLY+=( "$REPLY" ); done < <( compgen -W "$(_netplan_completions_filter "-h --help --debug -a --all -f --format $(ls /sys/class/net 2> /dev/null)")" -- "$cur" )
+      while read -r; do COMPREPLY+=( "$REPLY" ); done < <( compgen -W "$(_netplan_completions_filter "-h --help --debug -a --all --diff --diff-only --root-dir --verbose -f --format $(ls /sys/class/net 2> /dev/null)")" -- "$cur" )
       ;;
 
     'apply'*)

tools/completely.yaml

@@ -78,6 +78,10 @@ netplan status:
 - --debug
 - -a
 - --all
+- --diff
+- --diff-only
+- --root-dir
+- --verbose
 - -f
 - --format
 - $(ls /sys/class/net 2> /dev/null)