% @(#)createacat.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:26 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      createicat.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, CREATE/ACAT
%.PURPOSE    On-line help file for the command: CREATE/ACAT
%.VERSION    1.0  03-JUN-1991 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./ACAT
\es\co
CREATE/ACAT                                            14-JUL-1994  KB
\oc\su
CREATE/ACAT [cat_name] [dir_spec]
	create a catalog of files in the current directory
\us\pu
Purpose: 
          Create a catalog of files in the current directory.
\up\sy
Syntax: 
          CREATE/ACAT [cat_name] [dir_spec]
\ys\pa
          cat_name = name of catalog, defaulted to 'acatalog.cat'
\ap\pa
          dir_spec = file specifications as used in the VMS '$ DIRECTORY' or
              UNIX '$ ls' command, defaulted to '*.*';
\\
              or table,label if the filenames are specified in a column of a
              Midas table;
\\
              if set to 'NULL', then the catalog is created without entries
\ap\sa
See also: 
          READ/ACAT, DELETE/ACAT, ADD/ACAT
\as\no
Note:  
          The file type of the MIDAS catalog is '.cat' . The catalog contains
          for each file an entry with a description if it can be derived from
          the file type, e.g. MIDAS procedure if type = '.prg', else the
          entry will be: ASCII file.
\\
          A file can then be accessed either via its name or via \#NO ,
          where NO is its sequence number (if it's in the currently active
          ASCII file catalog), resp. via \#NO_catname, where NO is its sequence
          number in the ASCII file catalog `catname'.
\on\exs
Examples:
\ex
          CREATE/ACAT
            Create the ASCII file catalog 'acatalog.cat' with entries for all
            files in your current directory
\xe\ex
          CREATE/ACAT special null
            Create the ASCII file catalog 'special.cat' with initially no 
            entries; entries may be filled via ADD/ACAT commands later on
\xe\ex
          CREATE/ACAT juarez matamoros,:files
            Create the ASCII file catalog `juarez.cat' with entries for all 
            files stored in column :files of table `matamoros.tbl'.
\xe\ex
          create/acat special n*
            Create the ASCII file catalog 'special.cat' with entries for all
            files beginning with the character 'n'.
\xe \sxe