gnetworkmonitor: Expand guidelines for metered data use

Clarify how much is too much.

Signed-off-by: Philip Withnall <pwithnall@endlessos.org>
This commit is contained in:
Philip Withnall 2023-07-29 15:22:15 +03:00
parent 6e77bb3315
commit 02bc1382b2

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,