bug#30571: URL vs Homepage in package headers

bug#30571: URL vs Homepage in package headers

[Peter Oliver]

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

bug#30571: URL vs Homepage in package headers

[Glenn Morris]

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

bug#30571: [PATCH] Document that URL and Homepage package headers are interchangeable.

[Peter Oliver]

* 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

bug#30571: [PATCH] Document that URL and Homepage package headers are interchangeable.

[Eli Zaretskii]

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

Thanks, fixed.