Warn that Added/Changed filters do not see deferred changes (#10681)

Explain https://github.com/bevyengine/bevy/issues/10625.

This might be obvious to those familiar with Bevy internals, but it
surprised me.

---------

Co-authored-by: Alice Cecile <alice.i.cecile@gmail.com>
This commit is contained in:
Stepan Koltsov 2023-11-23 14:04:07 +00:00 committed by GitHub
parent 960f6e9131
commit 48af029f7b
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -551,6 +551,12 @@ impl_tick_filter!(
/// To retain all results without filtering but still check whether they were added after the /// To retain all results without filtering but still check whether they were added after the
/// system last ran, use [`Ref<T>`](crate::change_detection::Ref). /// system last ran, use [`Ref<T>`](crate::change_detection::Ref).
/// ///
/// # Deferred
///
/// Note, that entity modifications issued with [`Commands`](crate::system::Commands)
/// are visible only after deferred operations are applied,
/// typically at the end of the schedule iteration.
///
/// # Examples /// # Examples
/// ///
/// ``` /// ```
@ -587,6 +593,13 @@ impl_tick_filter!(
/// To retain all results without filtering but still check whether they were changed after the /// To retain all results without filtering but still check whether they were changed after the
/// system last ran, use [`Ref<T>`](crate::change_detection::Ref). /// system last ran, use [`Ref<T>`](crate::change_detection::Ref).
/// ///
/// # Deferred
///
/// Note, that entity modifications issued with [`Commands`](crate::system::Commands)
/// (like entity creation or entity component addition or removal)
/// are visible only after deferred operations are applied,
/// typically at the end of the schedule iteration.
///
/// # Examples /// # Examples
/// ///
/// ``` /// ```