v0.39.0

Co-authored-by: Boxy <[email protected]>

Author: aDotInTheVoid

Diff for: CHANGELOG.md

@@ -1,3 +1,21 @@
+<a name="v0.39.0"></a>
+# [v0.39.0](https://github.com/rust-lang/rustdoc-types/releases/tag/v0.39.0) - 2025-03-24
+
+**Breaking Change**: Change format of `Item::attrs` for `#[repr(..)]` from HIR
+debug printing to how they're written in source-code. For example 
+`#[attr = Repr([ReprC, ReprInt(SignedInt(I8))])])` would now be represented as 
+`#[repr(C,i8)]` ((rust#138018)[https://github.com/rust-lang/rust/pull/138018]). 
+
+This somewhat undoes (v0.36.0)[#v0.36.0].
+
+No changes were made to the schema (i.e. the public api for this crate is
+unchanged), but the format version has been bumped, as this may effect consuming
+tools regardless.
+
+- Format Version: 43
+- Upstream Commit: [`bafdbcadd5e70e4a1a35647002c30efd315621b4`](https://github.com/rust-lang/rust/commit/bafdbcadd5e70e4a1a35647002c30efd315621b4)
+- Diff: [v0.38.0...v0.39.0](https://github.com/rust-lang/rustdoc-types/compare/v0.38.0...v0.39.0)
+
 <a name="v0.38.0"></a>
 # [v0.38.0](https://github.com/rust-lang/rustdoc-types/releases/tag/v0.38.0) - 2025-03-16
 

Diff for: COMMIT.txt

@@ -1 +1 @@
-e3ac1fa81abd321abe193f491ed06c7d388f68fe
+bafdbcadd5e70e4a1a35647002c30efd315621b4

Diff for: Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "rustdoc-types"
-version = "0.38.0"
+version = "0.39.0"
 edition = "2018"
 license = "MIT OR Apache-2.0"
 description = "Types for rustdoc's json output"

Diff for: src/lib.rs

@@ -29,7 +29,7 @@ use serde::{Deserialize, Serialize};
 /// This integer is incremented with every breaking change to the API,
 /// and is returned along with the JSON blob as [`Crate::format_version`].
 /// Consuming code should assert that this value matches the format version(s) that it supports.
-pub const FORMAT_VERSION: u32 = 42;
+pub const FORMAT_VERSION: u32 = 43;
 
 /// The root of the emitted JSON blob.
 ///
@@ -119,9 +119,23 @@ pub struct Item {
     pub docs: Option<String>,
     /// This mapping resolves [intra-doc links](https://github.com/rust-lang/rfcs/blob/master/text/1946-intra-rustdoc-links.md) from the docstring to their IDs
     pub links: HashMap<String, Id>,
-    /// Stringified versions of parsed attributes on this item.
-    /// Essentially debug printed (e.g. `#[inline]` becomes something similar to `#[attr="Inline(Hint)"]`).
-    /// Equivalent to the hir pretty-printing of attributes.
+    /// Attributes on this item.
+    ///
+    /// Does not include `#[deprecated]` attributes: see the [`Self::deprecation`] field instead.
+    ///
+    /// Some attributes appear in pretty-printed Rust form, regardless of their formatting
+    /// in the original source code. For example:
+    /// - `#[non_exhaustive]` and `#[must_use]` are represented as themselves.
+    /// - `#[no_mangle]` and `#[export_name]` are also represented as themselves.
+    /// - `#[repr(C)]` and other reprs also appear as themselves,
+    ///   though potentially with a different order: e.g. `repr(i8, C)` may become `repr(C, i8)`.
+    ///   Multiple repr attributes on the same item may be combined into an equivalent single attr.
+    ///
+    /// Other attributes may appear debug-printed. For example:
+    /// - `#[inline]` becomes something similar to `#[attr="Inline(Hint)"]`.
+    ///
+    /// As an internal implementation detail subject to change, this debug-printing format
+    /// is currently equivalent to the HIR pretty-printing of parsed attributes.
     pub attrs: Vec<String>,
     /// Information about the item’s deprecation, if present.
     pub deprecation: Option<Deprecation>,