[ENV] Added a new BOX64_ARCH option (#3076)

2 files changed, 30 insertions, 2 deletions

diff --git a/docs/gen/gen.py b/docs/gen/gen.py
index e17b67fc..6dd77d84 100644
--- a/docs/gen/gen.py
+++ b/docs/gen/gen.py
@@ -63,8 +63,8 @@ This configuration will apply the specified settings application-wide to any exe
     for entry in data:
       categories[entry["category"]].append(entry)
 
-    # Put "Performance" at the top
-    sorted_categories = sorted(categories.items(), key=lambda x: x[0] != "Performance")
+    # Put "Performance" at the top, then sort the rest alphabetically
+    sorted_categories = sorted(categories.items(), key=lambda x: (x[0] != "Performance", x[0]))
     for category, entries in sorted_categories:
       md_file.write(f"## {category}\n\n")
       for entry in entries:
diff --git a/docs/gen/usage.json b/docs/gen/usage.json
index 53cc74b5..f96bb1c5 100644
--- a/docs/gen/usage.json
+++ b/docs/gen/usage.json
@@ -36,6 +36,34 @@
     ]
   },
   {
+    "name": "BOX64_ARCH",
+    "description": "Specify the architecture in rcfiles to which the current entry applies. This option only takes effect when used inside rcfiles.",
+    "category": "Compatibility",
+    "wine": false,
+    "options": [
+      {
+        "key": "`arm64`",
+        "description": "Only apply current entry for AArch64.",
+        "default": false
+      },
+      {
+        "key": "`la64`",
+        "description": "Only apply current entry for LoongArch64.",
+        "default": false
+      },
+      {
+        "key": "`rv64`",
+        "description": "Only apply current entry for RISC-V.",
+        "default": false
+      },
+      {
+        "key": "`<empty>`",
+        "description": "Apply current entry for all architectures, will be replaced by more specific entries.",
+        "default": true
+      }
+    ]
+  },
+  {
     "name": "BOX64_ARGS",
     "description": "Arguments to pass to the guest program, only valid if there is no existing arguments.",
     "category": "Arguments",