#       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/Species/search
                ARB/<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
