summaryrefslogtreecommitdiff
path: root/doc/lispref
diff options
context:
space:
mode:
authorJonas Bernoulli <jonas@bernoul.li>2012-12-19 14:51:40 -0500
committerStefan Monnier <monnier@iro.umontreal.ca>2012-12-19 14:51:40 -0500
commitee3c0aeca4e1e31e2b171a4753782a37076e7457 (patch)
tree969ab619c9555b98971146b54d48f25ca94f33ec /doc/lispref
parentf4d79bd021831eb64e1bfc7f5c5b1ddb2138b37a (diff)
downloademacs-ee3c0aeca4e1e31e2b171a4753782a37076e7457.tar.gz
* lisp/emacs-lisp/lisp-mnt.el (lm-section-end): Always end before the
following non-comment text. (lm-header-multiline): Continuation lines need to be indented more than the first line. (lm-homepage): New function. (lm-with-file): Don't be confused if narrowing is in effect. * doc/lispref/tips.texi (Library Headers): New header keyword `Homepage'. Make continuation lines syntax more precise. Fixes: debbugs:13207
Diffstat (limited to 'doc/lispref')
-rw-r--r--doc/lispref/ChangeLog5
-rw-r--r--doc/lispref/tips.texi7
2 files changed, 10 insertions, 2 deletions
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index a0bbafb116f..d8a825374ed 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2012-12-19 Jonas Bernoulli <jonas@bernoul.li>
+
+ * tips.texi (Library Headers): New header keyword `Homepage'.
+ Make continuation lines syntax more precise.
+
2012-12-17 Eli Zaretskii <eliz@gnu.org>
* files.texi (File Attributes, Changing Files): Update to include
diff --git a/doc/lispref/tips.texi b/doc/lispref/tips.texi
index d54d91b238a..854ce8f124f 100644
--- a/doc/lispref/tips.texi
+++ b/doc/lispref/tips.texi
@@ -942,6 +942,7 @@ explains these conventions, starting with an example:
;; Created: 14 Jul 2010
@group
;; Keywords: languages
+;; Homepage: http://example.com/foo
;; This file is not part of GNU Emacs.
@@ -980,8 +981,7 @@ the conventional possibilities for @var{header-name}:
@item Author
This line states the name and email address of at least the principal
author of the library. If there are multiple authors, list them on
-continuation lines led by @code{;;} and whitespace (this is easier
-for tools to parse than having more than one author on one line).
+continuation lines led by @code{;;} and a tab or at least two spaces.
We recommend including a contact email address, of the form
@samp{<@dots{}>}. For example:
@@ -1028,6 +1028,9 @@ The name of this field is unfortunate, since people often assume it is
the place to write arbitrary keywords that describe their package,
rather than just the relevant Finder keywords.
+@item Homepage
+This line states the homepage of the library.
+
@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.