11392 2017-04-20 04:05:50 +0000 Document how to specify a branch / tag / revision when using devtool add with a remote URL 2017-09-26 23:40:37 +0000 1 1 9 Documentation Reference handbook unspecified x86 Multiple RESOLVED FIXED 26 September 2017: RESOLVED Medium normal 2.5 M1 1 bluelightning kristi brianx.j.kurle poky.doc.watcher poky.watcher srifenbark --- --- Done (doc changes complete) oldest_to_newest 72698 0 bluelightning 2017-04-20 04:05:50 +0000 devtool add allows you to specify a remote URL to fetch from, which may be a git repository, but we don't currently appear to have documented how branches/revisions/tags can be specified. By default the latest revision on the master branch is found and used (as a fixed revision), but in many cases you'll want to specify either a source revision (;rev=something where something could be a tag or a commit hash), a branch (;branch=somebranch), or both. If instead of a specific revision you want to use the latest revision every time the recipe is built, then you need to use the -a / --autorev option, which may be used in conjunction with branch= to use the latest on a specific branch instead of master. An additional concern is if you are specifying any such parameters, because of the use of the ; character and typical Linux shell behaviour you will need to surround the URL in quotes e.g. "git://example.com/repo;branch=mybranch" . 72835 1 srifenbark 2017-04-25 15:29:43 +0000 Setting number of days. 72870 2 srifenbark 2017-04-26 18:44:32 +0000 Setting to 2.4 M1 and ACCEPTED. 73717 3 srifenbark 2017-06-05 23:03:30 +0000 Paul, Right now, the help for "devtool add" does not cover any of this detail. Are there plans to update the help output to include these details? Scott 77154 4 kristi 2017-09-26 22:34:38 +0000 I have updated the section here; http://www.yoctoproject.org/docs/2.4/ref-manual/ref-manual.html#devtool-adding-a-new-recipe-to-the-workspace I have also updated the Getting Help section with current output here; http://www.yoctoproject.org/docs/2.4/ref-manual/ref-manual.html#devtool-getting-help Please review and let me know if this is okay, or if additional changes are necessary. Thanks! 77157 5 bluelightning 2017-09-26 23:19:58 +0000 Looks good to me - and good job on documenting the new --srcbranch/--srcrev options rather than using the old method as I wrote in the bug description, I'd meant to come back here and note the change but forgot. Thanks! 77158 6 kristi 2017-09-26 23:40:37 +0000 Thanks Paul! Thanks for the quick review. Marking as doc flag Done and status RESOLVED.