source: Add "net:plaintext" source tag doc

This will make it easier for applications to avoid using plaintext
channels, such as HTTP-only connections, when doing requests.

Adding a tag allows applications to avoid hard-coding sources which
might leak private information.

https://bugzilla.gnome.org/show_bug.cgi?id=747953

1 files changed, 6 insertions, 0 deletions

diff --git a/src/grl-source.c b/src/grl-source.c
index c4d5ba4..2ddd823 100644
--- a/src/grl-source.c
+++ b/src/grl-source.c
@@ -461,6 +461,12 @@ grl_source_class_init (GrlSourceClass *source_class)
    *   from the application's reach when such networks aren't available, or
    *   we're not connected to a network.
    *
+   *   "net:plaintext"
+   *   The source makes requests over plain text, non-encrypted, network channels,
+   *   such as using HTTP to do searches or lookups. Applications would usually
+   *   disable those by default, so that privacy is respected by default, and no
+   *   data is leaked unintentionally.
+   *
    * Since: 0.2.10
    */
   g_object_class_install_property (gobject_class,