% @(#)add_icat.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:15 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      add_icat.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, ADD/ICAT
%.PURPOSE    On-line help file for the command: ADD/ICAT
%.VERSION    1.0  03-SEP-1984 : Creation, KB
%.VERSION    1.1  20-JUN-1991 : Update, KB
%----------------------------------------------------------------
\se
SECTION./ICAT
\es\co
ADD/ICAT					25-SEP-1992  KB
\oc\su
ADD/ICAT [cat_name] frame_list [lowstr,histr] 
	add entries to an image catalog
\us\pu
Purpose: 
          Add entries to an image catalog.
\up\su
Subject:  
          Images, catalogs
\us\sy
Syntax:   
          ADD/ICAT [cat_name] frame_list [lowstr,histr]              
\ys\pa
          cat_name = name of image catalog; defaulted to currently active
               image catalog
\ap\pa
          frame_list = list of frames to be added,
\\
               maybe file specifications, separated by a comma (no spaces!);
\\
               or a single catalog name;
\\
               or wildcard specifications (e.g. a3*,n*.bdf)
\ap\pa
          lowstr,histr = optional low and high strings;
\\
          if given, only frames with names >= `low' and <= `high' will be added
\ap\no
Note: 
          The different options for the frame_list may not be mixed!
\\
          Entries are added automatically to the currently "active" image
          catalog (SET/ICAT command makes a catalog active).
\\
          If the entry is an "invalid" file specification, e.g. non-existent
          image name, a warning is displayed but the entry added anyway.
\on\sa
See also: 
          CREATE/ICAT, SET/ICAT, CLEAR/ICAT, READ/ICAT, SUBTRACT/ICAT
\\
          ADD/TCAT, ADD/FCAT
\as\exs
Examples:
\ex
          ADD/ICAT dec88 galax001,sun04,moon11.ima
            Add entries for image frames `galax001.bdf', `sun04.bdf' and
            `moon11.ima' to catalog `dec88.cat'.
\xe\ex
          ADD/ICAT dec88 gal*
            Add entries for all image frames where the names begin with the
            string "gal" to catalog `dec88.cat'.
\xe\ex
          ADD/ICAT dec88 d* demo0025.bdf,demo0036.bdf
            Add entries for image frames with names `demo0025.bdf' -> 
            `demo0036.bdf' to catalog `dec88.cat'.
\xe\ex
          ADD/ICAT dec88 nov89.cat
            Add entries for all frames which are in the image catalog 
            `nov89.cat' to image catalog `dec88.cat'.
\xe \sxe