[vcpkg] Add comments

toolsrc/include/BinaryParagraph.h

@@ -6,6 +6,9 @@
 
 namespace vcpkg
 {
+    /// <summary>
+    /// Built package metadata
+    /// </summary>
     struct BinaryParagraph
     {
         BinaryParagraph();

toolsrc/include/SourceParagraph.h

@@ -15,6 +15,9 @@ namespace vcpkg
 
     const std::string& to_string(const Dependency& dep);
 
+    /// <summary>
+    /// Port metadata (CONTROL file)
+    /// </summary>
     struct SourceParagraph
     {
         SourceParagraph();

toolsrc/include/StatusParagraph.h

@@ -23,6 +23,9 @@ namespace vcpkg
         PURGE
     };
 
+    /// <summary>
+    /// Installed package metadata
+    /// </summary>
     struct StatusParagraph
     {
         StatusParagraph();

toolsrc/include/vcpkg_Build.h

@@ -33,8 +33,14 @@ namespace vcpkg::Build
     std::string create_error_message(const BuildResult build_result, const PackageSpec& spec);
     std::string create_user_troubleshooting_message(const PackageSpec& spec);
 
+    /// <summary>
+    /// Settings from the triplet file which impact the build environment and post-build checks
+    /// </summary>
     struct PreBuildInfo
     {
+        /// <summary>
+        /// Runs the triplet file in a "capture" mode to create a PreBuildInfo
+        /// </summary>
         static PreBuildInfo from_triplet_file(const VcpkgPaths& paths, const Triplet& triplet);
 
         std::string target_architecture;