Work on sizes: restructured documentation.

4 files changed, 32 insertions, 11 deletions

diff --git a/doc/dw-grows.doc b/doc/dw-grows.doc
index a0304ef9..c255419f 100644
--- a/doc/dw-grows.doc
+++ b/doc/dw-grows.doc
@@ -1,5 +1,11 @@
 /** \page dw-grows GROWS - Grand Redesign Of Widget Sizes
 
+<div style="border: 2px solid #ffff00; margin: 1em 0;
+  padding: 0.5em 1em; background-color: #ffffe0">The complex "widget
+  sizes" is currently divided into three documents: \ref
+  dw-widget-sizes, **Grand Redesign Of Widget Sizes** (this document),
+  and \ref dw-size-request-pos. </div>
+
 This paper describes (will describe) some design changes to
 calculating widget sizes. Goals are:
 
diff --git a/doc/dw-out-of-flow.doc b/doc/dw-out-of-flow.doc
index 2a43b876..24e05732 100644
--- a/doc/dw-out-of-flow.doc
+++ b/doc/dw-out-of-flow.doc
@@ -141,7 +141,7 @@ Details are hidden by static inline methods of dw::OutOfFlowMgr.
 
 
 The sizeRequest/sizeAllocate problem
-========================================
+====================================
 
 *See also:* \ref dw-widget-sizes, especially the section *Rules for
 Methods Related to Resizing*.
@@ -242,4 +242,4 @@ See also
 
 → \ref dw-miscellaneous.
 
-*/
\ No newline at end of file
+*/
diff --git a/doc/dw-size-request-pos.doc b/doc/dw-size-request-pos.doc
new file mode 100644
index 00000000..e50f341c
--- /dev/null
+++ b/doc/dw-size-request-pos.doc
@@ -0,0 +1,15 @@
+/** \page dw-size-request-pos Size requisitions depending on positions
+
+<div style="border: 2px solid #ffff00; margin: 1em 0;
+  padding: 0.5em 1em; background-color: #ffffe0">The complex "widget
+  sizes" is currently divided into three documents: \ref
+  dw-widget-sizes, \ref dw-grows, and **Size requisitions depending on
+  positions** (this document). </div>
+
+Motivation
+==========
+
+As described in \ref dw-out-of-flow (*The sizeRequest/sizeAllocate
+problem*), ...
+
+*/
\ No newline at end of file
diff --git a/doc/dw-widget-sizes.doc b/doc/dw-widget-sizes.doc
index a82d3b99..ffc7fb5d 100644
--- a/doc/dw-widget-sizes.doc
+++ b/doc/dw-widget-sizes.doc
@@ -1,8 +1,14 @@
 /** \page dw-widget-sizes Sizes of Dillo Widgets
 
-<div style="border: 2px solid #ff4040; margin-bottom: 0.5em;
-padding: 0.5em 1em; background-color: #fff0f0"><b>Info:</b>
-Not up to date, see \ref dw-grows.</div>
+<div style="border: 2px solid #ffff00; margin: 1em 0;
+  padding: 0.5em 1em; background-color: #ffffe0">The complex "widget
+  sizes" is currently divided into three documents: **Sizes of Dillo
+  Widgets** (this document), \ref dw-grows, and \ref
+  dw-size-request-pos. </div>
+
+<div style="border: 2px solid #ff4040; margin: 1em 0;
+  padding: 0.5em 1em; background-color: #fff0f0"><b>Info:</b>
+  Not up to date, see other documents.</div>
 
 Allocation
 ==========
@@ -268,10 +274,4 @@ This could be done furthermore:
 - Is it possible to define exacter rules, along with a proof that no
   problems (like endless recursion) can occur?
 
-
-See also
-========
-
-- \ref dw-grows
-
 */