Merge 9e12b2c9f11bb2b6c4bb6fc00563a9e3d3c43dc3 into 7897e86bccc1e6f510b28bc40ea1700029f41b5d

crates/typst-library/src/foundations/selector.rs

@@ -37,12 +37,13 @@ pub use crate::__select_where as select_where;
 
 /// A filter for selecting elements within the document.
 ///
-/// To construct a selector you can:
+/// You can construct a selector in the following ways:
-/// - use an element [function]
+/// - you can use an element [function]
-/// - filter for an element function with [specific fields]($function.where)
+/// - you can filter for an element function with
-/// - use a [string]($str) or [regular expression]($regex)
+///   [specific fields]($function.where)
-/// - use a [`{<label>}`]($label)
+/// - you can use a [string]($str) or [regular expression]($regex)
-/// - use a [`location`]
+/// - you can use a [`{<label>}`]($label)
+/// - you can use a [`location`]
 /// - call the [`selector`] constructor to convert any of the above types into a
 ///   selector value and use the methods below to refine it
 ///
@@ -147,9 +148,7 @@ impl Selector {
 impl Selector {
     /// Turns a value into a selector. The following values are accepted:
     /// - An element function like a `heading` or `figure`.
-    /// - A [string]($str) or [regular expression]($regex).
     /// - A `{<label>}`.
-    /// - A [`location`].
     /// - A more complex selector like `{heading.where(level: 1)}`.
     #[func(constructor)]
     pub fn construct(