%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990-2010 European Southern Observatory
%.IDENT      copy_tbro.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, COPY/TBROW
%.PURPOSE    On-line help file for the command: COPY/TBROW
%.VERSION    1.0  080725	creation
%----------------------------------------------------------------
\se
SECTION./TBRO
\es\co
COPY/TBROW						15-JAN-2010  KB
\oc\su
COPY/TBROW table [col_sel] row_no dest_key
	copy single table row to char. keyword
\us\pu
Purpose:      
	      Copy single table row to char. keyword.
\up\sy
Syntax:       COPY/TBROW table [col_sel] row_no dest_key
\ys\pa
              table = table name
\ap\pa
              column_sel = column reference(s) of the listed column(s);
                   the comma is used to separate columns, usually only one ":"
                   is necessary at the beginning, e.g. :a,b,c
                   All the columns are listed by default.
                   Column names starting with the letter "s" need to be
                   entered with ":", e.g. :a,b,:some_column,c
                   because otherwise they are interpreted as column :SEQUENCE
\ap\pa
              row_no = number of the row, in the form @no, to be copied
\ap\pa
              dest_key = name of char. keyword to receive the char. string
		   containing the displayed row,
		   size of this keyword determines the line width used
\ap\sa
See also:
              READ/TABLE, PRINT/TABLE
\as\no
Note:         
	      This command is a wrapper around READ/TABLE and displays also
	      the specified row.
	      It differs from READ/TABLE with a single row in that 
	      the line width used for displaying the row is taken from the 
	      size of the destination keyword.
	      Choosing a large keyword can store the complete output of 
	      READ/TABLE which normally could take several lines.
	      E.g. if READ/TABLE would use 5 lines of 80 chars to display
	      a single table row, COPY/TBROW will store all that as flat string
	      into a keyword KOKO of size 400 chars.
	      Otherwise, just the last line displayed is saved in dest_key.
\on\exs
Examples:
\ex
              COPY/TBROW emiliano :ab,:xy,:status @3 zapata
                Display the selected columns at row 3 of table `emiliano.tbl'
		and copy this string to character keyword `zapata'.
		If size of keyword 'zapata' is not large enough the 
		output string is truncated.
\xe\ex
              COPY/TBROW pancho @10 villa
                Display the complete row 10 of table `pancho.tbl' and copy
		this string to character keyword `villa'.
\xe\ex
              COPY/TBROW pancho @10 villa >Null
                As above but suppress displaying the contents of
		table row 10, only copy it to the keyword 'villa'.
\xe\sxe
