[tools/update-ui-test-files.sh] Initial commit (#1171)

Update documentation to mention this new script.

Closes #1170

INTERNAL.md

@@ -29,7 +29,7 @@ Updating the versions pinned in CI may cause the UI tests to break. In order to
 fix UI tests after a version update, run:
 
 ```
-$ TRYBUILD=overwrite ./cargo.sh +all test
+$ ./tools/update-ui-test-files.sh
 ```
 
 ## Crate versions

tools/cargo-zerocopy/src/main.rs

@@ -18,11 +18,6 @@
 // once for each "major" toolchain (msrv, stable, nightly). This does not
 // include any toolchain which is listed in the `package.metadata.build-rs`
 // Cargo.toml section.
-//
-// A common task that is especially annoying to perform by hand is to update
-// trybuild's stderr files. Using this script:
-//
-//   TRYBUILD=overwrite ./cargo-zerocopy +all test --workspace
 
 use std::{
     env, fmt,

tools/update-ui-test-files.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+#
+# Copyright 2024 The Fuchsia Authors
+#
+# Licensed under a BSD-style license <LICENSE-BSD>, Apache License, Version 2.0
+# <LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0>, or the MIT
+# license <LICENSE-MIT or https://opensource.org/licenses/MIT>, at your option.
+# This file may not be copied, modified, or distributed except according to
+# those terms.
+
+# Update the `.stderr` reference files used to validate our UI tests.
+
+set -e
+
+TRYBUILD=overwrite ./cargo.sh +nightly test ui --test trybuild --workspace --all-features
+TRYBUILD=overwrite ./cargo.sh +stable test ui --test trybuild --workspace --features=__internal_use_only_features_that_work_on_stable
+TRYBUILD=overwrite ./cargo.sh +msrv test ui --test trybuild --workspace --features=__internal_use_only_features_that_work_on_stable