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

#       main topics:
UP      arb.hlp
UP      glossary.hlp
UP      species.hlp
UP      mark.hlp

#       sub topics:
SUB     mark_list.hlp
SUB     unmark_list.hlp
SUB     del_list.hlp
SUB     write_field_list.hlp
SUB     mod_field_list.hlp
SUB     selected.hlp

# format described in ../help.readme


TITLE           Search Database for Species

OCCURRENCE      ARB_NT/Species/search
                ARB_NT/<species button: 4th broad rectangular button in
                top area>

DESCRIPTION     Searches for a (set of) species (not SAIs)
                that match (don't match) a query or are marked.

                The database is scanned for 'species' (see 'HELP')
                which contain (or do not contain) the search string within the
                specified 'field' (see LINK{glossary.hlp}). The corresponding
                species and the respective 'field' entries are listed in the
                'HIT LIST' subwindow. The number of hits is displayed after the
                'Hits:' prompt.

                Define whether matching or non-matching species should be
                        listed by pressing the appropriate combination of left
                        and right buttons in the top area. When performing
                        multiple searches, define whether the list of 'species'
                        should be replaced by the new results, and whether newly
                        found 'species' should be removed from or appended
                        to the existing list.

                Select a 'field' from the 'Search Field' subwindow.

                Type the search string in the 'Search string' subwindow.

                Press the <SEARCH> button.

NOTES           see LINK{searching.hlp} for details about searching.

                see LINK{search_duplicates.hlp}

EXAMPLES

                1. Search for a species called 'Pseudomonas tolaasii'

                        Select:                    Search all species that match the query
                        Select search field:       'full_name'
                        Type search expression:    'pseu*tol*'
                        Press:                     'SEARCH'

                2. Search for all species that are marked:

                        Select:                    Search all species that are marked
                        Press:                     'SEARCH'

                3. Search for all species that are marked and for which
                an entry is present in the field 'reference'

                        Select:                    Search all species that are marked
                        Press:                     'SEARCH'
                        Select:                    Keep species that match the query
                        Select search field:       'reference'
                        Type search string:        '*' (=search existing entry)
                        Press:                     'SEARCH' again


WARNINGS        If the hitlist becomes too long, it will be truncated.
                Nevertheless all operations work on non-truncated hitlist!

                Changing the sort order will most likely show different items, because the
                list gets truncated after it was sorted.

BUGS            No bugs known