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