From 81e6a1b45e6c44eee6b69aca1a1452d8bf3a0374 Mon Sep 17 00:00:00 2001
From: Ian Jackson <ijackson@chiark.greenend.org.uk>
Date: Sat, 30 Mar 2024 11:46:13 +0000
Subject: [PATCH] docs: cargo install cargo expand: Recommend --version

Fixes #90.
---
 src/lib.rs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/src/lib.rs b/src/lib.rs
index 361aa21..36cbd35 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -74,6 +74,13 @@
 //! cargo install --locked cargo-expand
 //! ```
 //!
+//! (In CI, you'll want to pin to a particular version,
+//! since
+//! [cargo expand's output is not stable across versions](https://github.com/dtolnay/cargo-expand/issues/179).
+//! Look up the
+//! [current version](https://crates.io/crates/cargo-expand)
+//! and do something like `cargo install --locked --version 1.0.81 cargo-expand`.)
+//!
 //! ## Setting up a test project
 //!
 //! In your crate that provides procedural or declarative macros, under the `tests` directory,