mirror of
https://github.com/rust-lang/rust-analyzer.git
synced 2025-10-01 11:31:15 +00:00
Add the comment why HasSource::source()
returns Option
This commit is contained in:
parent
b092b45484
commit
7b418d3a8c
@ -21,6 +21,10 @@ pub trait HasSource {
|
|||||||
/// Fetches the definition's source node.
|
/// Fetches the definition's source node.
|
||||||
/// Using [`crate::Semantics::source`] is preferred when working with [`crate::Semantics`],
|
/// Using [`crate::Semantics::source`] is preferred when working with [`crate::Semantics`],
|
||||||
/// as that caches the parsed file in the semantics' cache.
|
/// as that caches the parsed file in the semantics' cache.
|
||||||
|
///
|
||||||
|
/// The current some implementations can return `InFile` instead of `Option<InFile>`.
|
||||||
|
/// But we made this method `Option` to support rlib in the future
|
||||||
|
/// by https://github.com/rust-lang/rust-analyzer/issues/6913
|
||||||
fn source(self, db: &dyn HirDatabase) -> Option<InFile<Self::Ast>>;
|
fn source(self, db: &dyn HirDatabase) -> Option<InFile<Self::Ast>>;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user