#946923 formally document wpa_supplicant.conf syntax

Package:
wpasupplicant
Source:
wpa
Description:
client support for WPA and WPA2 (IEEE 802.11i)
Submitter:
積丹尼 Dan Jacobson
Date:
2019-12-18 00:00:09 UTC
Severity:
wishlist
#946923#5
Date:
2019-12-17 17:58:17 UTC
From:
To:
In one of
/usr/share/man/man5/wpa_supplicant.conf.5.gz
/usr/share/doc/wpa_supplicant/examples/wpa_supplicant.conf
/usr/share/doc/wpa_supplicant/README.gz
please finally formally mention the syntax of the configuration file.

Mention that leading spaces on each line are ignored.

Mention that
ctrl_interface=/var/run/wpa_supplicant update_config=1
cannot be all put on one line, as using -dd will show, this is parsed as
ctrl_interface='/var/run/wpa_supplicant update_config=1'

Mention that
network={
	ssid="plaintext-test"
	key_mgmt=NONE
}
cannot be written with any fewer lines either,
as there can only be one '=' on each line also just the same.
E.g., one cannot write:
network={ssid="plaintext-test" key_mgmt=NONE};
network={ssid="plaintext-test" key_mgmt=NONE}
network={ ssid="plaintext-test" key_mgmt=NONE }
network={; ssid="plaintext-test"; key_mgmt=NONE;}
network={ssid="plaintext-test"; key_mgmt=NONE;}

Also mention there is no way to do
# wpasupplicant --conf 'network={ssid="plaintext-test" key_mgmt=NONE};'
etc. for diskless/read-only systems.