bug#3864: 23.1.50; docstring url hyperlinks

Kevin Ryde <[email protected]>
Newsgroups gmane.emacs.bugs,gmane.emacs.pretest.bugs
Message-ID <[email protected]> 
I did a grep for urls in docstrings which might be hyperlinked.
Diff below from the lisp directory.

It'd be tempting to have M-x checkdoc report on this sort of
thing, except it may too often hit sample input etc instead of
actual followable links.


2009-07-16  Kevin Ryde  <[email protected]>

	* erc/erc.el (erc-cmd-MODE): 
	* mh-e/mh-junk.el (mh-spamassassin-blacklist,
	mh-bogofilter-blacklist, mh-spamprobe-blacklist): 
	* net/newst-backend.el (newsticker--parse-atom-1.0,
	newsticker--parse-rss-0.91, newsticker--parse-rss-0.92,
	newsticker--parse-rss-1.0):
	* progmodes/idlwave.el (idlwave-mode): 
	* progmodes/idlw-shell.el (idlwave-shell-mode): 
	* progmodes/vera-mode.el (vera-mode): 
	* progmodes/verilog-mode.el (verilog-auto-inst, verilog-auto): 
	* progmodes/vhdl-mode.el (vhdl-mode): 
	* textmodes/table.el (table-generate-source)
	(table--warn-incompatibility): 
	Hyperlink urls in docstrings with URL `...'.
docstring-urls.diff (text/x-diff, 9.5 KB) 
Index: erc/erc.el
===================================================================
RCS file: /sources/emacs/emacs/lisp/erc/erc.el,v
retrieving revision 1.60
diff -u -r1.60 erc.el
--- erc/erc.el	13 Mar 2009 20:45:14 -0000	1.60
+++ erc/erc.el	16 Jul 2009 00:34:41 -0000
@@ -3095,7 +3095,7 @@
 If only one word is given, display the mode of that target.
 
 A list of valid mode strings for Freenode may be found at
-`http://freenode.net/using_the_network.shtml'."
+URL `http://freenode.net/using_the_network.shtml'."
   (cond
    ((string-match "^\\s-\\(.*\\)$" line)
     (let ((s (match-string 1 line)))
Index: mh-e/mh-junk.el
===================================================================
RCS file: /sources/emacs/emacs/lisp/mh-e/mh-junk.el,v
retrieving revision 1.28
diff -u -r1.28 mh-junk.el
--- mh-e/mh-junk.el	10 Jan 2009 21:50:42 -0000	1.28
+++ mh-e/mh-junk.el	16 Jul 2009 00:34:43 -0000
@@ -109,7 +109,7 @@
 
 SpamAssassin is one of the more popular spam filtering programs.
 Get it from your local distribution or from
-http://spamassassin.org/.
+URL `http://spamassassin.org/'.
 
 To use SpamAssassin, add the following recipes to
 \".procmailrc\":
@@ -332,7 +332,7 @@
   "Blacklist MSG with bogofilter.
 
 Bogofilter is a Bayesian spam filtering program. Get it from your
-local distribution or from http://bogofilter.sourceforge.net/.
+local distribution or from URL `http://bogofilter.sourceforge.net/'.
 
 Bogofilter is taught by running:
 
@@ -412,7 +412,7 @@
   "Blacklist MSG with SpamProbe.
 
 SpamProbe is a Bayesian spam filtering program. Get it from your local
-distribution or from http://spamprobe.sourceforge.net.
+distribution or from URL `http://spamprobe.sourceforge.net'.
 
 To use SpamProbe, add the following recipes to \".procmailrc\":
 
Index: net/newst-backend.el
===================================================================
RCS file: /sources/emacs/emacs/lisp/net/newst-backend.el,v
retrieving revision 1.8
diff -u -r1.8 newst-backend.el
--- net/newst-backend.el	23 Jan 2009 18:49:06 -0000	1.8
+++ net/newst-backend.el	16 Jul 2009 00:34:50 -0000
@@ -1130,7 +1130,7 @@
 contains the feed data as returned by the xml parser.
 
 For the Atom 1.0 specification see
