From b5d72caaf94a5079cf67ce5c4764992d5e9ed01a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=96=B9=E8=80=8C=E9=9D=99?= <szdytom@163.com>
Date: Sun, 30 Apr 2023 02:29:48 +0800
Subject: [PATCH] Update query's documentation (#1026)

---
 library/src/meta/query.rs | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/library/src/meta/query.rs b/library/src/meta/query.rs
index f256af235..9488a964e 100644
--- a/library/src/meta/query.rs
+++ b/library/src/meta/query.rs
@@ -89,6 +89,13 @@ use crate::prelude::*;
 /// })
 /// ```
 ///
+/// ## Migration Hints
+/// The `before` and `after` arguments have been removed in version 0.3.0. You
+/// can now use flexible selector combinator methods instead. For example,
+/// `query(heading, before: loc)` becomes `query(heading.before(loc), loc)`.
+/// Please refer to the [selector documentation]($type/selector) for more
+/// details.
+///
 /// Display: Query
 /// Category: meta
 /// Returns: content
@@ -112,8 +119,6 @@ pub fn query(
     /// the query's result is reduced. If you could call it directly at the top
     /// level of a module, the evaluation of the whole module and its exports
     /// could depend on the query's result.
-    ///
-    /// Only one of this, `before`, and `after` shall be given.
     location: Location,
 ) -> Value {
     let _ = location;