source: branches/lib/HELP_SOURCE/source/syncscroll.hlp

Last change on this file was 19532, checked in by westram, 4 months ago
  • reintegrates 'help' into 'trunk'
    • tweak arb documentation:
      • automatically link
        • ticket references to arb bug tracker (only affects html version).
        • found URLs.
      • page titles
        • warn about long titles.
        • introduce SUBTITLEs (automatically triggered by multi-line titles in source files).
        • increase allowed length (limited by subwindow width).
      • cleanup header sections in all helpfiles.
      • fix and/or update several help files.
      • document syntax of help sources.
      • build issues:
        • when xml validation fails, next build no longer uses invalid xml ⇒ keeps failing.
        • remove output files on error (including files below ARBHOME/lib).
        • pipe output through logs to ensure proper wrapping in Entering/Leaving lines.
    • moves Tree admin + NDS menu entries to top of menu
  • adds: log:branches/help@18783:19531
File size: 2.7 KB
Line 
1#       main topics:
2UP      arb.hlp
3UP      glossary.hlp
4
5#       sub topics:
6#SUB     subtopic.hlp
7
8# format described in ../help.readme
9
10
11TITLE           Synchronize tree scrolling
12
13OCCURRENCE      ARB_NT/Tree/Sync tree scrolling..
14
15DESCRIPTION     Allows to synchronize scrolling of two or more tree-views based on the
16                set of species currently displayed on screen.
17
18                To use this feature you need to open a second tree display
19                as explained in LINK{newwindow.hlp}.
20
21                After opening a second tree view, the selection list
22                in the "Synchronize tree scrolling" window will show that view.
23
24                   To help you to indentify the views, the name of the currently
25                   displayed tree is shown behind the view name. The view names
26                   themselves are just 'ARB' followed by a number like in 'ARB (1)'
27                   for all but the 1st view. These numbers match those in the window
28                   title of the tree views.
29
30                By selecting that view, the tree view of the first arb
31                window ("slave-view") will synchronize with the
32                second view ("master-view") once.
33
34                  * at any time you may press the 'Sync scroll' button to
35                    perform a instant synchronization of the slave-view or
36
37                  * you may select the 'Auto-sync'-toggle. If checked, the
38                    slave-view will automatically synchronize whenever the
39                    master-view does change.
40
41                The synchronization is based on visible species only (ie. folded
42                groups are ignored completely; in master- and slave-view).
43
44                During synchronization the slave-view gets scrolled to the position
45                containing most of the species currently visible in the master-view.
46                If there are multiple such positions, the "topmost" such position
47                is chosen.
48
49NOTES           Each tree view has its own separate 'Synchronize tree scrolling' configuration.
50
51EXAMPLES        You may also use more than two views for scroll synchronization.
52
53                For example open 3 windows and
54                 - synchronize the 2nd and 3rd view to the 1st view or
55                 - synchronize the 2nd to 1st and the 3rd to the 2nd view
56
57                If you configure a looped dependency, ARB will switch off
58                one dependency to avoid a deadlock.
59
60WARNINGS        When used with BIG trees synchronizing two views may be quite slow.
61                In such cases it's not recommended to link the views with 'Auto-sync'.
62                Instead you may want to request each sync manually using the sync button.
63
64BUGS            No bugs known
Note: See TracBrowser for help on using the repository browser.