Browse Source

ExternalProject: Extend documentation about GIT_TAG usage

When GIT_SHALLOW is used, the '--depth 1 --no-single-branch'
arguments are add. It means that only branch names and tags
is downloaded to repository. Most Commit Hash is not working.
With this commit the documentation was updated, to describe
the limitation of GIT_SHALLOW.
Bartosz Kosiorek 6 năm trước cách đây
mục cha
commit
c58f5e116e
1 tập tin đã thay đổi với 3 bổ sung0 xóa
  1. 3 0
      Modules/ExternalProject.cmake

+ 3 - 0
Modules/ExternalProject.cmake

@@ -251,6 +251,9 @@ External Project Definition
           The lack of such deterministic behavior makes the main project lose
           traceability and repeatability.
 
+        If ``GIT_SHALLOW`` is enabled then ``GIT_TAG`` works only with
+        branch names and tags.  A commit hash is not allowed.
+
       ``GIT_REMOTE_NAME <name>``
         The optional name of the remote. If this option is not specified, it
         defaults to ``origin``.