8000 Added some details about deps management. by adurieux · Pull Request #1111 · symfony/symfony-docs · GitHub
[go: up one dir, main page]
Skip to content

Added some details about deps management. #1111

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Mar 12, 2012
Merged

Added some details about deps management. #1111

Changes from 1 commit
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
f26fe66
Details about the deps file.
Feb 29, 2012
d031631
Renamed file.
Feb 29, 2012
847165c
Cleaned up formatting.
Feb 29, 2012
6230ba5
Spaces.
Feb 29, 2012
6a62921
More spaces...
Feb 29, 2012
8ee5441
Even more spaces...
Feb 29, 2012
d3f7fb0
Typo.
Feb 29, 2012
71ec9b0
Renamed file.
Feb 29, 2012
c7e8cc7
Changed levels.
Feb 29, 2012
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Even more spaces...
  • Loading branch information
Antoine DURIEUX committed Feb 29, 2012
commit 8ee54416bcab2dd9c37a39015a00adaed32214f0
19 changes: 5 additions & 14 deletions cookbook/workflow/vendor_deps.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -66,29 +66,20 @@ or upgraded. You can set that directly to the ``deps`` file :
version=the-awesome-version


* The ``git`` option sets the URL of the library. It can use various protocols,
like ``http://`` as well as ``git://``.
* The ``git`` option sets the URL of the library. It can use various protocols, like ``http://`` as well as ``git://``.

* The ``target`` option specifies where the repository will live : plain Symfony
bundles should go under the ``vendor/bundles/Acme`` directory, other third-party
libraries usually go to ``vendor/my-awesome-libreary-name``. The target directory
defaults to this last option when not specified.
* The ``target`` option specifies where the repository will live : plain Symfony bundles should go under the ``vendor/bundles/Acme`` directory, other third-party libraries usually go to ``vendor/my-awesome-libreary-name``. The target directory defaults to this last option when not specified.

* The ``version`` option allows you to set a specific revision. You can use a tag
(``version=origin/0.42``) or a branch name (``refs/remotes/origin/awesome-branch``).
It defaults to ``origin/HEAD``.
* The ``version`` option allows you to set a specific revision. You can use a tag (``version=origin/0.42``) or a branch name (``refs/remotes/origin/awesome-branch``). It defaults to ``origin/HEAD``.


Updating workflow
-----------------

When you execute the ``php bin/vendors install``, for every library, the script
first checks if the install directory exists.
When you execute the ``php bin/vendors install``, for every library, the script first checks if the install directory exists.

If it does not (and ONLY if it does not, it runs a ``git clone``.

Then, it does a ``git fetch origin`` and a ``git reset --hard the-awesome-version``.

This means that the repository will only be cloned once. If you want to perform
any change of the git remote, you MUST delete the entire target directory, not
only its content.
This means that the repository will only be cloned once. If you want to perform any change of the git remote, you MUST delete the entire target directory, not only its content.
0