% @(#)subtraicat.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:44:00 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      subtraicat.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, SUBTRACT/ICAT
%.PURPOSE    On-line help file for the command: SUBTRACT/ICAT
%.VERSION    1.0  03-SEP-1984 : Creation, KB
%.VERSION    1.1  20-JUN-1991 : Update, KB
%----------------------------------------------------------------
\se
SECTION./ICAT
\es\co
SUBTRACT/ICAT					20-JUN-1991  KB
\oc\su
SUBTRACT/ICAT [cat_name] frame_list                
	remove entries from an image catalog
\us\pu
Purpose:
          Remove entries from an image catalog.
\up\sy
Syntax: 
          SUBTRACT/ICAT [cat_name] [frame_list]                
\ys\pa
          cat_name = name of image catalog;
\\
              if there is an image catalog enabled (cf. SET/ICAT), 
              'cat_name' is defaulted to this "active" image catalog
\ap\pa
          frame_list = list of frames to be subtracted,
\\
               maybe file specifications, separated by a comma (no spaces!);
\\
               or a single catalog name;
\\
               or wildcard specifications (e.g. a3*,n*.bdf);
\\
               or numbers referring to the names (e.g. \#7,\#1)
\ap\no
Note:
          The different options for the frame_list may not be mixed!
\on\sa
See also:
          SET/ICAT, CREATE/ICAT, CLEAR/ICAT, READ/ICAT, ADD/ICAT
\\
          Chapter 3 of the MIDAS Users Guide, Volume A
\as\exs
Examples:
\ex
          SUBTRACT/ICAT dec88 galax001
          Remove the entry for image frame galax001.bdf from catalog dec88.cat
\xe\ex
          SUBT/ICAT dec88 gal*
          Remove entries for all image frames where the names begin with the
          string "gal" from catalog dec88.cat.
\xe\ex
          SUBT/ICAT dec88 nov89.cat
          Remove entries for all frames which are in the image catalog 
          nov89.cat from catalog dec88.cat.
\xe\ex
          SUBT/ICAT dec88 \#1,\#6
          Remove entries no. 1 and no. 6 from catalog dec88.cat.
\xe \sxe