From 8b06b1752ab673135b8d09d9dd95cf7d6d62f6aa Mon Sep 17 00:00:00 2001
From: Manuel Cillero <manuel@cillero.es>
Date: Thu, 21 Aug 2025 09:12:22 +0200
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20Retoques=20menores=20en=20la=20d?=
 =?UTF-8?q?ocumentaci=C3=B3n?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/core/theme.rs            |  7 ++++---
 src/core/theme/definition.rs | 11 ++++++++---
 src/util.rs                  |  4 +++-
 3 files changed, 15 insertions(+), 7 deletions(-)

diff --git a/src/core/theme.rs b/src/core/theme.rs
index 0a0f819..2cd5bb1 100644
--- a/src/core/theme.rs
+++ b/src/core/theme.rs
@@ -9,9 +9,10 @@
 //! tipografías, espaciados y cualquier otro detalle visual o de comportamiento (como animaciones,
 //! *scripts* de interfaz, etc.).
 //!
-//! Es una extensión más (implementando [`Extension`](crate::core::extension::Extension)). Se
-//! instala, activa y declara dependencias igual que el resto de extensiones; y se señala a sí misma
-//! como tema (implementando [`theme()`](crate::core::extension::Extension::theme) y [`Theme`]).
+//! Los temas son extensiones que implementan [`Extension`](crate::core::extension::Extension); por
+//! lo que se instancian, declaran sus dependencias y se inician igual que el resto de extensiones;
+//! pero serán temas si además implementan [`theme()`](crate::core::extension::Extension::theme) y
+//! [`Theme`].
 
 mod definition;
 pub use definition::{Theme, ThemeRef};
diff --git a/src/core/theme/definition.rs b/src/core/theme/definition.rs
index 8de88bd..e9cfbba 100644
--- a/src/core/theme/definition.rs
+++ b/src/core/theme/definition.rs
@@ -14,7 +14,7 @@ pub type ThemeRef = &'static dyn Theme;
 /// Interfaz común que debe implementar cualquier tema de `PageTop`.
 ///
 /// Un tema implementará [`Theme`] y los métodos que sean necesarios de [`Extension`], aunque el
-/// único obligatorio es [`theme()`](Extension::theme).
+/// único obligatorio será [`theme()`](Extension::theme).
 ///
 /// ```rust
 /// use pagetop::prelude::*;
@@ -22,8 +22,13 @@ pub type ThemeRef = &'static dyn Theme;
 /// pub struct MyTheme;
 ///
 /// impl Extension for MyTheme {
-///     fn name(&self) -> L10n { L10n::n("My theme") }
-///     fn description(&self) -> L10n { L10n::n("Un tema personal") }
+///     fn name(&self) -> L10n {
+///         L10n::n("My theme")
+///     }
+///
+///     fn description(&self) -> L10n {
+///         L10n::n("A personal theme")
+///     }
 ///
 ///     fn theme(&self) -> Option<ThemeRef> {
 ///         Some(&Self)
diff --git a/src/util.rs b/src/util.rs
index 21537c5..e70b099 100644
--- a/src/util.rs
+++ b/src/util.rs
@@ -56,8 +56,10 @@ pub fn resolve_absolute_dir<P: AsRef<Path>>(path: P) -> io::Result<PathBuf> {
     }
 }
 
+/// **Obsoleto desde la versión 0.3.0**: usar [`resolve_absolute_dir()`] en su lugar.
+///
 /// Devuelve la ruta absoluta a un directorio existente.
-#[deprecated(since = "0.3.0", note = "Use [`resolve_absolute_dir`] instead")]
+#[deprecated(since = "0.3.0", note = "Use `resolve_absolute_dir()` instead")]
 pub fn absolute_dir<P, Q>(root_path: P, relative_path: Q) -> io::Result<PathBuf>
 where
     P: AsRef<Path>,