{"action":"closed","issue":{"url":"https://api.github.com/repos/fsharp/FAKE/issues/922","repository_url":"https://api.github.com/repos/fsharp/FAKE","labels_url":"https://api.github.com/repos/fsharp/FAKE/issues/922/labels{/name}","comments_url":"https://api.github.com/repos/fsharp/FAKE/issues/922/comments","events_url":"https://api.github.com/repos/fsharp/FAKE/issues/922/events","html_url":"https://github.com/fsharp/FAKE/issues/922","id":102672227,"number":922,"title":"add xmldoc description to --list-targets","user":{"login":"ctaggart","id":80104,"avatar_url":"https://avatars2.githubusercontent.com/u/80104?v=4","gravatar_id":"","url":"https://api.github.com/users/ctaggart","html_url":"https://github.com/ctaggart","followers_url":"https://api.github.com/users/ctaggart/followers","following_url":"https://api.github.com/users/ctaggart/following{/other_user}","gists_url":"https://api.github.com/users/ctaggart/gists{/gist_id}","starred_url":"https://api.github.com/users/ctaggart/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ctaggart/subscriptions","organizations_url":"https://api.github.com/users/ctaggart/orgs","repos_url":"https://api.github.com/users/ctaggart/repos","events_url":"https://api.github.com/users/ctaggart/events{/privacy}","received_events_url":"https://api.github.com/users/ctaggart/received_events","type":"User","site_admin":false},"labels":[{"id":604469753,"url":"https://api.github.com/repos/fsharp/FAKE/labels/area:core-api","name":"area:core-api","color":"0052cc","default":false},{"id":599605474,"url":"https://api.github.com/repos/fsharp/FAKE/labels/area:core-runtime","name":"area:core-runtime","color":"0052cc","default":false},{"id":456374026,"url":"https://api.github.com/repos/fsharp/FAKE/labels/enhancement","name":"enhancement","color":"bfd4f2","default":true},{"id":67222480,"url":"https://api.github.com/repos/fsharp/FAKE/labels/help%20wanted","name":"help wanted","color":"009800","default":true}],"state":"closed","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":3,"created_at":"2015-08-23T23:43:11Z","updated_at":"2018-02-04T00:59:07Z","closed_at":"2018-02-04T00:59:07Z","author_association":"CONTRIBUTOR","body":"Only today did I discover the [--list-targets](http://fsharp.github.io/FAKE/specifictargets.html) option. Besides being able to [make it a default option](https://github.com/fsharp/FAKE/pull/921), it would be great if it included the description from the xmldoc.\n\n![image](https://cloud.githubusercontent.com/assets/80104/9430696/40d604c8-49b4-11e5-9ddc-2353e46ddc9b.png)\n\nIt would be even better if `listTargets()` included the documentation for the target.\n![image](https://cloud.githubusercontent.com/assets/80104/9430704/77a4430c-49b4-11e5-8838-ccb257436ee7.png)\n\nPerhaps it should be the xmldoc of the target function.\n\n``` fsharp\n/// start a web server and watch for slide edits\nlet keepRunning() =\n    use watcher = !! (slidesDir + \"/**/*.*\") |> WatchChanges (fun changes ->\n         handleWatcherEvents changes\n    )\n    startWebServer ()\n    traceImportant \"Waiting for slide edits. Press any key to stop.\"\n    System.Console.ReadKey() |> ignore\n    watcher.Dispose()\n\nTarget \"KeepRunning\" keepRunning\n\nTarget \"ReleaseSlides\" (\n    /// push the slides to GitHub gh-pages branch\n    fun _ ->\n    if gitOwner = \"myGitUser\" || gitProjectName = \"MyProject\" then\n        failwith \"You need to specify the gitOwner and gitProjectName in build.fsx\"\n    let tempDocsDir = __SOURCE_DIRECTORY__ @@ \"temp/gh-pages\"\n    CleanDir tempDocsDir\n    Repository.cloneSingleBranch \"\" (gitHome + \"/\" + gitProjectName + \".git\") \"gh-pages\" tempDocsDir\n\n    fullclean tempDocsDir\n    CopyRecursive outDir tempDocsDir true |> tracefn \"%A\"\n    StageAll tempDocsDir\n    Git.Commit.Commit tempDocsDir \"Update generated slides\"\n    Branches.push tempDocsDir\n)\n```\n"}}
{"actor":{"display_login":"matthid"}}