Selector Syntax for Jenkins Plug-in

[wyattetal]

Is there a single documentation source for the selector API used within the jenkins plug-in? If so, what is the link?

[Misieq]

No did not find any single document.
 
However these two blog posts give some overview:
http://codicesoftware.blogspot.com/2012/01/evolution-of-plastic-scm-branches.html
http://codicesoftware.blogspot.com/2015/06/plastic-scm-integration-with-jenkins-ci.html

I personally use:

repository "repo_name"
   path "/"
      smartbranch "/full/path/to/branch"

If you want to use Jenkins job parameter to have same job working for different branches. There is one problem only - workspace will always be recreated from the scratch ('Use update' option is not working).

repository "%parameter_with_reponame%"
   path "/"
      smartbranch "%parameter_with_branchpath%"

[wyattetal]

Thanks.

 

I have concluded that the accepted practice is to use cm ss to generate the appropriate selector for a given workspace and make small mods from there, such as removing the changeset specifier.