GNU bug report logs - #30571
URL vs Homepage in package headers

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 30571 in the body.
You can then email your comments to 30571 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Peter Oliver <p.d.oliver <at> mavit.org.uk>
To: bug-gnu-emacs <at> gnu.org
Subject: URL vs Homepage in package headers
Date: Thu, 22 Feb 2018 00:48:01 +0000 (GMT)

The Emacs Lisp manual at https://www.gnu.org/software/emacs/manual/html_node/elisp/Simple-Packages.html#Simple-Packages gives an example of a package library headers.  This example includes a URL line.  Later, the reader is directed to https://www.gnu.org/software/emacs/manual/html_node/elisp/Library-Headers.html#Library-Headers for more information about the available headers.  This second page makes no mention of the URL line, and instead describes a Homepage line.

Surveying the Emacs source code, it turns out that both URL and Homepage are used, although Homepage is more popular.

Should one of URL and Homepage be preferred to the other?  Are they aliases?  Is one of these a typo?

-- 
Peter Oliver

Message #8 received at 30571 <at> debbugs.gnu.org (full text, mbox):

From: Glenn Morris <rgm <at> gnu.org>
To: Peter Oliver <p.d.oliver <at> mavit.org.uk>
Cc: 30571 <at> debbugs.gnu.org
Subject: Re: bug#30571: URL vs Homepage in package headers
Date: Mon, 05 Mar 2018 17:51:18 -0500

By inspection of the code (lm-homepage), these forms are entirely equivalent.

Message #11 received at 30571 <at> debbugs.gnu.org (full text, mbox):

From: Peter Oliver <p.d.oliver <at> mavit.org.uk>
To: 30571 <at> debbugs.gnu.org
Cc: Peter Oliver <git <at> mavit.org.uk>
Subject: [PATCH] Document that URL and Homepage package headers are
 interchangeable.
Date: Tue,  6 Mar 2018 14:52:14 +0000

* doc/lispref/tips.texi:
URL is an alias for Homepage.
---
 doc/lispref/tips.texi | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/lispref/tips.texi b/doc/lispref/tips.texi
index 0695d9b7b1..daf9f5442a 100644
--- a/doc/lispref/tips.texi
+++ b/doc/lispref/tips.texi
@@ -1045,6 +1045,9 @@ rather than just the relevant Finder keywords.
 @item Homepage
 This line states the homepage of the library.
 
+@item URL
+This is an alias for @samp{Homepage}.
+
 @item Package-Version
 If @samp{Version} is not suitable for use by the package manager, then
 a package can define @samp{Package-Version}; it will be used instead.
-- 
2.14.3

Message #16 received at 30571-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Peter Oliver <p.d.oliver <at> mavit.org.uk>
Cc: 30571-done <at> debbugs.gnu.org, git <at> mavit.org.uk
Subject: Re: bug#30571: [PATCH] Document that URL and Homepage package headers
 are interchangeable.
Date: Sat, 10 Mar 2018 13:58:35 +0200

> From: Peter Oliver <p.d.oliver <at> mavit.org.uk>
> Date: Tue,  6 Mar 2018 14:52:14 +0000
> Cc: Peter Oliver <git <at> mavit.org.uk>
> 
> * doc/lispref/tips.texi:
> URL is an alias for Homepage.

Thanks, fixed.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.