#       main topics:
UP      arb.hlp
UP      glossary.hlp
UP      mode.hlp
UP      sp_info.hlp

#       sub topics:
SUB     tree_group.hlp

# format described in ../help.readme


TITLE           GROUP MODE

OCCURRENCE      ARB main window and ARB_PARSIMONY: <GROUP> button in the left column
                F3 on the keyboard

DESCRIPTION     A group is a subtree with a name assigned to its root node.

                Collapsed groups are displayed as triangles (or rectangles
                in IRS tree; see LINK{tr_type_irs.hlp}).

                The 'GROUP MODE' allows you to expand or collapse groups
                and to create, rename or destroy groups.

                Click on the <GROUP> button of the ARB window or
                the 'F3' key on the keyboard to activate the 'GROUP
                MODE'. In the latter case, the cursor has to be placed
                within the tree display area.


                Collapse/expand:

                         To collapse a group, either click on the diamond shown at the
                         root of the group, on the group bracket or its name.

                         To expand a group, click on the group triangle or its name.

                Create a group:

                        Click on the root branch of the subtree which shall be grouped.
                        Enter a group name when asked for.

                Destroy / rename / keel-over groups:

                        Select group as described for 'collapse/expand' above, but use the
                        right mouse button. Select the wanted action:

                              * KeelOver: inverts the orientation of LINK{keeled_groups.hlp}
                              * Rename: ask for new name and rename group
                              * Destroy: destroys the groups


NOTES           The lengths of the triangle sides reflect the longest and shortest overall
                branch lengths within the subtree.

                To collapse/expand via keyboard, see LINK{nt_keys.hlp}.

                When changing a keeled into a unkeeled group using KeelOver, that group is
                moved to its parents position. Use LINK{mode_move.hlp} to move the group information
                if that position isn't appropriate in your case.

EXAMPLES        None

WARNINGS        None

BUGS            No bugs known
