Deprecate the raw entry API in favor of HashTable

It is now moved under the "raw-entry" Cargo feature.

For now the raw-entry feature is kept enabled by default because
`HashSet` uses it internally, but this will be disabled by default once
this is no longer the case.

Cargo.toml

@@ -48,7 +48,7 @@ bumpalo = { version = "3.13.0", features = ["allocator-api2"] }
 rkyv = { version = "0.7.42", features = ["validation"] }
 
 [features]
-default = ["default-hasher", "inline-more", "allocator-api2", "equivalent"]
+default = ["default-hasher", "inline-more", "allocator-api2", "equivalent", "raw-entry"]
 
 # Enables use of nightly features. This is only guaranteed to work on the latest
 # version of nightly Rust.
@@ -64,11 +64,15 @@ rustc-dep-of-std = [
  "compiler_builtins",
  "alloc",
  "rustc-internal-api",
+ "raw-entry",
 ]
 
-# Enables the RawTable API.
+# Enables the experimental and unsafe RawTable API.
 raw = []
 
+# Enables the deprecated RawEntry API.
+raw-entry = []
+
 # Provides a default hasher. Currently this is AHash but this is subject to
 # change in the future. Note that the default hasher does *not* provide HashDoS
 # resistance, unlike the one in the standard library.

README.md

@@ -106,6 +106,7 @@ This crate has the following Cargo features:
 - `rayon`: Enables rayon parallel iterator support.
 - `equivalent`: Allows comparisons to be customized with the `Equivalent` trait.
 - `raw`: Enables access to the experimental and unsafe `RawTable` API.
+- `raw-entry`: Enables access to the deprecated `RawEntry` API.
 - `inline-more`: Adds inline hints to most functions, improving run-time performance at the cost
  of compilation time. (enabled by default)
 - `default-hasher`: Compiles with ahash as default hasher. (enabled by default)

src/lib.rs

@@ -86,6 +86,8 @@ mod raw;
 
 mod external_trait_impls;
 mod map;
+#[cfg(feature = "raw-entry")]
+mod raw_entry;
 #[cfg(feature = "rustc-internal-api")]
 mod rustc_entry;
 mod scopeguard;