From db22befc76f8b7304693fc6a47a552af896bb7e3 Mon Sep 17 00:00:00 2001 From: Jordi Boggiano Date: Tue, 18 Jun 2013 14:43:21 +0200 Subject: [PATCH] Add warning to docs about package repos, refs #2011 #563 --- doc/05-repositories.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/05-repositories.md b/doc/05-repositories.md index bad3c2080..dab0abb4d 100644 --- a/doc/05-repositories.md +++ b/doc/05-repositories.md @@ -442,6 +442,14 @@ Here is an example for the smarty template engine: Typically you would leave the source part off, as you don't really need it. +> **Note**: This repository type has a few limitations and should be avoided +> whenever possible: +> +> - Composer will not update the package unless you change the `version` field. +> - Composer will not update the commit references, so if you use `master` as +> reference you will have to delete the package to force an update, and will +> have to deal with an unstable lock file. + ## Hosting your own While you will probably want to put your packages on packagist most of the time,