% @(#)copy_dd.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:24 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      copy_dd.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, COPY/DD
%.PURPOSE    On-line help file for the command: COPY/DD
%.VERSION    1.0  14-MAR-1987 : Creation, KB
%.VERSION    1.1  17-APR-1991 : Update, KB
%----------------------------------------------------------------
\se
SECTION./DD  
\es\co
COPY/DD						02-OCT-2000   KB
\oc\su
COPY/DD source_frame source_desc dest_frame dest_desc [cleanup]
	copy descriptors of source frame to destination frame
\us\pu
Purpose: 
          Copy descriptors of source frame to destination frame.
\up\sy
Syntax: 
          COPY/DD source_frame source_desc dest_frame dest_desc [cleanup]
\ys\pa
          source_frame = name of source frame
\ap\pa
          source_desc = source descriptor specification,
              (a) a list of (max. 8) descr.names separated by a comma, 
                  if no `dest_desc' given, i.e. `source_desc' names are used,
                  also patterns like "abcd*", "*abc", "*abcd*" may be entered
                  instead of complete descr. names
                or
              (b) include_pattern|exclude_pattern (no `dest_desc' possible!)
                  to copy all descriptors which match the include_pattern
                  and don't match the exclude_pattern
                or
              (c) `*,flag[,excluded_descr_list]' for wildcard copying 
                  with `flag' indicating subgroups of descriptors 
                  flag = 1, copy all descr, = 2  copy only all standard descr,
                  flag = 3, copy all but the standard descriptors,
                  flag = 5, copy all but the extended list of stand. descr.,
                  if you want to exclude descriptors belonging to a chosen 
                  subgroup, you can add up to 8 descr.names separated by a 
                  comma or a single pattern like "abcd*", "*abcd", "*abcd*"
\ap\pa
          dest_frame = name of destination frame
\ap\pa
          dest_desc = destination descriptor specification
              a list of one or more descr. separated by a comma - must match
              the no. of descr.names given in `source_desc'
              if omitted, the source descriptor(s) is/are copied as they are,
              for option (c) of `source_desc', this parameter is ignored
              and descriptors are always copied as they are
\ap\pa
          cleanup = 1 or 0, to cleanup existing destination descriptors
              before copying the source descriptor,
              in case the size of the source descr is less than size of
              the destination descr;
              defaulted to 0
\ap\sa
See also:
          COPY/LSDD, COPY/KD, COPY/DK, READ/DESCR, WRITE/DESCR
\as\no
Note:  
          The type of the source and destination frame is defaulted to `.bdf'.
          The group of standard descriptors comprises:
          NAXIS, NPIX, START, STEP, CUNIT, IDENT, LHCUTS for images, and
          TBLENGTH, TBLOFFST, TBLCONTR, TSELTABL, TLABL* for tables.
          The group of extended standard descriptors is only applicable to
          images and has in addition to the standard descriptors:
          DISPLAY_DATA, HIST_BINS, HISTOGRAM, STATISTIC, WINDOW_TO, 
          WINDOW_FROM.
          Note, that descriptor names are case insensitive.
\on\exs
Examples:
\ex
          COPY/DD gallina LHCUTS/R/3/2 gato mystuff/R/12/2
            Copy elements 3,4 of descr LHCUTS of image `gallina.bdf' to
            elements 12,13  of decscriptor MYSTUFF of image `gato.bdf'.
\xe\ex
          copy/dd mariposa *,3 abella 
            Copy all descriptors of image `mariposa.bdf' except the standard
            descriptors to image `abella.bdf'.
\xe\ex
          copy/dd mariposa *,3 abella 1
            As above but destination descr's are cleaned in case they are
            larger than the corresponding source descr.
\xe\ex
          copy/dd gusano *,1,ESO.* hormiga 
            Copy all descriptors of image `gusano.bdf' except the hierarchical
            ESO FITS keywords (i.e. those beginning with "ESO.") to image
            `hormiga.bdf'.
\xe\ex
          copy/dd gusano o_time,ESO.*,o_pos,*st,ROTA hormiga 
            Copy all hierarchical ESO descriptors as well as O_TIME,O_POS,ROTA
            and all descriptors ending with "ST" of image `gusano.bdf' to 
            `hormiga.bdf'.
\xe\ex
          copy/dd gusano ESO.*|*.det.* hormiga 
            Copy only the hierarchical ESO FITS keywords of image `gusano.bdf' 
            excluding all *.DET.* descriptors to image `hormiga.bdf'.
\xe\ex
          copy/dd gusano ESO.* hormiga 
            Copy only the hierarchical ESO FITS keywords of image `gusano.bdf' 
            to image `hormiga.bdf'.
\xe\ex
          copy/dd gusano o_pos,origin,date hormiga 
            Copy only the descriptors O_POS, ORIGIN and DATE of image 
            `gusano.bdf' to image `hormiga.bdf'.
\xe\ex
          copy/dd aguila *,5,history,refpix vibora 
            Copy all descriptors, except the extended list of standard descr, 
            of image `aguila.bdf' to image `vibora.bdf'. Also, the descriptors
            HISTORY and REFPIX are not copied to to image `vibora.bdf'.
\xe\ex
          copy/dd zopilote *,2,NAXIS condor
            Copy the standard descriptors, except descr. NAXIS of image 
            `zopilote.bdf' to image `condor.bdf'.
\xe\ex
          copy/dd pajaro.tbl *,2,TLABL* amardillo.tbl
            Copy the standard table descriptors, except all the descr.s 
            TLABLxxx of table `pajaro.tbl' to table `amardillo.tbl'.
\xe \sxe