From 622c1d747ebdf7663924a8dfc838e222ede464f7 Mon Sep 17 00:00:00 2001
From: Laurenz <laurmaedje@gmail.com>
Date: Fri, 9 Jun 2023 16:24:27 +0200
Subject: [PATCH] Final tweaks

---
 docs/src/general/changelog.md    |  4 ++--
 library/src/compute/construct.rs | 12 ++++++++++--
 2 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/docs/src/general/changelog.md b/docs/src/general/changelog.md
index 2119c826b..ce669bbb3 100644
--- a/docs/src/general/changelog.md
+++ b/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
diff --git a/library/src/compute/construct.rs b/library/src/compute/construct.rs
index a81c6a960..5ccefb187 100644
--- a/library/src/compute/construct.rs
+++ b/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