%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990-2010 European Southern Observatory
%.IDENT      copy_ii.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, COPY/II
%.PURPOSE    On-line help file for the command: COPY/II
%.VERSION    1.0  28-JUN-1989 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./II
\es\co
COPY/II						22-JAN-1998   KB
\oc\su
COPY/II source_frame dest_frame dest_format flags
	copy source frame to destination frame
\us\pu
Purpose: 
          Copy source frame to destination frame and convert data to
          new format.
\up\sy
Syntax: 
          COPY/II source_frame dest_frame dest_format flags
\ys\pa
          source_frame = name of source frame
\ap\pa
          dest_frame = name of destination frame
\ap\pa
          dest_format = data format of destination frame,
              I1 for bytes, 
              I2 for 16bit integer, UI2 for unsigned 16bit integer,
              I4 for 32bit integer,
              R4 for 32bit real, R8 or D for 64bit real (double precision);
              defaulted to R4
\ap\pa
          flags = string with 2 flags (delete_flag + history_update_flag)
              separated by comma 
              delete_flag = 'D' or 'N', delete or not_delete input frame 
              after copying
              history_update_flag = 'U' or 'N', update or not_update the 
              descr. HISTORY of the dest_frame;
              defaulted to: N,U
\ap\sa
See also:
          CREATE/IMAGE, COPY/IT
\as\no
Note: 
          The type of the frames is defaulted to ".bdf" .
\on\exs
Examples:
\ex
          COPY/II pollo gallo I1
            Copy image frame `pollo.bdf' to frame `gallo.bdf' and convert the
            pixels to 8 bit integer values (bytes).
\xe\ex
          COPY/II gorrion paloma ui2
            Copy image frame `gorrion.bdf' to frame `paloma.bdf' and convert
            the pixels to 16 bit unsigned integer values.
\xe\ex
          COPY/II gorrion paloma ui2 d,n
            As above but delete frame `gorrion.bdf' afterwards and don't add
            the line: "COPY/II gorrion paloma ui2 d,n"
            to the descr. HISTORY of output frame `paloma.bdf'.
\xe \sxe
