% @(#)sort_icat.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:59 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      sort_icat.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, SORT/ICAT
%.PURPOSE    On-line help file for the command: SORT/ICAT
%.VERSION    1.0  24-JUN-1991 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./ICAT
\es\co
SORT/ICAT                                                 24-JUN-1991  KB
\oc\su
SORT/ICAT [cat_name] 
	sort an image catalog
\us\pu
Purpose:
          Sort an image catalog.
\up\sy
Syntax:
          SORT/ICAT [cat_name] 
\ys\pa
          cat_name = name of Image Catalog;
\\
              defaulted to the currently active Image Catalog
\ap\sa
See also:
          SORT/TCAT, SORT/FCAT, SET/ICAT, CREATE/ICAT
\\
          READ/ICAT, ADD/ICAT, SUBTRACT/ICAT, SEARCH/ICAT
\as\no
Note:
          Sorting is done according to the contents of the Ident field in the
          catalog (i.e. usually the contents of descr IDENT).
\\
          The sorted catalog is first stored in a temporary file midtemp.cat,
          then the input catalog is deleted and, finally, midtemp.cat is
          renamed back to the original cat_name.
\\
          Therefore the input catalog should not be opened at the same time by
          e.g. another MIDAS session.
\on\exs
Examples:
\ex
          SORT/ICAT
            Sort the currently active Image Catalog.
\xe\ex
          SORT/ICAT zopilote
            Sort the image catalog `zopilote.cat' .
\xe\sxe