{"action":"created","issue":{"url":"https://api.github.com/repos/Microsoft/vcpkg/issues/1874","repository_url":"https://api.github.com/repos/Microsoft/vcpkg","labels_url":"https://api.github.com/repos/Microsoft/vcpkg/issues/1874/labels{/name}","comments_url":"https://api.github.com/repos/Microsoft/vcpkg/issues/1874/comments","events_url":"https://api.github.com/repos/Microsoft/vcpkg/issues/1874/events","html_url":"https://github.com/Microsoft/vcpkg/issues/1874","id":260544963,"number":1874,"title":"Document vcpkg installation and possible variants","user":{"login":"mloskot","id":80741,"avatar_url":"https://avatars2.githubusercontent.com/u/80741?v=4","gravatar_id":"","url":"https://api.github.com/users/mloskot","html_url":"https://github.com/mloskot","followers_url":"https://api.github.com/users/mloskot/followers","following_url":"https://api.github.com/users/mloskot/following{/other_user}","gists_url":"https://api.github.com/users/mloskot/gists{/gist_id}","starred_url":"https://api.github.com/users/mloskot/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mloskot/subscriptions","organizations_url":"https://api.github.com/users/mloskot/orgs","repos_url":"https://api.github.com/users/mloskot/repos","events_url":"https://api.github.com/users/mloskot/events{/privacy}","received_events_url":"https://api.github.com/users/mloskot/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":1,"created_at":"2017-09-26T08:59:30Z","updated_at":"2018-03-18T21:16:48Z","closed_at":null,"author_association":"CONTRIBUTOR","body":"The installation process is only briefely explained in the docs as `git clone`, `bootstrap-vcpkg.bat` and, optionally, `vcpkg integrate install`.\r\n\r\nThis is fine for default setup, but there is more details that really need to be covered in the documentation.\r\n\r\nSome of obvious questions\"\r\n\r\n1. Shall I copy `vcpkg.exe` anywhere?\r\n1. Can I copy `vcpkg.exe` anywhere (eg. `c:\\bin\\vcpkg.exe` which I have in `PATH`) or it has to stick to location where it was bootstrapped?\r\n1. Can I control location where `vcpkg.exe` downloads/installs packages in?\r\n1. What is the `{vcpkg}\\buildtrees` directory for?\r\n1. What is the `{vcpkg}\\installed` directory for?\r\n1. What is the `{vcpkg}\\downloads` directory for?\r\n1. What is the `{vcpkg}\\packages` directory for?\r\n1. What is the relation between the working copy where `vcpkg.exe` was bootstrapped and location where packages are installed?\r\n1. Having `C:\\vcpkg-1\\vcpkg.exe` and `C:\\vcpkg-2\\vcpkg.exe`, do I maintain two sets of packages (two installation prefixes, in Unix speak)\r\n1. Do such multiple working copies affect the user-wide integration?\r\n1. Does use of such multiple working copies require use of the CMake toolchain file only?\r\n1. Having the multiple working copies, can I mix integration modes? For example\r\n  * `C:\\vcpkg-1\\vcpkg.exe` is user-wide integrated\r\n  * `C:\\vcpkg-2\\vcpkg.exe` is used via the CMake toolchain file only\r\n\r\nSo far, user has to fish for (correct?) answers in the issues archive and compile the information from **scraps**, hoping the bigger picture generated is correct.\r\n\r\nFor example, https://github.com/Microsoft/vcpkg/issues/1681#issuecomment-324160402 suggests to clone a second copy...\r\n\r\n## References\r\n\r\n#3044\r\n#3052 \r\n"},"comment":{"url":"https://api.github.com/repos/Microsoft/vcpkg/issues/comments/374048115","html_url":"https://github.com/Microsoft/vcpkg/issues/1874#issuecomment-374048115","issue_url":"https://api.github.com/repos/Microsoft/vcpkg/issues/1874","id":374048115,"user":{"login":"mloskot","id":80741,"avatar_url":"https://avatars2.githubusercontent.com/u/80741?v=4","gravatar_id":"","url":"https://api.github.com/users/mloskot","html_url":"https://github.com/mloskot","followers_url":"https://api.github.com/users/mloskot/followers","following_url":"https://api.github.com/users/mloskot/following{/other_user}","gists_url":"https://api.github.com/users/mloskot/gists{/gist_id}","starred_url":"https://api.github.com/users/mloskot/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mloskot/subscriptions","organizations_url":"https://api.github.com/users/mloskot/orgs","repos_url":"https://api.github.com/users/mloskot/repos","events_url":"https://api.github.com/users/mloskot/events{/privacy}","received_events_url":"https://api.github.com/users/mloskot/received_events","type":"User","site_admin":false},"created_at":"2018-03-18T21:16:48Z","updated_at":"2018-03-18T21:16:48Z","author_association":"CONTRIBUTOR","body":"@ras0219-msft  This is excellent, thank you!\r\n\r\nI think this could be copied verbatim into new \"Installation\" section in the FAQ."}}
{"actor":{"display_login":"mloskot"}}