[gedit] docs: alternative for the GeditDocument::saved signal

[Sébastien Wilmet <swilmet src gnome org>]

commit e96c4c97ac4136c6bf41ffa96e548f58cbc37098
Author: Sébastien Wilmet <swilmet gnome org>
Date:   Sat Nov 29 17:54:09 2014 +0100

    docs: alternative for the GeditDocument::saved signal

 gedit/gedit-document.c |    6 ++++--
 1 files changed, 4 insertions(+), 2 deletions(-)
---
diff --git a/gedit/gedit-document.c b/gedit/gedit-document.c
index 8d3d2c3..4b2e343 100644
--- a/gedit/gedit-document.c
+++ b/gedit/gedit-document.c
@@ -483,8 +483,10 @@ gedit_document_class_init (GeditDocumentClass *klass)
         * The "saved" signal is emitted at the end of a successful file saving.
         *
         * Before gedit 3.14 this signal contained a #GError parameter, and the
-        * signal was also emitted if an error occurred. Plugins should not need
-        * the error parameter.
+        * signal was also emitted if an error occurred. To save a document, a
+        * plugin can use the gedit_commands_save_document_async() function and
+        * get the result of the operation with
+        * gedit_commands_save_document_finish().
         */
        document_signals[SAVED] =
                g_signal_new ("saved",