No longer advertise (most) deprecated symbols in API.

Some exceptions like StringName::from_latin1_with_nul() or String::chars_checked(),
since those have deprecation conditional on Godot API level.

Author: Bromeon

godot-codegen/src/generator/enums.rs

@@ -354,6 +354,7 @@ pub(crate) fn make_deprecated_enumerators(enum_: &Enum) -> TokenStream {
 
         let decl = quote! {
             #[deprecated = #msg]
+            #[doc(hidden)] // No longer advertise in API docs.
             pub const #pascal_name: #enum_name = Self::#name;
         };
 

godot-core/src/builtin/collections/array.rs

@@ -190,6 +190,7 @@ impl<T: ArrayElement> Array<T> {
     }
 
     #[deprecated = "Renamed to `get`."]
+    #[doc(hidden)] // No longer advertise in API docs.
     pub fn try_get(&self, index: usize) -> Option<T> {
         self.get(index)
     }
@@ -251,11 +252,13 @@ impl<T: ArrayElement> Array<T> {
     }
 
     #[deprecated = "Renamed to `front`, in line with GDScript method and consistent with `push_front` and `pop_front`."]
+    #[doc(hidden)] // No longer advertise in API docs.
     pub fn first(&self) -> Option<T> {
         self.front()
     }
 
     #[deprecated = "Renamed to `back`, in line with GDScript method."]
+    #[doc(hidden)] // No longer advertise in API docs.
     pub fn last(&self) -> Option<T> {
         self.back()
     }

godot-core/src/builtin/collections/packed_array.rs

@@ -133,6 +133,7 @@ macro_rules! impl_packed_array {
             ///
             /// If `index` is out of bounds.
             #[deprecated = "Use [] operator (IndexMut) instead."]
+            #[doc(hidden)] // No longer advertise in API docs.
             pub fn set(&mut self, index: usize, value: $Element) {
                 let ptr_mut = self.ptr_mut(index);
 
@@ -312,6 +313,7 @@ macro_rules! impl_packed_array {
             }
 
             #[deprecated = "Renamed to bsearch like in Godot, to avoid confusion with Rust's slice::binary_search."]
+            #[doc(hidden)] // No longer advertise in API docs.
             pub fn binary_search(&self, value: $Element) -> usize {
                 self.bsearch(&value)
             }

godot-core/src/builtin/color.rs

@@ -376,6 +376,7 @@ pub enum ColorChannelOrder {
 }
 
 #[allow(non_upper_case_globals)]
+#[doc(hidden)] // No longer advertise in API docs.
 impl ColorChannelOrder {
     #[deprecated(note = "Renamed to `ColorChannelOrder::RGBA`.")]
     pub const Rgba: Self = Self::RGBA;

godot-core/src/builtin/mod.rs

@@ -138,12 +138,14 @@ pub(crate) fn to_isize(i: usize) -> isize {
 
 /// Specialized types related to arrays.
 #[deprecated = "Merged into `godot::builtin::iter`."]
+#[doc(hidden)] // No longer advertise in API docs.
 pub mod array {
     pub type Iter<'a, T> = super::iter::ArrayIter<'a, T>;
 }
 
 /// Specialized types related to dictionaries.
 #[deprecated = "Merged into `godot::builtin::iter`."]
+#[doc(hidden)] // No longer advertise in API docs.
 pub mod dictionary {
     pub type Iter<'a> = super::iter::DictIter<'a>;
     pub type Keys<'a> = super::iter::DictKeys<'a>;
@@ -152,6 +154,7 @@ pub mod dictionary {
 }
 
 #[deprecated = "Moved to `godot::meta` and submodules."]
+#[doc(hidden)] // No longer advertise in API docs.
 pub mod meta {
     pub use crate::meta::error::*;
     pub use crate::meta::*;
@@ -161,9 +164,11 @@ pub mod meta {
 ///
 /// _Godot equivalent: `@GlobalScope.Side`_
 #[deprecated = "Merged with `godot::builtin::Side`."]
+#[doc(hidden)] // No longer advertise in API docs.
 pub type RectSide = Side;
 
 #[allow(non_upper_case_globals)]
+#[doc(hidden)] // No longer advertise in API docs.
 impl Side {
     #[deprecated(note = "Renamed to `Side::LEFT`.")]
     pub const Left: Side = Side::LEFT;

godot-core/src/builtin/projection.rs

@@ -552,6 +552,7 @@ pub enum ProjectionPlane {
 }
 
 #[allow(non_upper_case_globals)]
+#[doc(hidden)] // No longer advertise in API docs.
 impl ProjectionPlane {
     #[deprecated(note = "Renamed to `ProjectionPlane::NEAR`")]
     pub const Near: Self = Self::NEAR;

godot-core/src/deprecated.rs

@@ -33,6 +33,7 @@ pub use crate::emit_deprecated_warning;
 // Old names for VariantOperator constants
 
 #[allow(non_upper_case_globals)]
+#[doc(hidden)] // No longer advertise in API docs.
 impl crate::builtin::VariantOperator {
     #[deprecated = "Renamed to `EQUAL`"]
     pub const Equal: Self = Self::EQUAL;

godot-core/src/lib.rs

@@ -60,9 +60,11 @@ pub use godot_ffi::out;
 // Deprecated modules
 
 #[deprecated = "Module has been split into `godot::classes`, `godot::global` and `godot::tools`."]
+#[doc(hidden)] // No longer advertise in API docs.
 pub mod engine;
 
 #[deprecated = "Print macros have been moved to `godot::global`."]
+#[doc(hidden)] // No longer advertise in API docs.
 pub mod log {
     pub use crate::global::{
         godot_error, godot_print, godot_print_rich, godot_script_error, godot_warn,

godot-core/src/obj/gd.rs

@@ -812,4 +812,5 @@ impl<T: GodotClass> std::panic::UnwindSafe for Gd<T> {}
 impl<T: GodotClass> std::panic::RefUnwindSafe for Gd<T> {}
 
 #[deprecated = "Removed; see `Gd::try_to_unique()`"]
+#[doc(hidden)] // No longer advertise in API docs.
 pub type NotUniqueError = ();