% @(#)identigcur.hlq	2.3 (ESO-IPG) 10/27/91 14:13:47 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      identigcur.hlq
%.AUTHOR     JDP, IPG/ESO
%.KEYWORDS   MIDAS, help files, IDENTIFY/GCURSOR
%.PURPOSE    On-line help file for the command: IDENTIFY/GCURSOR
%.VERSION    1.0  07-OCT-1985 : Creation, JDP
%----------------------------------------------------------------
\se              
SECTION./GCUR
\es\co
IDENTIFY/GCURSOR					07-OCT-1985  JDP
\oc\su
IDENTIFY/GCURSOR table ident x [y] [error]
	identify table entries from graphic terminal
\us\pu
Purpose:      
              Identify table entries from the graphic display.
              This command : 1.finds entries in the table with the
              smallest distance (see note below) to the cursor position,
              and 2. asks for the identification (see note below)
\up\sy
Syntax:       
              IDENTIFY/GCURSOR table ident x [y] [error]
\ys\pa
              table = table name
\ap\pa
              ident = reference to the column to be identified.
                      If the column does not exist it is created
                      with type 'R*4.
\ap\pa
              x     = reference to the column with the abscisae
\ap\pa
              y     = optional reference to the column with the ordinates
\ap\pa
              error = optional upper limit in the calculation of the
                      distance
\ap\no
Note:
              For XWindows use the mouse to move the cursor, the leftmost
              mouse button or the RETURN key on the keyboard is the ENTER 
              button: it will list the table entry. The second left mouse 
              button serves as EXIT button.\\  
              The cursor cross may not be visible at first. Move the mouse to 
              the lower left corner of the graphics window to grab the cursor.
\\
              For graphic terminals pressing any key of the graphics keyboard
              will list the table entry; the space bar is used to exit.
\\
              The identification is entered from the keyboard as:\\
                - a valid number of character string to be written into
                  the table. HENCE, it overwrites existing values !!!\\
                - the symbol * to delete the identification.\\
                - RETURN to skip to the next cursor position.\\
\\
              The distance is the euclidean distance in one or two
              dimensions according to the reference to the ordinate column.
\on\exs
Examples:
\ex
              IDENTIFY/GCURSOR POSITIONS :IDENT :X :Y
\xe \sxe