% @(#)copy_tk.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:26 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      copy_tk.hlq
%.AUTHOR     JDP, IPG/ESO
%.KEYWORDS   MIDAS, help files, COPY/TK
%.PURPOSE    On-line help file for the command: COPY/TK
%.VERSION    1.0  12-OCT-1983 : Creation, JDP
%----------------------------------------------------------------
\se
SECTION./TK
\es\co
COPY/TK							12-OCT-1983  JDP
\oc\su
COPY/TK table [column ...] element keyword
	copy table element into keyword
\us\pu
Purpose:   
          Copy one or more table elements into a keyword.
\up\sy
Syntax:    
          COPY/TK table [column ...] element keyword
\ys\pa
          table = the input table name
\ap\pa
          column = the column reference
\ap\pa
          element = the element reference
\ap\pa
          keyword = the output keyword
\ap\sa
See also:
          COPY/KT
\as\no
Note:     
          WARNING: this is a slow way of transferring information from a table
          into a keyword and only recommended if several columns are involved. 
          For copying single elements, it is recommended to use:
\\
          keyword = m$value(table,column,row)
\on\exs
Examples:
\ex
          COPY/TK vilspa :INPUT1,:INPUT2 @20 outputr/r/1/2
            Copy  the elements in row 20 of the columns labeled :INPUT1 and
            :INPUT2 from the table `vilspa.tbl' into the keyword OUTPUTR(1,2).
\xe\ex
          outputr(1) = m$value(vilspa,:INPUT1,@20)
            Copy the (single) element in row 20 of the column :INPUT1 from the
            table `vilspa.tbl' into the keyword OUTPUTR.
\xe \sxe