mirror of
https://github.com/rust-lang/rust-analyzer.git
synced 2025-09-28 12:54:58 +00:00
Add the comment why HasSource::source()
returns Option
This commit is contained in:
parent
b092b45484
commit
7b418d3a8c
1 changed files with 4 additions and 0 deletions
|
@ -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…
Add table
Add a link
Reference in a new issue