Merge branch 'metered-docs' into 'main'

gnetworkmonitor: Expand guidelines for metered data use

See merge request GNOME/glib!3515
This commit is contained in:
Emmanuele Bassi 2023-07-30 10:45:38 +00:00
commit 338a9c35d2

View File

@ -372,14 +372,18 @@ g_network_monitor_default_init (GNetworkMonitorInterface *iface)
/** /**
* GNetworkMonitor:network-metered: * GNetworkMonitor:network-metered:
* *
* Whether the network is considered metered. That is, whether the * Whether the network is considered metered.
*
* That is, whether the
* system has traffic flowing through the default connection that is * system has traffic flowing through the default connection that is
* subject to limitations set by service providers. For example, traffic * subject to limitations set by service providers. For example, traffic
* might be billed by the amount of data transmitted, or there might be a * might be billed by the amount of data transmitted, or there might be a
* quota on the amount of traffic per month. This is typical with tethered * quota on the amount of traffic per month. This is typical with tethered
* connections (3G and 4G) and in such situations, bandwidth intensive * connections (3G and 4G) and in such situations, bandwidth intensive
* applications may wish to avoid network activity where possible if it will * applications may wish to avoid network activity where possible if it will
* cost the user money or use up their limited quota. * cost the user money or use up their limited quota. Anything more than a
* few hundreds of kilobytes of data usage per hour should be avoided without
* asking permission from the user.
* *
* If more information is required about specific devices then the * If more information is required about specific devices then the
* system network management API should be used instead (for example, * system network management API should be used instead (for example,