Add note to docs about cfg(rofi_next)

README.md

@@ -73,6 +73,10 @@ You can then run your mode from Rofi's command line:
 rofi -modi an-example-mode -show an-example-mode
 ```
 
+Build with `RUSTFLAGS="--cfg rofi_next"` to support unreleased Rofi versions,
+and drop support for released Rofi versions.
+This will turn on semver-exempt features, so use with caution.
+
 ## Examples
 
 - See [examples/basic] for a basic example of a non-trivial Rofi mode,

examples/basic/run.sh

@@ -1,12 +1,14 @@
 #!/bin/sh
 set -eu
 
+ROFI_PREFIX="${ROFI_PREFIX:-}"
+
 cd "$(dirname "$0")"
 cargo build
 cd ../..
 
 # DEBUGGER can be e.g. "gdb --args"
-ROFI_PLUGIN_PATH=target/debug ${DEBUGGER:-} rofi \
+ROFI_PLUGIN_PATH=target/debug ${DEBUGGER:-} "$ROFI_PREFIX"/bin/rofi \
 	-modi run,plugin-example-basic \
 	-show plugin-example-basic \
 	"$@"

examples/file-browser/run.sh

@@ -1,12 +1,14 @@
 #!/bin/sh
 set -eu
 
+ROFI_PREFIX="${ROFI_PREFIX:-}"
+
 cd "$(dirname "$0")"
 cargo build
 cd ../..
 
 # DEBUGGER can be e.g. "gdb --args"
-ROFI_PLUGIN_PATH=target/debug ${DEBUGGER:-} rofi \
+ROFI_PLUGIN_PATH=target/debug ${DEBUGGER:-} "$ROFI_PREFIX"/bin/rofi \
 	-modi plugin-example-file-browser \
 	-show plugin-example-file-browser \
 	"$@"

src/lib.rs

@@ -71,6 +71,10 @@
 //! rofi -modi an-example-mode -show an-example-mode
 //! ```
 //!
+//! Build with `RUSTFLAGS="--cfg rofi_next"` to support unreleased Rofi versions,
+//! and drop support for released Rofi versions.
+//! This will turn on semver-exempt features, so use with caution.
+//!
 //! # Examples
 //!
 //! - See [examples/basic] for a basic example of a non-trivial Rofi mode,