[vcpkg manifest] Add documentation! (#13488)

* [vcpkg docs] add docs for manifest files

These are just for the maintainer docs,
not user docs.

* [vcpkg] EBNF-ify platform expression parsing

this modifies nothing about what strings are accepted or rejected,
it just moves stuff around.

also adds tests.

* [vcpkg docs] add manifest mode example

* [wip] docs for augustin

also fix tabs

* [vcpkg manifest] switch to using maps for features

* Apply suggestions from code review

* un-experimentize format-manifest

* flesh out the user manifest mode docs

* CRs

* billy CRs

* final personal pass-thru

8 files changed, 31 insertions, 46 deletions

diff --git a/ports/abseil/vcpkg.json b/ports/abseil/vcpkg.json
index 79e6c308b..0fbb7abb9 100644
--- a/ports/abseil/vcpkg.json
+++ b/ports/abseil/vcpkg.json
@@ -9,10 +9,9 @@
     "Abseil is not meant to be a competitor to the standard library; we've just found that many of these utilities serve a purpose within our code base, and we now want to provide those resources to the C++ community as a whole."
   ],
   "homepage": "https://github.com/abseil/abseil-cpp",
-  "features": [
-    {
-      "name": "cxx17",
+  "features": {
+    "cxx17": {
       "description": "Enable compiler C++17."
     }
-  ]
+  }
 }
diff --git a/ports/blend2d/vcpkg.json b/ports/blend2d/vcpkg.json
index d61e3f4ce..4e763f595 100644
--- a/ports/blend2d/vcpkg.json
+++ b/ports/blend2d/vcpkg.json
@@ -10,18 +10,15 @@
     "logging",
     "tls"
   ],
-  "features": [
-    {
-      "name": "jit",
+  "features": {
+    "jit": {
       "description": "Default feature. Enables jit pipeline compilation. Not supported for ARM and UWP."
     },
-    {
-      "name": "logging",
+    "logging": {
       "description": "Default feature. Enables logging."
     },
-    {
-      "name": "tls",
+    "tls": {
       "description": "Default feature. Enables use of thread_local feature. Disable for platforms where thread local storage is expensive or not supported."
     }
-  ]
+  }
 }
diff --git a/ports/colmap/vcpkg.json b/ports/colmap/vcpkg.json
index 565e945ba..6feee3ee0 100644
--- a/ports/colmap/vcpkg.json
+++ b/ports/colmap/vcpkg.json
@@ -32,24 +32,21 @@
     "qt5-base",
     "suitesparse"
   ],
-  "features": [
-    {
-      "name": "cuda",
+  "features": {
+    "cuda": {
       "description": "CUDA support for current compute architecture of this machine.",
       "dependencies": [
         "cuda"
       ]
     },
-    {
-      "name": "cuda-redist",
+    "cuda-redist": {
       "description": "Redistributable CUDA support for common supported compute architectures.",
       "dependencies": [
         "cuda"
       ]
     },
-    {
-      "name": "tests",
+    "tests": {
       "description": "Enable TESTS."
     }
-  ]
+  }
 }
diff --git a/ports/cpu-features/vcpkg.json b/ports/cpu-features/vcpkg.json
index f773cf60b..20974bc65 100644
--- a/ports/cpu-features/vcpkg.json
+++ b/ports/cpu-features/vcpkg.json
@@ -5,10 +5,9 @@
   "homepage": "https://github.com/google/cpu_features",
   "license": "Apache-2.0",
   "supports": "!(arm | uwp)",
-  "features": [
-    {
-      "name": "tools",
+  "features": {
+    "tools": {
       "description": "list_cpu_features command line tool"
     }
-  ]
+  }
 }
diff --git a/ports/geographiclib/vcpkg.json b/ports/geographiclib/vcpkg.json
index 8ec469c90..bccf0054f 100644
--- a/ports/geographiclib/vcpkg.json
+++ b/ports/geographiclib/vcpkg.json
@@ -3,10 +3,9 @@
   "version-string": "1.50.1",
   "description": "GeographicLib, a C++ library for performing geographic conversions",
   "homepage": "https://geographiclib.sourceforge.io",
-  "features": [
-    {
-      "name": "tools",
+  "features": {
+    "tools": {
       "description": "The GeographicLib tools"
     }
-  ]
+  }
 }
diff --git a/ports/libsndfile/vcpkg.json b/ports/libsndfile/vcpkg.json
index b9dcdb147..e40936088 100644
--- a/ports/libsndfile/vcpkg.json
+++ b/ports/libsndfile/vcpkg.json
@@ -8,9 +8,8 @@
   "default-features": [
     "external-libs"
   ],
-  "features": [
-    {
-      "name": "external-libs",
+  "features": {
+    "external-libs": {
       "description": "Default feature. Enables Ogg Vorbis, FLAC and Ogg Opus formats support.",
       "dependencies": [
         "libflac",
@@ -18,5 +17,5 @@
         "opus"
       ]
     }
-  ]
+  }
 }
diff --git a/ports/numcpp/vcpkg.json b/ports/numcpp/vcpkg.json
index db31f6a3b..dab0d3abc 100644
--- a/ports/numcpp/vcpkg.json
+++ b/ports/numcpp/vcpkg.json
@@ -13,14 +13,13 @@
     "boost-random",
     "boost-type-traits"
   ],
-  "features": [
-    {
-      "name": "python",
+  "features": {
+    "python": {
       "description": "Interacting with python with pybind11 interface",
       "dependencies": [
         "boost-python",
         "pybind11"
       ]
     }
-  ]
+  }
 }
diff --git a/ports/ogre/vcpkg.json b/ports/ogre/vcpkg.json
index 133fb3cfb..d99c2e234 100644
--- a/ports/ogre/vcpkg.json
+++ b/ports/ogre/vcpkg.json
@@ -17,25 +17,21 @@
     "zlib",
     "zziplib"
   ],
-  "features": [
-    {
-      "name": "csharp",
+  "features": {
+    "csharp": {
       "description": "Build csharp bindings"
     },
-    {
-      "name": "d3d9",
+    "d3d9": {
       "description": "Build Direct3D9 RenderSystem"
     },
-    {
-      "name": "java",
+    "java": {
       "description": "Build Java (JNI) bindings"
     },
-    {
-      "name": "python",
+    "python": {
       "description": "Build Python bindings",
       "dependencies": [
         "python3"
       ]
     }
-  ]
+  }
 }