Commit bfffd553 authored by Dimitri Fontaine's avatar Dimitri Fontaine

Move to version 5.1, rolling stable release.

parent b01e3e1a
......@@ -80,7 +80,7 @@ called by el-get from a `windows-nt` Emacs, see `system-type`). When using a
which contains the proper `install-info` version when you're not using the
*cygwin* Emacs binary.
## Stable Branch
## The Lazy Installer
To install El-Get you can use the *lazy-installer*. This will not load it
on startup or otherwise affect future usage of Emacs. If you wish to ensure
......@@ -105,40 +105,6 @@ Evaluating this code after copying it into your `*scratch*` buffer by typing
script. This script will then use `git` to clone El-Get and install it to
the default location (`~/.emacs.d/el-get/el-get`).
## Master Branch
The lazy installer above targets the current stable release. If you would
rather use the current development version you must clone the `master`
branch by ensuring the variable `el-get-master-branch` exists.
```lisp
;; So the idea is that you copy/paste this code into your *scratch* buffer,
;; hit C-j, and you have a working developper edition of el-get.
(url-retrieve
"https://raw.github.com/dimitri/el-get/master/el-get-install.el"
(lambda (s)
(let (el-get-master-branch)
(goto-char (point-max))
(eval-print-last-sexp))))
```
## Upgrading from 3.1 to 4.1
The development of El-Get 4.1 took a long time, and as a result a lot of
recipes have change in non compatible ways: some sources switched from `SVN`
to `git`, some revisited their hosting choice, etc.
As a result, lots of recipe should be *reinstalled* when upgrading. The
easiest way here might well be to just backup your `el-get-dir` directory
and start-up fresh with the new El-Get code:
mv ~/.emacs.d/el-get ~/.emacs.d/el-get-backup-3.stable
mkdir ~/.emacs.d/el-get
M-x el-get-self-update
That code sample assumes that `el-get-dir` is set to its default value, that
is `~/.emacs.d/el-get`.
# Setup
## Basic Setup
......@@ -170,22 +136,6 @@ Here is the basic setup to add to your `user-init-file` (`.emacs`):
(el-get 'sync)
```
And for those who prefer the master branch, please use the code below
```lisp
(add-to-list 'load-path "~/.emacs.d/el-get/el-get")
(unless (require 'el-get nil 'noerror)
(with-current-buffer
(url-retrieve-synchronously
"https://raw.github.com/dimitri/el-get/master/el-get-install.el")
(let (el-get-master-branch)
(goto-char (point-max))
(eval-print-last-sexp))))
(el-get 'sync)
```
## Package Setup
The easiest way to setup a given package is to add its initialization code
......
......@@ -35,6 +35,12 @@
;;; Change Log:
;;
;; 5.1 - 2014-01-11 - Rolling release
;;
;; - "master" branch is now considered forever stable
;; - many bug fixes
;; - many new recipes
;;
;; 4.1 - 2012-08-28 - To infinity, and beyond!
;;
;; - code refactoring
......@@ -176,7 +182,7 @@
(defgroup el-get nil "el-get customization group"
:group 'convenience)
(defconst el-get-version "4.0.7" "el-get version number")
(defconst el-get-version "5.1" "el-get version number")
(defconst el-get-script (or load-file-name buffer-file-name))
......@@ -313,13 +319,10 @@ updated when the package itself is."
"Message the current el-get version"
(interactive)
(let ((version
(if (string= (cadr (split-string el-get-version "\\.")) "0")
;; devel version, add the current git sha1 (short form)
(let ((default-directory (file-name-directory el-get-script)))
(concat el-get-version "."
(shell-command-to-string
"git --no-pager log -n1 --format=format:%h")))
el-get-version)))
(let ((default-directory (file-name-directory el-get-script)))
(concat el-get-version "."
(shell-command-to-string
"git --no-pager log -n1 --format=format:%h")))))
(kill-new version)
(message "el-get version %s" version)))
......
This is el-get.info, produced by makeinfo version 4.13 from el-get.texi.
This is el-get.info, produced by makeinfo version 4.8 from el-get.texi.
INFO-DIR-SECTION Emacs
START-INFO-DIR-ENTRY
......@@ -69,6 +69,11 @@ release while 3.1 is a stable release.
Please note that this versioning policy has been picked while backing
1.2~dev, so 1.0 was a "stable" release in fact. Ah, history.
El-Get is considered to now have reached a very stable state where it
only receives bug fixes, code refactoring, and new recipes. The current
version is now 5.1, which is stable, and maintained in the "master" git
branch.

File: el-get.info, Node: Acknowledgments, Next: Glossary, Prev: Introduction, Up: Top
......@@ -88,7 +93,8 @@ project, getting a commit bit and some management duties. He manages
tests and issues on github as much as he can spares time to El-Get.
Dave Abrahams contributed lots of code and efforts to make things
right™. He's still using El-Get, but decided to retire from the project.
right™. He's still using El-Get, but decided to retire from the
project.
Lots of people (more than we can list here) did contribute to El-Get
either recipes, bug fixes or ideas to implement, often with code. That
......@@ -155,8 +161,8 @@ Method
implements methods that targets `apt-get', `brew', `builtin',
`bzr', `cvs', `darcs', `elpa', `emacsmirror', `emacswiki', `fink',
`fossil', `git' and `git-svn', `github' `github-tar' and
`github-zip', `hg', `http' `http-tar' and `http-zip', `pacman' and
`svn'.
`github-zip', `go', `hg', `http' `http-tar' and `http-zip',
`pacman' and `svn'.
Notification
El-Get notifies its user when a package is done installing,
......@@ -1026,37 +1032,37 @@ convenient if you want to check multiple recipes at once.

Tag Table:
Node: Top769
Node: Introduction1234
Node: Acknowledgments2308
Node: Glossary3758
Ref: Glossary - Init4854
Ref: Glossary - Install5156
Ref: Glossary - Recipe6243
Ref: Glossary - Status6667
Ref: Glossary - Update6925
Node: Installing7163
Node: Install the developper version8036
Node: Skip Emacswiki recipes when installing8781
Node: Usage9617
Node: Setup11906
Node: Basic Setup12302
Node: The el-get function13613
Node: Distributed Setup14889
Node: Setup Customization16931
Node: User Init18077
Node: Before and After properties18764
Node: Initialization files20272
Node: Recipes20925
Node: Organizing recipes21400
Node: Getting more recipes23031
Node: Overriding package files23729
Node: Authoring Recipes24112
Node: Recipe format24727
Node: Dependencies34516
Node: Byte Compilation34862
Node: Autoloads35428
Node: Build36554
Node: Recipe checker37526
Node: Top768
Node: Introduction1233
Node: Acknowledgments2533
Node: Glossary3983
Ref: Glossary - Init5079
Ref: Glossary - Install5381
Ref: Glossary - Recipe6474
Ref: Glossary - Status6898
Ref: Glossary - Update7156
Node: Installing7394
Node: Install the developper version8267
Node: Skip Emacswiki recipes when installing9012
Node: Usage9848
Node: Setup12137
Node: Basic Setup12533
Node: The el-get function13844
Node: Distributed Setup15120
Node: Setup Customization17162
Node: User Init18308
Node: Before and After properties18995
Node: Initialization files20503
Node: Recipes21156
Node: Organizing recipes21631
Node: Getting more recipes23262
Node: Overriding package files23960
Node: Authoring Recipes24343
Node: Recipe format24958
Node: Dependencies34747
Node: Byte Compilation35093
Node: Autoloads35659
Node: Build36785
Node: Recipe checker37757

End Tag Table
......@@ -73,6 +73,11 @@ developer release while 3.1 is a stable release.
Please note that this versioning policy has been picked while backing
1.2~dev, so 1.0 was a "stable" release in fact. Ah, history.
El-Get is considered to now have reached a very stable state where it
only receives bug fixes, code refactoring, and new recipes. The
current version is now 5.1, which is stable, and maintained in the
``master'' git branch.
@node Acknowledgments
@chapter Acknowledgments
......
......@@ -2,7 +2,7 @@
:website "https://github.com/dimitri/el-get#readme"
:description "Manage the external elisp bits and pieces you depend upon."
:type github
:branch "4.stable"
:branch "master"
:pkgname "dimitri/el-get"
:info "."
:load "el-get.el")
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