% @(#)renameimag.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:54 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      renameimag.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, RENAME/IMAGE
%.PURPOSE    On-line help file for the command: RENAME/IMAGE
%.VERSION    1.0  03-MAY-1985 : Creation, KB
%.VERSION    1.1  29-MAY-1991 : Update, KB
%.VERSION    1.2  04-NOV-1994 : KB
%----------------------------------------------------------------
\se
SECTION./IMAG
\es\co
RENAME/IMAGE						04-NOV-1994  KB
\oc\su
RENAME/IMAGE old new [history] [overwrite]
	rename an image frame
\us\pu
Purpose: 
          Rename an image frame.
\up\sy
Syntax:
          RENAME/IMAGE old new [history] [overwrite]
\ys\pa
          old = old name of image frame
\ap\pa
          new = new name of image frame
\ap\pa
          history = flag for update of HISTORY descriptor;
\\
              if NO, the history descriptor of the new frame is not updated;
\\
              defaulted to YES
\ap\pa
          overwrite = flag for overwrite check;
\\
              if CONFIRM, we check, if a file with the new name already exists
              and if so, ask for confirmation before overwriting it;
\\
              defaulted to NO_CONFIRM
\ap\sa
See also:
          RENAME/FIT, RENAME/TABLE
\as\no
Note:
          The parameters may also be referenced via:
\\
          OLD=  NEW=  HISTORY=  OVERWRITE=
\\
          The frame is renamed and its entry in the active image catalog
          (if enabled) is updated as well.
\on\exs
Examples:
\ex
          RENAME/IMAGE gallina gallo
           Rename file gallina.bdf to gallo.bdf, if gallo.bdf already exists
           it is overwritten (Unix) or a new version created (VMS).
           The descriptor HISTORY of gallo.bdf is updated.
\xe \ex
          RENAME/IMAGE gato gata ? confirm
           Rename file gato.bdf to gata.bdf, if gata.bdf already exists
           we ask for confirmation before actually overwriting that file.
           If so, descriptor HISTORY of gata.bdf is updated.
\xe \sxe