sw/README | 12 ++++++++++++
1 file changed, 12 insertions(+)
New commits:
commit bbcd952c062288d9ee1efe9c786c2146abf457ea
Author: Miklos Vajna <vmik...@collabora.co.uk>
Date: Mon Sep 4 12:09:42 2017 +0200
sw: document the "leaf" layout concept
For some reason this is missing from the usual wiki pages.
Change-Id: I2c3dcce983053452dc9fd1e886f8169678d7e6a4
diff --git a/sw/README b/sw/README
index 60de27ba4ccd..54feb78fa7d1 100644
--- a/sw/README
+++ b/sw/README
@@ -197,3 +197,15 @@ There are multiple model classes involved for fields:
Note that there is no UNO service to represent a list.
+=== Layout ===
+
+The layout is a tree of SwFrame subclasses, the following relationships are
+possible between frames:
+
+- You can visit the tree by following the upper, lower, next and previous
pointers.
+- The functionality of flowing of a frame across multiple parents (e.g. pages)
+ is implemented in SwFlowFrame, which is not an SwFrame subclass. The logical
+ chain of such frames can be visited using the follow and precede pointers.
+ ("Leaf" is a term that refers to such a relationship.)
+- In case a frame is split into multiple parts, then the first one is called
+ master, while the others are called follows.
_______________________________________________
Libreoffice-commits mailing list
libreoffice-comm...@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/libreoffice-commits
