summaryrefslogtreecommitdiff
path: root/gio/gnetworkmonitor.c
diff options
context:
space:
mode:
Diffstat (limited to 'gio/gnetworkmonitor.c')
-rw-r--r--gio/gnetworkmonitor.c14
1 files changed, 9 insertions, 5 deletions
diff --git a/gio/gnetworkmonitor.c b/gio/gnetworkmonitor.c
index bae60d5f8..37f2faa6d 100644
--- a/gio/gnetworkmonitor.c
+++ b/gio/gnetworkmonitor.c
@@ -254,9 +254,9 @@ g_network_monitor_real_can_reach_async (GNetworkMonitor *monitor,
* @monitor: a #GNetworkMonitor
* @connectable: a #GSocketConnectable
* @cancellable: (nullable): a #GCancellable, or %NULL
- * @callback: (scope async): a #GAsyncReadyCallback to call when the
- * request is satisfied
- * @user_data: (closure): the data to pass to callback function
+ * @callback: (scope async): a #GAsyncReadyCallback
+ * to call when the request is satisfied
+ * @user_data: the data to pass to callback function
*
* Asynchronously attempts to determine whether or not the host
* pointed to by @connectable can be reached, without actually
@@ -372,14 +372,18 @@ g_network_monitor_default_init (GNetworkMonitorInterface *iface)
/**
* 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
* subject to limitations set by service providers. For example, traffic
* 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
* connections (3G and 4G) and in such situations, bandwidth intensive
* 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
* system network management API should be used instead (for example,