improved doku

[[Imported from SVN: r4487]]

grid/common/intersectioniterator.hh

@@ -54,21 +54,22 @@ namespace Dune
      \image html  islocalref.png "IntersectionIterator in a locally refined mesh."
      \image latex islocalref.eps "IntersectionIterator in a locally refined mesh." width=\textwidth
 
-     Here the rule is the following: The IntersectionIterator delivers all intersections
+     Here the rule is the following: The %IntersectionIterator delivers all intersections
      with elements on the same level and in addition intersections with all leaf elements
      if it has been started on a leaf element.
 
-     According to this rule the intersection iterator started at a delivers an intersection
+     According to this rule the intersection iterator started at element a in the example above
+     delivers an intersection
      with b and c, the intersection itersection iterator started at c delivers intersections
      with a and d and b has an intersection with a.
 
      <h2>Intersections, leaf grid and level grid</h2>
 
-     Note that the intersections of an element accessible via the IntersectionIterator
+     Note that the intersections of an element accessible via the %IntersectionIterator
      are independent of whether the element results from a grid traversal with
-     a LevelIterator or a LeafIterator. For example, if the grid is traversed
-     with a LevelIterator the IntersectionIterator may provide access to an element
-     that is not on the same level (it may be on a lower level).
+     a %LevelIterator or a %LeafIterator. For example, if the grid is traversed
+     with a %LevelIterator the %IntersectionIterator may provide access to an element
+     that is not on the same level (but only if started at a leaf element).
 
 
      <h2>Interior and boundary entities</h2>
@@ -79,7 +80,7 @@ namespace Dune
 
      <h2>Intersections and processor boundaries</h2>
 
-     At processor boundaries, i.e. when an element has an intersection with another element
+     %At processor boundaries, i.e. when an element has an intersection with another element
      in the sequential grid but this element is only stored in other processors the
      intersection iterator stops but neither leafNeighbor(), levelNeighbor() nor boundary()
      are true.

grid/common/islocalref.eps

 %!PS-Adobe-2.0 EPSF-2.0
 %%Title: islocalref.fig
 %%Creator: fig2dev Version 3.2 Patchlevel 5-alpha7
-%%CreationDate: Thu Apr  6 14:52:53 2006
+%%CreationDate: Fri Apr  7 08:03:10 2006
 %%BoundingBox: 0 0 478 108
 %Magnification: 1.0000
 %%EndComments
@@ -278,16 +278,16 @@ gs 1 -1 sc (b) col0 sh gr
 3060 4680 m
 gs 1 -1 sc (a) col0 sh gr
 /Times-Roman ff 285.75 scf sf
-5445 3690 m
-gs 1 -1 sc (c) col0 sh gr
-/Times-Roman ff 285.75 scf sf
 8145 4545 m
 gs 1 -1 sc (level i) col0 sh gr
 /Times-Roman ff 285.75 scf sf
 8145 3960 m
 gs 1 -1 sc (level i+1) col0 sh gr
-/Times-Roman ff 190.50 scf sf
-7155 3645 m
+/Times-Roman ff 285.75 scf sf
+5445 3690 m
+gs 1 -1 sc (c) col0 sh gr
+/Times-Roman ff 285.75 scf sf
+7155 3690 m
 gs 1 -1 sc (d) col0 sh gr
 % here ends figure;
 $F2psEnd

grid/common/islocalref.fig

@@ -45,7 +45,7 @@ Single
 	 0.000 -1.000 -1.000 -1.000 -1.000 0.000
 4 0 0 50 -1 0 18 0.0000 2 195 135 6255 4680 b\001
 4 0 0 50 -1 0 18 0.0000 2 135 135 3060 4680 a\001
-4 0 0 50 -1 0 18 0.0000 2 135 120 5445 3690 c\001
 4 0 0 50 -1 0 18 0.0000 2 195 675 8145 4545 level i\001
 4 0 0 50 -1 0 18 0.0000 2 195 960 8145 3960 level i+1\001
-4 0 0 50 -1 0 12 0.0000 2 135 105 7155 3645 d\001
+4 0 0 50 -1 0 18 0.0000 2 135 120 5445 3690 c\001
+4 0 0 50 -1 0 18 0.0000 2 195 135 7155 3690 d\001