source: branches/lib/HELP_SOURCE/source/aaali.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: 1.9 KB
Line 
1#       main topics:
2UP      arb.hlp
3UP      glossary.hlp
4
5#       sub topics:
6SUB     realign_dna.hlp
7SUB     translate_dna_2_pro.hlp
8
9# format described in ../help.readme
10
11
12TITLE           Amino acid workflow
13
14                Recommended way to maintain amino acid alignments
15
16DESCRIPTION     how we handle AA/DNA databases:
17
18                    1. we maintain a DNA alignment for ALL sequences we want in our
19                       database.
20
21                    2. we translate the DNA alignment into an amino acid alignment
22                       => each species has 2 alignment entries,
23                       e.g. "data/ali_dna" and "data/ali_pro"
24
25                    3. we align the protein sequences
26
27                    4. we realign DNA (according to the aligned protein sequences; see LINK{realign_dna.hlp})
28
29                    Here some reasons why we act as described:
30
31                    * we want to maintain a DNA alignment, to be able to use
32                      the PT-Server (to find next relatives). You'll find a section
33                      about that issue in LINK{faligner.hlp}.
34                    * we want to keep DNA data, because it contains more information than the
35                      translated protein sequences (you cannot create DNA from protein
36                      sequences).
37                    * we want to align sequences using protein alignments, because the
38                      alignment of protein sequences is more determined than the alignment
39                      of the corresponding DNA sequences.
40                    * we always realign DNA after changing the protein alignment,
41                      to always be able to perform a new translation from scratch (e.g. if
42                      translation table changes; see LINK{translate_dna_2_pro.hlp})
43
44
45NOTES           None
46
47EXAMPLES        None
48
49WARNINGS        None
50
51BUGS            No bugs known
Note: See TracBrowser for help on using the repository browser.