Commit b2e3794a authored by Reuben Thomas's avatar Reuben Thomas

Make el-get-recipe-path non-customizable, and explain how to use it (issue #1164)

parent 25a41b17
......@@ -166,6 +166,7 @@ Here is the basic setup to add to your `user-init-file` (`.emacs`):
(goto-char (point-max))
(add-to-list 'el-get-recipe-path "~/.emacs.d/el-get-user/recipes")
(el-get 'sync)
......@@ -37,7 +37,7 @@
:type 'directory)
(defcustom el-get-recipe-path
(defvar el-get-recipe-path
(list (concat (file-name-directory el-get-script) "recipes")
......@@ -45,9 +45,14 @@
Directories that contain automatically-generated recipes, such as
`el-get-recipe-path-emacswiki' and `el-get-recipe-path-elpa',
should be placed last in this list."
:group 'el-get
:type '(repeat (directory)))
should be placed last in this list.
This variable is not customizable, as it needs to be set before
el-get is loaded, while customizations should be loaded after
el-get, so that they can affect pacakages loaded by el-get.
It is recommended to add new directories using code like:
(add-to-list 'el-get-recipe-path \"~/.emacs.d/el-get-user/recipes/\")")
(defcustom el-get-user-package-directory nil
"Define where to look for init-pkgname.el configurations. Disabled if nil."
......@@ -365,6 +365,7 @@ next emacs startup the installed packages are initialized.
(goto-char (point-max))
(add-to-list 'el-get-recipe-path "~/.emacs.d/el-get-user/recipes")
(el-get 'sync)
@end example
......@@ -614,10 +615,11 @@ cached, so that you can still start Emacs even if you remove the
recipe file.
The variable @code{el-get-recipe-path} is a list of directory paths
where to look for recipe files, in order. The recipe for a package
to search for recipe files, in order. The recipe for a package
@code{example} must be named @code{example.rcp}. The first file named
that way in the @code{el-get-recipe-path} variable is used as the
recipe. If you need to change it, you should do so immediately before
running @code{el-get}; see the example in @xref{Basic Setup}.
To check which recipe is used for a given package, use either the
@code{M-x el-get-describe} or @code{M-x el-get-find-recipe-file}
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment