Merge updates from master

eclass/cargo.eclass

@@ -1,4 +1,4 @@
-# Copyright 1999-2025 Gentoo Authors
+# Copyright 1999-2026 Gentoo Authors
 # Distributed under the terms of the GNU General Public License v2
 
 # @ECLASS: cargo.eclass
@@ -257,6 +257,7 @@ _cargo_check_initialized() {
 
 # @FUNCTION: _cargo_set_crate_uris
 # @USAGE: <crates>
+# @INTERNAL
 # @DESCRIPTION:
 # Generates the URIs to put in SRC_URI to help fetch dependencies.
 # Constructs a list of crates from its arguments.

eclass/ecm.eclass

@@ -1,4 +1,4 @@
-# Copyright 1999-2025 Gentoo Authors
+# Copyright 1999-2026 Gentoo Authors
 # Distributed under the terms of the GNU General Public License v2
 
 # @ECLASS: ecm.eclass
@@ -335,6 +335,7 @@ RDEPEND+=" ${COMMONDEPEND}"
 unset COMMONDEPEND
 
 # @FUNCTION: _ecm_handbook_optional
+# @INTERNAL
 # @DESCRIPTION:
 # Use with ECM_HANDBOOK=optional; ticks either -DBUILD_DOC if available,
 # or -DCMAKE_DISABLE_FIND_PACKAGE_KF${_KFSLOT}DocTools

eclass/font.eclass

@@ -1,4 +1,4 @@
-# Copyright 1999-2023 Gentoo Authors
+# Copyright 1999-2026 Gentoo Authors
 # Distributed under the terms of the GNU General Public License v2
 
 # @ECLASS: font.eclass
@@ -216,6 +216,7 @@ font_src_install() {
 }
 
 # @FUNCTION: _update_fontcache
+# @INTERNAL
 # @DESCRIPTION:
 # Updates fontcache if !prefix and media-libs/fontconfig installed
 _update_fontcache() {

eclass/go-module.eclass

@@ -1,4 +1,4 @@
-# Copyright 2019-2025 Gentoo Authors
+# Copyright 2019-2026 Gentoo Authors
 # Distributed under the terms of the GNU General Public License v2
 
 # @ECLASS: go-module.eclass
@@ -389,6 +389,7 @@ go-module_src_unpack() {
 }
 
 # @FUNCTION: _go-module_src_unpack_gosum
+# @INTERNAL
 # @DEPRECATED: none
 # @DESCRIPTION:
 # Populate a GOPROXY directory hierarchy with distfiles from EGO_SUM and
@@ -435,6 +436,7 @@ _go-module_src_unpack_gosum() {
 }
 
 # @FUNCTION: _go-module_gosum_synthesize_files
+# @INTERNAL
 # @DEPRECATED: none
 # @DESCRIPTION:
 # Given a path &  version, populate all Goproxy metadata files which aren't
@@ -463,6 +465,7 @@ _go-module_gosum_synthesize_files() {
 }
 
 # @FUNCTION: _go-module_src_unpack_verify_gosum
+# @INTERNAL
 # @DEPRECATED: none
 # @DESCRIPTION:
 # Validate the Go modules declared by EGO_SUM are sufficient to cover building

eclass/ninja-utils.eclass

@@ -1,4 +1,4 @@
-# Copyright 1999-2025 Gentoo Authors
+# Copyright 1999-2026 Gentoo Authors
 # Distributed under the terms of the GNU General Public License v2
 
 # @ECLASS: ninja-utils.eclass
@@ -73,6 +73,7 @@ case ${NINJA} in
 esac
 
 # @FUNCTION: _ninja_uses_jobserver
+# @INTERNAL
 # @DESCRIPTION:
 # Return true if current ${NINJA} has jobserver support and we have one
 # running (via MAKEFLAGS).

eclass/pypi.eclass

@@ -119,6 +119,7 @@ pypi_normalize_name() {
 
 # @FUNCTION: _pypi_translate_version
 # @USAGE: <version>
+# @INTERNAL
 # @DESCRIPTION:
 # Internal version translation function, returns the result
 # via _PYPI_TRANSLATED_VERSION variable.

eclass/rocm.eclass

@@ -1,4 +1,4 @@
-# Copyright 2022-2025 Gentoo Authors
+# Copyright 2022-2026 Gentoo Authors
 # Distributed under the terms of the GNU General Public License v2
 
 # @ECLASS: rocm.eclass
@@ -142,6 +142,7 @@ inherit flag-o-matic
 # @CODE
 
 # @FUNCTION: _rocm_set_globals
+# @INTERNAL
 # @DESCRIPTION:
 # Set global variables useful to ebuilds: IUSE, ROCM_REQUIRED_USE, and
 # ROCM_USEDEP, unless ROCM_SKIP_GLOBALS is set.

eclass/rust.eclass

@@ -331,6 +331,7 @@ unset -f _rust_set_globals
 
 # @FUNCTION: _get_rust_slot
 # @USAGE: [-b|-d]
+# @INTERNAL
 # @DESCRIPTION:
 # Find the newest Rust install that is acceptable for the package,
 # and export its version (i.e. SLOT) and type (source or bin[ary])