Add/improve some documentation comments

Since CHICKEN scheme doesn't do docstrings I'm just using comments.

1 files changed, 4 insertions, 3 deletions

diff --git a/conkeror/linkwave.js b/conkeror/linkwave.js
index 6dc2f4b..75e3735 100644
--- a/conkeror/linkwave.js
+++ b/conkeror/linkwave.js
@@ -26,7 +26,8 @@ define_variable("linkwave_program", "linkwave",
                 "The location of the linkwave executable.");
 
 function linkwave_add_url(I, url, title)
-{
+{   // Add URL to linkwave, ask for a title (provide TITLE as a
+    // default), description and any number of tags.
     let url_string = load_spec_uri_string(load_spec(url));
     let title = yield I.minibuffer.read($prompt="name (required): ",
                                         $initial_value=title);
@@ -55,7 +56,7 @@ function linkwave_add(I) {
         I.window.minibuffer.message('Couldn\'t add to linkwave');
 }
 interactive("linkwave-add",
-            "Bookmark a page in linkwave",
+            "Bookmark the current page in linkwave",
             linkwave_add);
 
 function linkwave_add_link(I) {
@@ -70,7 +71,7 @@ function linkwave_add_link(I) {
         I.window.minibuffer.message('Couldn\'t add to linkwave');
 }
 interactive("linkwave-add-link",
-            "Bookmark a link in linkwave",
+            "Select and bookmark a link in linkwave",
             linkwave_add_link);
 
 provide("linkwave");