diff --git a/src/kbookmark.h b/src/kbookmark.h
--- a/src/kbookmark.h
+++ b/src/kbookmark.h
@@ -388,7 +388,8 @@
      * Create a new bookmark, as the last child of this group
      * Don't forget to use KBookmarkManager::self()->emitChanged( parentBookmark );
      * @param text for the bookmark
-     * @param url the URL that the bookmark points to
+     * @param url the URL that the bookmark points to.
+     * It will be stored in its QUrl::FullyEncoded string format.
      * @param icon the name of the icon to associate with the bookmark. A suitable default
      * will be determined from the URL if not specified.
      */