move generate tool, docs

Cargo.toml

@@ -1,8 +1,9 @@
 [workspace]
 members = [
     "spirv-tools-sys",
+    "tools/generate",
     "tools/package",
-    "tools/install"
+    "tools/install",
 ]
 
 [package]

tools/generate/Cargo.toml

@@ -0,0 +1,11 @@
+[package]
+name = "generate"
+version = "0.1.0"
+edition = "2021"
+publish = false
+
+[[bin]]
+name = "generate"
+path = "main.rs"
+test = false
+bench = false

spirv-tools-sys/generate.rs → tools/generate/main.rs

@@ -3,6 +3,7 @@
 // to in a simple script and commit them to source control, as they only need
 // to be regenerated when spirv-headers is updated
 
+use std::path::PathBuf;
 use std::{fs, process::Command};
 
 fn python<S: AsRef<std::ffi::OsStr>>(args: impl IntoIterator<Item = S>) -> Result<(), i32> {
@@ -20,7 +21,9 @@ fn python<S: AsRef<std::ffi::OsStr>>(args: impl IntoIterator<Item = S>) -> Resul
 }
 
 fn main() {
-    fs::create_dir_all("generated").expect("unable to create 'generated'");
+    let sys_root = PathBuf::from_iter([env!("CARGO_MANIFEST_DIR"), "..", "..", "spirv-tools-sys"]);
+    fs::create_dir_all(&sys_root.join("generated")).expect("unable to create 'generated'");
+    std::env::set_current_dir(&sys_root).unwrap();
 
     python(&[
         "spirv-tools/utils/update_build_version.py",

tools/generate/vulkan-sdk-update.md

@@ -0,0 +1,6 @@
+# Vulkan sdk update
+
+1. in `.gitmodules` set branch for both submodules to the new vulkan sdk version's branch
+2. update submodules: `git submodule update --remote`
+3. regenerate generated header files, requires python: `cargo run generate`
+4. try to compile and run the tests, fixup any errors: `cargo test --all-features`