From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Kevin Ryde Newsgroups: gmane.emacs.bugs,gmane.emacs.pretest.bugs Subject: bug#3864: 23.1.50; docstring url hyperlinks Date: Thu, 16 Jul 2009 10:43:20 +1000 Message-ID: <87iqhta253.fsf@blah.blah> Reply-To: Kevin Ryde , 3864@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Trace: ger.gmane.org 1247705875 13566 80.91.229.12 (16 Jul 2009 00:57:55 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 16 Jul 2009 00:57:55 +0000 (UTC) To: emacs-pretest-bug@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Jul 16 02:57:46 2009 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1MRFI6-0004WA-J9 for geb-bug-gnu-emacs@m.gmane.org; Thu, 16 Jul 2009 02:57:43 +0200 Original-Received: from localhost ([127.0.0.1]:51234 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MRFI6-00069H-17 for geb-bug-gnu-emacs@m.gmane.org; Wed, 15 Jul 2009 20:57:42 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MRFI1-00069C-85 for bug-gnu-emacs@gnu.org; Wed, 15 Jul 2009 20:57:37 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MRFHv-000690-5X for bug-gnu-emacs@gnu.org; Wed, 15 Jul 2009 20:57:35 -0400 Original-Received: from [199.232.76.173] (port=44835 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MRFHv-00068x-1J for bug-gnu-emacs@gnu.org; Wed, 15 Jul 2009 20:57:31 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:48470) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MRFHu-0005NP-A2 for bug-gnu-emacs@gnu.org; Wed, 15 Jul 2009 20:57:30 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n6G0vSiR012072; Wed, 15 Jul 2009 17:57:28 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n6G0o41i010747; Wed, 15 Jul 2009 17:50:04 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: Kevin Ryde Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Thu, 16 Jul 2009 00:50:04 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: report 3864 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.12477050359891 (code B ref -1); Thu, 16 Jul 2009 00:50:04 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 16 Jul 2009 00:43:55 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n6G0hi4E009869 for ; Wed, 15 Jul 2009 17:43:46 -0700 Original-Received: from mail.gnu.org ([199.232.76.166]:39681 helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1MRF4Z-0002wW-Gp for emacs-pretest-bug@gnu.org; Wed, 15 Jul 2009 20:43:43 -0400 Original-Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1MRF4S-0003QL-Ql for emacs-pretest-bug@gnu.org; Wed, 15 Jul 2009 20:43:41 -0400 Original-Received: from mailout1-1.pacific.net.au ([61.8.2.208]:41744 helo=mailout1.pacific.net.au) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1MRF4R-0003Pl-Pn for emacs-pretest-bug@gnu.org; Wed, 15 Jul 2009 20:43:36 -0400 Original-Received: from mailproxy2.pacific.net.au (mailproxy2.pacific.net.au [61.8.2.163]) by mailout1.pacific.net.au (Postfix) with ESMTP id 5A69D4FD18E for ; Thu, 16 Jul 2009 10:43:31 +1000 (EST) Original-Received: from blah.blah (ppp29B9.dyn.pacific.net.au [61.8.41.185]) by mailproxy2.pacific.net.au (Postfix) with ESMTP id B62492740E for ; Thu, 16 Jul 2009 10:43:28 +1000 (EST) Original-Received: from gg by blah.blah with local (Exim 4.69) (envelope-from ) id 1MRF4E-0002eM-BQ for emacs-pretest-bug@gnu.org; Thu, 16 Jul 2009 10:43:22 +1000 User-Agent: Gnus/5.110011 (No Gnus v0.11) Emacs/22.3 (gnu/linux) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Wed, 15 Jul 2009 20:57:35 -0400 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:29458 gmane.emacs.pretest.bugs:24806 Archived-At: --=-=-= 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 * 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 `...'. --=-=-= Content-Type: text/x-diff Content-Disposition: inline; filename=docstring-urls.diff 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 . Official distribution is at -. +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 (wsnyder@wsnyder.org)." (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 . 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. " --=-=-=--