StaticMethod merge2 ($arev,$a,$brev,$b,$sep,$session,$info)

• $arev - rev for $a (string)
• $a - first ('original') string
• $brev - rev for $b (string)
• $b - second ('new') string
• $sep = separator, string RE e.g. '.*?\n' for lines
• $session - TWiki object
• $info - data block passed to plugins merge handler. Conventionally this will identify the source of the text being merged (the source form field, or undef for the body text)

$newText = TWiki::Merge::merge2(
   $oldrev, $old, $newrev, $new, '.*?\n', $session, $info );

StaticMethod merge3 ($arev,$a,$brev,$b,$crev,$c,$sep,

• $arev - rev for common ancestor (id e.g. ver no)
• $a - common ancestor
• $brev - rev no for first derivative string (id)
• $b - first derivative string
• $crev - rev no for second derivative string (id)
• $c - second derivative string
• $sep = separator, string RE e.g. '.*?\n' for lines
• $session - TWiki object
• $info - data block passed to plugins merge handler. Conventionally this will identify the source of the text being merged (the source form field, or undef for the body text)

Perform a merge of two versions (b and c) of the same text, using HTML <div> tags to mark conflicts. a is the common ancestor.

The granularity of the merge depends on the setting of $sep. For example, if it is ".*?\\n", a line-by-line merge will be done.

Where conflicts exist, they are labeled using the provided revision numbers.

The plugins mergeHandler is called for each merge.

Here's a little picture of a 3-way merge:

a <- ancestor / b c <- revisions \ / d <- merged result, returned.

call it like this:

    my ( $ancestorMeta, $ancestorText ) =
        $store->readTopic( undef, $webName, $topic, $originalrev );
    $newText = TWiki::Merge::merge3(
        $ancestorText, $prevText, $newText,
        $originalrev, $rev, "new",
        '.*?\n' );