Final tweaks

docs/src/general/changelog.md

@@ -20,8 +20,8 @@ description: |
   - Fixed alignment of [`line`]($func/line) elements
 
 - Math
-  - **Breaking change:** Improved parsing of function-like markup in
-    [attachments]($func/math.attach): `[$f^abs(3)$]` now parses as
+  - **Breaking change:** The syntax rules for mathematical
+    [attachments]($func/math.attach) were improved: `[$f^abs(3)$]` now parses as
     `[$f^(abs(3))$]` instead of `[$(f^abs)(3)$]`. To disambiguate, add a space:
     `[$f^zeta (3)$]`.
   - Added [forced size]($category/math/sizes) commands for math

library/src/compute/construct.rs

@@ -188,11 +188,16 @@ cast! {
 ///
 /// ## Example
 /// ```example
-/// #datetime(
+/// #let date = datetime(
 ///   year: 2012,
 ///   month: 8,
 ///   day: 3,
-/// ).display()
+/// )
+///
+/// #date.display() \
+/// #date.display(
+///   "[day].[month].[year]"
+/// )
 /// ```
 ///
 /// ## Format
@@ -306,6 +311,9 @@ cast! {
 
 /// Returns the current date.
 ///
+/// Refer to the documentation of the [`display`]($type/datetime.display) method
+/// for details on how to affect the formatting of the date.
+///
 /// ## Example
 /// ```example
 /// Today's date is