-http://www.atompub.org/2005/08/17/draft-ietf-atompub-format-11.html"
+URL `http://www.atompub.org/2005/08/17/draft-ietf-atompub-format-11.html'"
   (newsticker--debug-msg "Parsing Atom 1.0 feed %s" name)
   (let (new-feed new-item)
     (setq new-feed (newsticker--parse-generic-feed
@@ -1184,8 +1184,8 @@
 Return value as well as arguments NAME, TIME, and TOPNODE are the
 same as in `newsticker--parse-atom-1.0'.
 
-For the RSS 0.91 specification see http://backend.userland.com/rss091 or
-http://my.netscape.com/publish/formats/rss-spec-0.91.html."
+For the RSS 0.91 specification see URL `http://backend.userland.com/rss091'
+or URL `http://my.netscape.com/publish/formats/rss-spec-0.91.html'."
   (newsticker--debug-msg "Parsing RSS 0.91 feed %s" name)
   (let* ((channelnode (car (xml-get-children topnode 'channel)))
          (pub-date (newsticker--decode-rfc822-date
@@ -1238,7 +1238,7 @@
 Return value as well as arguments NAME, TIME, and TOPNODE are the
 same as in `newsticker--parse-atom-1.0'.
 
-For the RSS 0.92 specification see http://backend.userland.com/rss092."
+For the RSS 0.92 specification see URL `http://backend.userland.com/rss092'."
   (newsticker--debug-msg "Parsing RSS 0.92 feed %s" name)
   (let* ((channelnode (car (xml-get-children topnode 'channel)))
          (pub-date (newsticker--decode-rfc822-date
@@ -1291,7 +1291,7 @@
 Return value as well as arguments NAME, TIME, and TOPNODE are the
 same as in `newsticker--parse-atom-1.0'.
 
-For the RSS 1.0 specification see http://web.resource.org/rss/1.0/spec."
+For the RSS 1.0 specification see URL `http://web.resource.org/rss/1.0/spec'."
   (newsticker--debug-msg "Parsing RSS 1.0 feed %s" name)
   (let* ((channelnode (car (xml-get-children topnode 'channel)))
          is-new-feed has-new-items)
@@ -1342,7 +1342,7 @@
 Return value as well as arguments NAME, TIME, and TOPNODE are the
 same as in `newsticker--parse-atom-1.0'.
 
-For the RSS 2.0 specification see http://blogs.law.harvard.edu/tech/rss."
+For the RSS 2.0 specification see URL `http://blogs.law.harvard.edu/tech/rss'."
   (newsticker--debug-msg "Parsing RSS 2.0 feed %s" name)
   (let* ((channelnode (car (xml-get-children topnode 'channel)))
          is-new-feed has-new-items)
Index: progmodes/idlw-shell.el
===================================================================
RCS file: /sources/emacs/emacs/lisp/progmodes/idlw-shell.el,v
retrieving revision 3.66
diff -u -r3.66 idlw-shell.el
--- progmodes/idlw-shell.el	5 Jan 2009 03:23:41 -0000	3.66
+++ progmodes/idlw-shell.el	16 Jul 2009 00:35:07 -0000
@@ -941,7 +941,7 @@
    Info documentation for this package is available.  Use \\[idlwave-info]
    to display (complain to your sysadmin if that does not work).
    For Postscript and HTML versions of the documentation, check IDLWAVE's
-   homepage at `http://idlwave.org'.
+   homepage at URL `http://idlwave.org'.
    IDLWAVE has customize support - see the group `idlwave'.
 
 8. Keybindings
Index: progmodes/idlwave.el
===================================================================
RCS file: /sources/emacs/emacs/lisp/progmodes/idlwave.el,v
retrieving revision 3.77
diff -u -r3.77 idlwave.el
--- progmodes/idlwave.el	9 Jan 2009 04:15:59 -0000	3.77
+++ progmodes/idlwave.el	16 Jul 2009 00:35:40 -0000
@@ -1883,7 +1883,7 @@
    Info documentation for this package is available.  Use
    \\[idlwave-info] to display (complain to your sysadmin if that does
    not work).  For Postscript, PDF, and HTML versions of the
-   documentation, check IDLWAVE's homepage at `http://idlwave.org'.
+   documentation, check IDLWAVE's homepage at URL `http://idlwave.org'.
    IDLWAVE has customize support - see the group `idlwave'.
 
 10.Keybindings
Index: progmodes/vera-mode.el
===================================================================
RCS file: /sources/emacs/emacs/lisp/progmodes/vera-mode.el,v
retrieving revision 1.14
diff -u -r1.14 vera-mode.el
--- progmodes/vera-mode.el	9 Jan 2009 04:16:03 -0000	1.14
+++ progmodes/vera-mode.el	16 Jul 2009 00:35:45 -0000
@@ -291,7 +291,7 @@
 Feel free to send questions and enhancement requests to <[email protected]>.
 
 Official distribution is at
-<http://www.iis.ee.ethz.ch/~zimmi/emacs/vera-mode.html>.
+URL `http://www.iis.ee.ethz.ch/~zimmi/emacs/vera-mode.html'
 
 
                                                   The Vera Mode Maintainer
Index: progmodes/verilog-mode.el
===================================================================
RCS file: /sources/emacs/emacs/lisp/progmodes/verilog-mode.el,v
retrieving revision 1.29
diff -u -r1.29 verilog-mode.el
--- progmodes/verilog-mode.el	6 Jul 2009 08:32:53 -0000	1.29
+++ progmodes/verilog-mode.el	16 Jul 2009 00:36:20 -0000
@@ -8811,7 +8811,7 @@
   Unless you are instantiating a module multiple times, or the module is
   something trivial like an adder, DO NOT CHANGE SIGNAL NAMES ACROSS HIERARCHY.
   It just makes for unmaintainable code.  To sanitize signal names, try
-  vrename from http://www.veripool.org.
+  vrename from URL `http://www.veripool.org'.
 
   When you need to violate this suggestion there are two ways to list
   exceptions, placing them before the AUTOINST, or using templates.
@@ -10503,7 +10503,7 @@
     `verilog-read-includes'     for reading `includes
 
 If you have bugs with these autos, please file an issue at
-http://www.veripool.org/verilog-mode or contact the AUTOAUTHOR
+URL `http://www.veripool.org/verilog-mode' or contact the AUTOAUTHOR
 Wilson Snyder ([email protected])."
   (interactive)
   (unless noninteractive (message "Updating AUTOs..."))
Index: progmodes/vhdl-mode.el
===================================================================
RCS file: /sources/emacs/emacs/lisp/progmodes/vhdl-mode.el,v
retrieving revision 1.81
diff -u -r1.81 vhdl-mode.el
--- progmodes/vhdl-mode.el	2 Feb 2009 20:49:44 -0000	1.81
+++ progmodes/vhdl-mode.el	16 Jul 2009 00:37:08 -0000
@@ -4648,7 +4648,7 @@
 to above mailing lists by sending an email to <[email protected]>.
 
 VHDL Mode is officially distributed at
-http://opensource.ethz.ch/emacs/vhdl-mode.html
+URL `http://opensource.ethz.ch/emacs/vhdl-mode.html'
 where the latest version can be found.
 
 
Index: textmodes/table.el
===================================================================
RCS file: /sources/emacs/emacs/lisp/textmodes/table.el,v
retrieving revision 1.40
diff -u -r1.40 table.el
--- textmodes/table.el	26 May 2009 03:32:03 -0000	1.40
+++ textmodes/table.el	16 Jul 2009 00:37:27 -0000
@@ -3002,14 +3002,14 @@
 References used for this implementation:
 
 HTML:
-        http://www.w3.org
+        URL `http://www.w3.org'
 
 LaTeX:
-        http://www.maths.tcd.ie/~dwilkins/LaTeXPrimer/Tables.html
+        URL `http://www.maths.tcd.ie/~dwilkins/LaTeXPrimer/Tables.html'
 
 CALS (DocBook DTD):
-        http://www.oasis-open.org/html/a502.htm
-        http://www.oreilly.com/catalog/docbook/chapter/book/table.html#AEN114751
+        URL `http://www.oasis-open.org/html/a502.htm'
+        URL `http://www.oreilly.com/catalog/docbook/chapter/book/table.html#AEN114751'
 "
   (interactive
    (let* ((dummy (unless (table--probe-cell) (error "Table not found here")))
@@ -5369,7 +5369,7 @@
 *** Warning ***
 
 Flyspell minor mode is known to be incompatible with this table
-package.  The flyspell version 1.5d at http://kaolin.unice.fr/~serrano
+package.  The flyspell version 1.5d at URL `http://kaolin.unice.fr/~serrano'
 works better than the previous versions however not fully compatible.
 
 "
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.