/ README.md
README.md
 1  # Try
 2  
 3  Try is a package that allows you to try out Emacs packages without installing
 4  them. If you pass a URL to a plain text `.el`-file it evaluates the content,
 5  without storing the file.
 6  
 7  Packages from ELPA will be stored in a temporary directory by default.
 8  
 9  ## Installation
10  
11  You can install Try using elpa.
12  
13  It's available on [melpa](http://melpa.milkbox.net/):
14  
15  <kbd> M-x package-install try </kbd>
16  
17  ## Usage
18  
19  To try out a package you can run
20  
21  <kbd> M-x try RET some-package </kbd>
22  
23  Or if you want to try out some package from the web, just paste in the URL
24  
25  <kbd> M-x try RET https://url.com/to/some/file.el </kbd>
26  
27  ### Example
28  
29  If you for instance have [melpa](http://melpa.org/) in your `package-archives`
30  you can try [multiple cursors](https://github.com/magnars/multiple-cursors.el)
31  by running:
32  
33  <kbd> M-x try RET multiple-cursors RET </kbd>
34  
35  If you on the other hand want to test out a single `.el`-file from somewhere
36  you can simply insert an URL. Trying out
37  [Leuven-theme](https://github.com/fniessen/emacs-leuven-theme) can be done by
38  running:
39  
40  <kbd> M-x try RET https://raw.githubusercontent.com/fniessen/emacs-leuven-theme/master/leuven-theme.el RET </kbd>
41  
42  Unfortunately, you won't be able to try Try with <kbd> M-x try RET try </kbd>.