More advice on clone, backporting https://github.com/jenkinsci/pipeline-groovy-lib-plugin/pull/57/files/b7bd7741e05e751584afd78b1dc6f47dd06d4129..698ae6887eae199e4b5da9b478f5039265562350#diff-d9ea39311c121ef001c2131af309031434afafb5a19bd5961747f2c1f7082768R399

Author: jglick

src/main/resources/org/jenkinsci/plugins/workflow/libs/SCMBasedRetriever/help-clone.html

@@ -1,6 +1,8 @@
 <div>
     If checked, every build performs a fresh clone of the SCM rather than locking and updating a common copy.
     No changelog will be computed.
-    For Git, you are advised to select <b>Advanced clone behaviors » Shallow clone</b> to make the clone much faster.
+    For Git, you are advised to add <b>Advanced clone behaviors</b>
+    and then check <b>Shallow clone</b> and <b>Honor refspec on initial clone</b> and uncheck <b>Fetch tags</b>
+    to make the clone much faster.
     You may still enable <b>Cache fetched versions on controller for quick retrieval</b> if you prefer.
 </div>

src/test/java/org/jenkinsci/plugins/workflow/libs/SCMSourceRetrieverTest.java

@@ -62,6 +62,7 @@
 import static hudson.ExtensionList.lookupSingleton;
 import hudson.plugins.git.extensions.impl.CloneOption;
 import jenkins.plugins.git.traits.CloneOptionTrait;
+import jenkins.plugins.git.traits.RefSpecsSCMSourceTrait;
 import jenkins.scm.api.trait.SCMSourceTrait;
 import static org.hamcrest.Matchers.contains;
 import static org.hamcrest.Matchers.containsInAnyOrder;
@@ -379,7 +380,9 @@ public static class BasicSCMSource extends SCMSource {
         sampleRepo.git("add", ".");
         sampleRepo.git("commit", "--message=init");
         GitSCMSource src = new GitSCMSource(sampleRepo.toString());
-        src.setTraits(List.<SCMSourceTrait>of(new CloneOptionTrait(new CloneOption(true, null, null))));
+        CloneOption cloneOption = new CloneOption(true, true, null, null);
+        cloneOption.setHonorRefspec(true);
+        src.setTraits(List.<SCMSourceTrait>of(new CloneOptionTrait(cloneOption), new RefSpecsSCMSourceTrait("+refs/heads/master:refs/remotes/origin/master")));
         SCMSourceRetriever scm = new SCMSourceRetriever(src);
         LibraryConfiguration lc = new LibraryConfiguration("echoing", scm);
         lc.setIncludeInChangesets(false);
@@ -392,6 +395,8 @@ public static class BasicSCMSource extends SCMSource {
         r.assertLogContains("something special", b);
         r.assertLogContains("Deleted .git, README.md", b);
         r.assertLogContains("Using shallow clone with depth 1", b);
+        r.assertLogContains("Avoid fetching tags", b);
+        r.assertLogNotContains("+refs/heads/*:refs/remotes/origin/*", b);
     }
 
     @Test public void cloneModeLibraryPath() throws Exception {