public-mirrors
/
composer
mirror of https://github.com/composer/composer
1
0
Fork 0
Code

Reinforce language about not specifying the version

pull/802/head
Jordi Boggiano 2012-06-14 15:08:38 +02:00
parent db7f25baaf
commit 4c75a2db01
1 changed files with 8 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
doc/02-libraries.md
View File

@ -28,19 +28,19 @@ convention is all lowercase and dashes for word separation.
## Specifying the version
You need to specify the version some way. Depending on the type of repository
you are using, it might be possible to omit it from `composer.json`, because
the repository is able to infer the version from elsewhere.
You need to specify the package's version some way. When you publish your
package on Packagist, it is able to infer the version from the VCS (git, svn,
hg) information, so in that case you do not have to specify it, and it is
recommended not to. See [tags](#tags) and [branches](#branches) to see how
version numbers are extracted from these.
If you do want to specify it explicitly, you can just add a `version` field:
If you are creating packages by hand and really have to specify it explicitly,
you can just add a `version` field:
{
"version": "1.0.0"
}
However if you are using git, svn or hg, you don't have to specify it.
Composer will detect versions as follows:
### Tags
For every tag that looks like a version, a package version of that tag will be
@ -75,7 +75,6 @@ Here are some examples of version branch names:
1.1.x
> **Note:** When you install a dev version, it will install it from source.
See [Repositories](05-repositories.md) for more information.
### Aliases