Clarify where to run vcpkg integrate install from

[mloskot]

Is it required to run integrate install from Vcpkg installation folder

cd c:\vcpkg
vcpkg integrate install

or is it correct to run it from any location

set PATH=c:\vcpkg;%PATH%
vcpkg integrate install

it is not cleared up in the docs, AFAICT.

References

#1874

[ras0219-msft]

Thanks for posting this issue!

Either way should work identically* for general usage.

*(we do take current directory into account if you have multiple vcpkg instances -- if your current path is inside a vcpkg repo, we will use that as the root instead of the one containing the vcpkg.exe you are running)

[MVoz]

@mloskot так не проще?
c:\vcpkg\vcpkg.exe integrate install

[mloskot]

@voskrese

@mloskot так не проще?

I wish, but I can't read it, sorry.

c:\vcpkg\vcpkg.exe integrate install

That makes the third option, indeed.

@ras0219-msft Does this summary express the correct behaviours?

1. cd c:\vcpkg && vcpkg.exe integrate install - integrates current directory c:\vcpkg as Vcpkg repo

2. set PATH=c:\vcpkg;%PATH% && cd \ && vcpkg.exe integrate install - integrates vcpkg.exe's directory c:\vcpkg as Vcpkg repo

3. cd \ && c:\vcpkg\vcpkg.exe integrate install - same as 2.

4. cd c:\secondary-vcpkg && c:\main-vcpkg\vcpkg.exe integrate install - integrates current directory c:\secondary-vcpkg as Vcpk repo, regardless where of vcpkg.exe location.

[ras0219-msft]

Yes, that's correct. The steps are simply:

1. Determine the vcpkg root to execute in (via the process above)
2. Set this as the user-wide instance / Install package / Search the ports dir / etc

[mloskot]

I sense it is worth to include such explanation in the docs, but I'm not seeing how to document it neatly, without making the docs too overwhelming with too many examples really.

[mloskot]

@ras0219-msft If you could point location where such info would belong best in the docs (FAQ?), then I will try to prepare PR, so we can get it closed :)

[NancyLi1013]

Hi @mloskot

Personally speaking, where to run vcpkg integrate install has been clarified in README.md and you can also refer to this doc to learn the detailed introduction about this command.