From: Ben Pfaff <blp@cs.stanford.edu>
Date: Sun, 23 Aug 2026 15:47:39 +0000 (-0700)
Subject: document axis behavior
X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=33ecb1baba6def0724712fd79eeab09bbbdd307f;p=pspp

document axis behavior
---

diff --git a/rust/doc/src/spv/graphs.md b/rust/doc/src/spv/graphs.md
index 3d653fee8a..0013e94147 100644
--- a/rust/doc/src/spv/graphs.md
+++ b/rust/doc/src/spv/graphs.md
@@ -470,6 +470,21 @@ axisTransformParameter
 => EMPTY
 ```
 
+`majorTicks` requests drawing the axis itself and tick marks and
+labels.  When the axis is faceted, the axis can either be drawn just
+once or separately in each cell:
+
+- If the dimension has a polar transform, then the axis is drawn in
+  every cell (because there's no reasonable way to draw it just once).
+
+- If `faceting` specifies `method="nest"`, then the axis is drawn in
+  every cell because each cell has a different axis.
+
+- If the `axis` specifies `repeat="always"`, then the axis is drawn in
+  every cell.
+
+- Otherwise, the axis is drawn just once.
+
 `base`, if present, is most commonly zero but can be another number.
 
 `labelAngle`, if present, is -90, 90, 0, 45, 270, or 310 in the corpus.