]> git.eshelyaron.com Git - emacs.git/commitdiff
(quickurl): Doc fix.
authorRichard M. Stallman <rms@gnu.org>
Fri, 3 Sep 1999 00:57:50 +0000 (00:57 +0000)
committerRichard M. Stallman <rms@gnu.org>
Fri, 3 Sep 1999 00:57:50 +0000 (00:57 +0000)
lisp/quickurl.el

index b78a379ba7b2d3d3935c32a344ed37dcc0b872e9..aaf68650c07ba6460aa4a29af68900c545831fe0 100644 (file)
 ;;; Commentary:
 ;;
 ;; This package provides a simple method of inserting an URL based on the
-;; text at point in the current buffer.  This is part of an on-going
-;; effort to increase the information I provide people while reducing the
-;; ammount of typing I need to do (see also handyurl.el which is available
-;; from <URL:http://www.hagbard.demon.co.uk/archives/handyurl.el>), no-doubt
-;; there are undiscovered Emacs packages out there that do all of this and
-;; do it better, feel free to point me to them, in the mean time I'm having
-;; fun playing with Emacs Lisp.
+;; text at point in the current buffer. This is part of an on-going effort
+;; to increase the information I provide people while reducing the ammount
+;; of typing I need to do. No-doubt there are undiscovered Emacs packages
+;; out there that do all of this and do it better, feel free to point me to
+;; them, in the mean time I'm having fun playing with Emacs Lisp.
 ;;
 ;; The URLs are stored in an external file as a list of either cons cells,
 ;; or lists. A cons cell entry looks like this:
@@ -69,7 +67,7 @@
 ;; backward compatibility with existing URL lists.
 ;;
 ;; The name and location of the file is up to you, the default name used by
-;; the `quickurl' is stored in `quickurl-url-file'.
+;; `quickurl' is stored in `quickurl-url-file'.
 ;;
 ;; quickurl is always available from:
 ;;
 ;; o The quickurl-browse-url* functions pretty much duplicate their non
 ;;   browsing friends. It would feel better if a more generic solution could
 ;;   be found.
-;;
-;; o Merge quickurl.el and handyurl.el to provide a fuller URL management
-;;   facility that would allow for the pulling, inserting and browsing of
-;;   URLs.
 
 ;;; Code:
 
 ;; `caddr' is a function in cl and so might not always be available
 ;; (remembering the general rule that says cl functions should not be used,
 ;; only cl macros). So, to make use of `caddr' without forcing the load of
-;; cl-seq we'll define out own.
+;; cl-seq we'll define our own.
 
 (eval-when (load eval)
   (unless (fboundp 'caddr)
       "Return the `car' of the `cddr' of L."
       (car (cddr l)))))
 
-;; Create a version constant.
-
 ;; Customize options.
 
 (defgroup quickurl nil
@@ -315,8 +307,8 @@ Also display a `message' saying what the URL was unless SILENT is non-nil."
 (defun* quickurl (&optional (lookup (funcall quickurl-grab-lookup-function)))
   "Insert an URL based on LOOKUP.
 
-If not supplied LOOKUP is taken to be the word at point in the
-current buffer, this default action can be modifed via
+If not supplied LOOKUP is taken to be the word at point in the current
+buffer, this default action can be modifed via
 `quickurl-grab-lookup-function'."
   (interactive)
   (when lookup
@@ -363,7 +355,7 @@ It is assumed that the URL is either \"unguarded\" or is wrapped inside an
         (let ((word (funcall quickurl-grab-lookup-function)))
           (when word
             (quickurl-make-url
-             ;; `thing-at-point' returns the word with properties. I don't
+             ;; The grab function may return the word with properties. I don't
              ;; want the properties. I couldn't find a method of stripping
              ;; them from a "string" so this will have to do. If you know of
              ;; a better method of doing this I'd love to know.