Improve usage explanation, examples, and SEO for `vcpkg_find_acquire_program`

[nyoma-diamond]

Type of issue

Missing information

Description

Currently, little to no explanation is provided showing how vcpkg_find_acquire_program is intended to be used. This appears to have introduced a lot of confusion for some tools (e.g., this StackOverflow question, microsoft/vcpkg#2818, and microsoft/vcpkg#50154 all regarding Doxygen). Currently the only example is a link to the FFMPEG port's portfile, which is relatively complicated and does not serve a meaningful example/explanation for new users and isn't applicable for some tools that may require different/special configuration details (e.g., Doxygen, Python3, etc.).

It's probably also worth clarifying how tools available via vcpkg_find_acquire_program are distinct from those that are also available as ports (e.g., Python2/3, 7zip, Yasm, etc.), as the duplicate presence may confuse users and/or make it ambiguous which approach is correct approach for the relevant use-case.

Additionally, there's severely insufficient SEO for vcpkg_find_acquire_program. Currently searching something like vcpkg doxygen or any other vcpkg [tool] in search engines like Google does not result in the article for vcpkg_find_acquire_program appearing, despite being the (most) relevant result for many of them.

Page URL

https://learn.microsoft.com/en-us/vcpkg/maintainers/functions/vcpkg_find_acquire_program

Content source URL

https://github.com/MicrosoftDocs/vcpkg-docs/blob/main/vcpkg/maintainers/functions/vcpkg_find_acquire_program.md

Document Version Independent Id

fc52724f-483d-57f6-384a-b6c4f5dd308f

Platform Id

793c1b7e-9653-3f15-d293-c938c7ab0d0f

Article author

@vicroms

Metadata

• ID: fc52724f-483d-57f6-384a-b6c4f5dd308f
• PlatformId: 793c1b7e-9653-3f15-d293-c938c7ab0d0f
• Service: vcpkg