Update docs

4 files changed, 33 insertions, 25 deletions

diff --git a/doc/cha-css.7 b/doc/cha-css.7
index 9e1b5d69..d91c93e3 100644
--- a/doc/cha-css.7
+++ b/doc/cha-css.7
@@ -101,6 +101,21 @@ then the former overrides the latter.
 Content that spills out of a scroll container on the X axis is
 displayed, while content that spills out of a scroll container on the Y
 axis is clipped.
+.SS \f[CR]position: fixed\f[R], \f[CR]position: sticky\f[R]
+To keep the document model static, these do not change their position
+based on the viewport\[cq]s scroll status.
+Instead:
+.IP \[bu] 2
+\f[CR]position: sticky\f[R] is treated as \f[CR]position: static\f[R],
+except it also behaves as an absolute position container.
+.IP \[bu] 2
+\f[CR]position: fixed\f[R] is placed at the bottom of the document.
+.PP
+Right now, \f[CR]position: fixed\f[R] is always positioned at the bottom
+of the root element\[cq]s margin box.
+This breaks on pages that overflow it (e.g.
+by setting \f[CR]height: 100%\f[R] on the root element), so it will be
+moved to the bottom of its overflow box in the future.
 .SS Color correction
 Some authors only specify one of the foreground or the background color,
 assuming a black\-on\-white canvas.
diff --git a/doc/cha-troubleshooting.7 b/doc/cha-troubleshooting.7
index 0e04b37b..8b39c705 100644
--- a/doc/cha-troubleshooting.7
+++ b/doc/cha-troubleshooting.7
@@ -82,7 +82,7 @@ To do the same for HTML and ANSI text, use \f[CR]plaintext, pre\f[R].
 .SS Why does \f[CR]$WEBSITE\f[R] look awful?
 Usually, this is because it uses some CSS features that are not yet
 implemented in Chawan.
-The most common offenders are grid and CSS variables.
+The most common offenders are grid and calc().
 .PP
 There are three ways of dealing with this:
 .IP "1." 3
@@ -150,19 +150,7 @@ The easiest workaround is to remove the shell from the equation using
 editor = \[aq]exec vi +%d\[aq]
 .EE
 .SS When I open Chawan from aerc, it prints garbage in the search field!
-See \c
-.UR https://todo.sr.ht/~bptato/chawan/33
-.UE \c
-\&.
-Until aerc is updated to include the fix, you can work around it like
-this:
-.IP
-.EX
-[display]
-# Use whatever colors your terminal actually uses. CSS\-style hex values
-# (#FFFFFF etc.) work too.
-default\-background\-color = \[dq]black\[dq]
-default\-foreground\-color = \[dq]white\[dq]
-.EE
+This should be fixed in the latest aerc version.
+Please update aerc.
 .SS See also
 \f[B]cha\f[R](1)
diff --git a/doc/css.md b/doc/css.md
index 1d3feaea..2823daf6 100644
--- a/doc/css.md
+++ b/doc/css.md
@@ -96,6 +96,20 @@ properties are handled as follows.
    displayed, while content that spills out of a scroll container on the
    Y axis is clipped.
 
+### `position: fixed`, `position: sticky`
+
+To keep the document model static, these do not change their position
+based on the viewport's scroll status.  Instead:
+
+* `position: sticky` is treated as `position: static`, except it also
+  behaves as an absolute position container.
+* `position: fixed` is placed at the bottom of the document.
+
+Right now, `position: fixed` is always positioned at the bottom of the
+root element's margin box.  This breaks on pages that overflow it (e.g.
+by setting `height: 100%` on the root element), so it will be moved to
+the bottom of its overflow box in the future.
+
 ### Color correction
 
 Some authors only specify one of the foreground or the background color,
diff --git a/doc/troubleshooting.md b/doc/troubleshooting.md
index d5ed7401..c659131f 100644
--- a/doc/troubleshooting.md
+++ b/doc/troubleshooting.md
@@ -138,16 +138,7 @@ editor = 'exec vi +%d'
 
 ## When I open Chawan from aerc, it prints garbage in the search field!
 
-See <https://todo.sr.ht/~bptato/chawan/33>.  Until aerc is updated to
-include the fix, you can work around it like this:
-
-```
-[display]
-# Use whatever colors your terminal actually uses. CSS-style hex values
-# (#FFFFFF etc.) work too.
-default-background-color = "black"
-default-foreground-color = "white"
-```
+This should be fixed in the latest aerc version. Please update aerc.
 
 <!-- MANON
 ## See also