info: beginning of join-switches

Signed-off-by: Mattias Andrée <maandree@operamail.com>

1 files changed, 24 insertions, 0 deletions

diff --git a/info/join-python.texinfo b/info/join-python.texinfo
index 5db90c1..aef6641 100644
--- a/info/join-python.texinfo
+++ b/info/join-python.texinfo
@@ -53,6 +53,7 @@ Texts. A copy of the license is included in the section entitled
 * Overview::                        Brief overview of Join Python.
 * Signals::                         The signal construct.
 * Fragments::                       The fragment join construct.
+* Join-switches::                   Advanced joining techniques.
 * GNU Free Documentation License::  Copying and sharing this manual.
 @end menu
 
@@ -208,6 +209,29 @@ instead of a the @code{@@fragment} decorator.
 
 
 
+@node Join-switches
+@chapter Join-switches
+
+Join-switches is an advanced joining technique. It lets join
+join with whatever fragment group that is joined first. There
+are two versions of this: ordered joining and unordered joining.
+Ordered joining and unordered joining behaves the same if none
+of the fragment group have already joined when the joining is
+requested. But if there are more than one fragment group that
+have already joined that will behave differently: unordered
+joining will select a fragment group at random, whereas ordered
+joining will select the fragment group with highest precedence,
+that is, the fragment group specified first in the joining
+request. Ordered joining is done with the function
+@code{ordered_join} and unordered joining is done with the
+function @code{unordered_join}. They work similarly to @code{join},
+except each group is specified as a tuple of fragments and
+the returned value is a tuple of the index of the selected
+join case (fragment group) and what @code{join} returned for
+that fragment group.
+
+
+
 @node GNU Free Documentation License
 @appendix GNU Free Documentation License
 @include fdl.texinfo