From b7b6884d2f7ccaafa467496cf3b541209dc2d0c7 Mon Sep 17 00:00:00 2001 From: danimtb Date: Fri, 31 May 2019 11:19:44 +0200 Subject: [PATCH 1/3] Rewrite of the SCM optimization tip box --- creating_packages/package_repo.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/creating_packages/package_repo.rst b/creating_packages/package_repo.rst index 90612143ff3d..d0cbb4e7b264 100644 --- a/creating_packages/package_repo.rst +++ b/creating_packages/package_repo.rst @@ -172,8 +172,8 @@ be valid too: .. tip:: - While you are in the same computer (the same Conan cache), even when you have exported the recipe and - Conan has captured the absolute url and commit, Conan will store the local folder where your source code lives. - If you build your package locally, it will use the local repository (in the local folder) instead of the remote URL, - even if the local directory contains uncommitted changes. - This allows you to speed up the development of your packages when cloning from a local repository. + When doing a :command:`conan create` of a recipe using ``scm``, Conan will store a local path to the local source repository. Every time + you want to create a new package, the sources will not be downloaded from the remote repository but from the local one. + + This allows to build packages making changes to the source code without the need of committing them and pushing them to the remote + repository. This convenient to speed up the development of your packages when cloning from a local repository. From 17baf523a41cce6366422e695db97f6f4f9580d1 Mon Sep 17 00:00:00 2001 From: danimtb Date: Fri, 31 May 2019 13:35:09 +0200 Subject: [PATCH 2/3] review --- creating_packages/package_repo.rst | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/creating_packages/package_repo.rst b/creating_packages/package_repo.rst index d0cbb4e7b264..53ec634b54be 100644 --- a/creating_packages/package_repo.rst +++ b/creating_packages/package_repo.rst @@ -172,8 +172,11 @@ be valid too: .. tip:: - When doing a :command:`conan create` of a recipe using ``scm``, Conan will store a local path to the local source repository. Every time - you want to create a new package, the sources will not be downloaded from the remote repository but from the local one. + When doing a :command:`conan create` of a recipe using ``scm``, Conan will save the path to the local source repository. Every time the + :command:`conan create` command is ivoked, the sources will not be downloaded from the remote repository but from the local one. This allows to build packages making changes to the source code without the need of committing them and pushing them to the remote repository. This convenient to speed up the development of your packages when cloning from a local repository. + + **Warning:** This optimization can lead to non-reproducible packages if changes in the source code are not committed and the recipe is + uploaded with its packages to a remote. From 7cae1d5a49fce8c15d94d9ae353775f0428e38c0 Mon Sep 17 00:00:00 2001 From: Daniel Date: Fri, 31 May 2019 15:30:23 +0200 Subject: [PATCH 3/3] Update creating_packages/package_repo.rst Co-Authored-By: Javier G. Sogo --- creating_packages/package_repo.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/creating_packages/package_repo.rst b/creating_packages/package_repo.rst index 53ec634b54be..ce10330d5033 100644 --- a/creating_packages/package_repo.rst +++ b/creating_packages/package_repo.rst @@ -173,7 +173,7 @@ be valid too: .. tip:: When doing a :command:`conan create` of a recipe using ``scm``, Conan will save the path to the local source repository. Every time the - :command:`conan create` command is ivoked, the sources will not be downloaded from the remote repository but from the local one. + :command:`conan create` command is invoked, the sources will not be downloaded from the remote repository but copied from the local directory. This allows to build packages making changes to the source code without the need of committing them and pushing them to the remote repository. This convenient to speed up the development of your packages when cloning from a local repository.