From 8a5f52eaff1de3ee678400a8be0781f295fc00c4 Mon Sep 17 00:00:00 2001 From: Emmanuele Bassi Date: Wed, 8 Feb 2017 15:53:43 +0000 Subject: [PATCH] Document the process for updating the registry This avoids each maintainer to transmit the knowledge orally to the next maintainer. --- registry/README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 registry/README.md diff --git a/registry/README.md b/registry/README.md new file mode 100644 index 0000000..a35d9d9 --- /dev/null +++ b/registry/README.md @@ -0,0 +1,13 @@ +## Updating the registry XML + +In order to update the registry XML files and retain the history you cannot +simply download the files the [Khronos website](https://khronos.org/registry/OpenGL/index_gl.php) +and copy them into this directory. You should follow these steps, instead: + + 1. check out the `khronos-registry` branch + 2. download the XML files from the Khronos repository + 3. copy them under the `registry` directory + 4. check the result for consistency and commit it + 5. check out the `master` branch and merge the `khronos-registry` branch + into it with the appropriate commit message +