source: branches/lib/HELP_SOURCE/source/mode_length.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
  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 2.2 KB
Line 
1#       main topics:
2UP      arb.hlp
3UP      glossary.hlp
4UP      mode.hlp
5
6#       sub topics:
7#SUB     subtopic.hlp
8
9# format described in ../help.readme
10
11
12TITLE           LENGTH and MULTIFURC MODE
13
14OCCURRENCE      ARB_NT <button in the left column>
15
16DESCRIPTION     Both modes described here allow you to increase or reduce the length of
17                terminal and internal branches.
18
19                Click on the eleventh resp. twelfth button in the left column of
20                the 'ARB_NT' window to activate the 'LENGTH MODE' resp. 'MULTIFURC MODE'.
21
22                Change branch length:
23
24                       Click and drag a branch to change its length.
25
26                       If you use the right mouse button, discrete values
27                       will be used for the length.
28
29                Set branch length to zero:
30
31                       Point to a branch with the mouse and hit the key '0' (zero).
32
33SECTION         Differences between LENGTH- and MULTIFURC-MODES
34
35                The LENGTH MODE simply changes the length of the targeted branch.
36
37                The MULTIFURC-MODE changes the length of the targeted branch as well, but
38                also distributes its length-change to its direct (non-zero-length)
39                neighbour-branches.
40                Distribution is based on the same algorithm as LINK{multifurcate.hlp}.
41
42NOTES           To multifurcate explicit single branches, you may as well focus the tree-display,
43                move the mouse pointer to the bootstrap value of the branch to eliminate and then
44                press '0' to actually eliminate the branch.
45
46                Increasing the length of a branch in MULTIFURC-MODE may cause neighbour branches
47                to become multifurcations. This is irreversible, i.e. reducing the length back
48                to the original value will not "un-multifurcate" the affected branches.
49
50                In both modes it is possible to set branchlengths to negative values if expert-mode
51                is enabled.
52
53EXAMPLE         None
54
55WARNINGS        In MULTIFURC MODE you may not expect to undo all length distributions, by
56                scaling the branchlength back to the original value it had before a previous
57                scale operation!
58
59BUGS            unknown
Note: See TracBrowser for help on using the repository browser.