examples: add comment about scanning to "python/dbus/show-bssids.py" example

https://gitlab.freedesktop.org/NetworkManager/NetworkManager/-/issues/630

1 files changed, 5 insertions, 0 deletions

diff --git a/examples/python/dbus/show-bssids.py b/examples/python/dbus/show-bssids.py
index 7a53a53c91..7db0fd3e1e 100755
--- a/examples/python/dbus/show-bssids.py
+++ b/examples/python/dbus/show-bssids.py
@@ -7,6 +7,11 @@
 # This example prints out all the AP BSSIDs that all Wi-Fi devices on the
 # machine can see.  Useful for location-based services like Skyhook that
 # can geolocate you based on the APs you can see.
+#
+# Note that with NetworkManager clients are required to request scanning.
+# If you don't do that, the scan list may be outdated. That means, you would
+# check the LastScan property, and if necessary call RequestScan() first.
+# After RequestScan(), you wait until the LastScan property gets bumped again.
 
 import dbus