mirror of
https://github.com/correl/melpa.git
synced 2024-12-23 11:14:57 +00:00
Remove commented-out paragraph in README (see #367) and clean up whitespace
This commit is contained in:
Steve Purcell
parent
f04a25e467
commit
92abe5bf31
1 changed files with 16 additions and 21 deletions
37
README.md
37
README.md
|
|
@ -32,7 +32,7 @@ call to `package-initialize` in your `init.el` file.
|
|||
|
||||
(add-to-list 'package-archives
|
||||
'("melpa" . "http://melpa.milkbox.net/packages/") t)
|
||||
|
||||
|
||||
Since `package.el` doesn't allow locking packages to certain version,
|
||||
we also provide a package `melpa.el` which contains code to allow
|
||||
restricting packages to specific repositories. This allows someone to
|
||||
|
|
@ -52,11 +52,7 @@ guidelines,
|
|||
* Upstream source must be stored in an authoritative
|
||||
[SCM](http://en.wikipedia.org/wiki/Software_configuration_management)
|
||||
repository or on the Emacswiki.
|
||||
|
||||
<!-- * Package must be actively developed and not otherwise included in a -->
|
||||
<!-- different ELPA archive. Packages that are better suited for -->
|
||||
<!-- [marmalade](http://marmalade-repo.org/) -->
|
||||
|
||||
|
||||
* Submit one pull request per recipe. You can create multiple
|
||||
branches and create a pull request for each branch.
|
||||
|
||||
|
|
@ -64,16 +60,16 @@ guidelines,
|
|||
specifying only files relevant to the package. See the
|
||||
[Package Format](#package-format) section for more information on
|
||||
specifying package files.
|
||||
|
||||
|
||||
* The package name should match the name of the feature provided. See
|
||||
the `package` function for more information.
|
||||
|
||||
|
||||
* Packages should adhere to the `package.el` format as specified by
|
||||
`(info "(elisp) Packaging")`. More information on this format is
|
||||
provided by the
|
||||
[marmalade package manual](http://marmalade-repo.org/doc-files/package.5.html).
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### Testing
|
||||
|
||||
|
|
@ -86,7 +82,7 @@ Let `<NAME>` denote the name of the recipe to submit.
|
|||
3. Confirm your package build properly by running
|
||||
|
||||
make recipes/<NAME>
|
||||
|
||||
|
||||
4. Install the file you built by running `package-install-file` from
|
||||
within Emacs and specifying the newly built package in the directory
|
||||
specified by `package-build-archive-dir` (default: `packages/`
|
||||
|
|
@ -174,7 +170,7 @@ Since there is only one `.el` file, this package only needs the `:url` and `:fet
|
|||
(ido-ubiquitous
|
||||
:url "https://github.com/DarwinAwardWinner/ido-ubiquitous.git"
|
||||
:fetcher git)
|
||||
```
|
||||
```
|
||||
|
||||
### Multiple Packages in one Repository
|
||||
|
||||
|
|
@ -191,7 +187,7 @@ contains the *starter-kit* package along with extra packages in the
|
|||
:url "https://github.com/technomancy/emacs-starter-kit.git"
|
||||
:fetcher git
|
||||
:files ("modules/starter-kit-bindings.el"))
|
||||
```
|
||||
```
|
||||
|
||||
Notice that `:files` is not specified for `starter-kit` since
|
||||
package-build will automatically add all `.el` files in the root
|
||||
|
|
@ -202,10 +198,10 @@ files specified explicitly.
|
|||
|
||||
### Multiple Files in Multiple Directories
|
||||
|
||||
There are special cases when we need
|
||||
There are special cases when we need
|
||||
There are special cases where creation of the package comes from many
|
||||
different sub-directories in the repository and the destination
|
||||
sub-directories need to be explicitly set.
|
||||
sub-directories need to be explicitly set.
|
||||
|
||||
Consider the `flymake-perlcritic` recipe,
|
||||
|
||||
|
|
@ -230,7 +226,7 @@ first element to be the destination directory. These can be embedded
|
|||
further, such as the following---hypothetical---entry for `:files`,
|
||||
|
||||
```elisp
|
||||
("*.el" ("snippets"
|
||||
("*.el" ("snippets"
|
||||
("html-mode" "snippets/html-mode/*")
|
||||
("python-mode" "snippets/python-mode/*")))
|
||||
```
|
||||
|
|
@ -316,17 +312,17 @@ format.
|
|||
* `clean-packages` -- remove all compiled packages from the `packages` directory.
|
||||
|
||||
* `clean-json` -- remove all JSON files.
|
||||
|
||||
|
||||
Note that these scripts require an Emacs with `package.el` installed,
|
||||
such as Emacs 24. If you have an older version of Emacs, you can get a
|
||||
suitable `package.el` [here](http://bit.ly/pkg-el23).
|
||||
|
||||
|
||||
[melpa]: http://melpa.milkbox.net
|
||||
|
||||
|
||||
## API
|
||||
|
||||
All repository code is contained in the `package-build.el`.
|
||||
All repository code is contained in the `package-build.el`.
|
||||
|
||||
### Functions
|
||||
|
||||
|
|
@ -397,7 +393,7 @@ which packages will be enabled (whitelist packages only) or excluded
|
|||
`package-archives`, PACKAGE is a symbol of a package in that
|
||||
archive to exclude. Any specified package is excluded regardless
|
||||
of the value of `package-archive-enable-alist`
|
||||
|
||||
|
||||
|
||||
If a particular ARCHIVE has an entry in
|
||||
`package-archive-enable-alist` then only packages
|
||||
|
|
@ -422,4 +418,3 @@ You can install the package manually by pasting this into yoru `*scratch*` buffe
|
|||
|
||||
*MELPA* is *Milkypostman's ELPA* or *Milkypostman's Experimental Lisp
|
||||
Package Archive* if you're not into the whole brevity thing.
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue