From f83d133e4e873f7370414d28fb20e591d151e8f1 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Fri, 7 Mar 2014 19:14:24 +0100 Subject: info: beginning of join-switches MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- info/join-python.texinfo | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) (limited to 'info') 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 -- cgit v1.2.3-70-g09d2