% @(#)createfcat.hlq	19.1 (ESO-IPG) 02/25/03 14:03:10 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      createfcat.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, CREATE/FCAT
%.PURPOSE    On-line help file for the command: CREATE/FCAT
%.VERSION    1.0  16-JAN-1990 : Creation, KB
%.VERSION    1.1  17-MAR-1992 : Update, KB
%----------------------------------------------------------------
\se
SECTION./FCAT
\es\co
CREATE/FCAT                                            14-JUL-1994  KB
\oc\su
CREATE/FCAT [catname] [dir_spec]
	create a catalog of fit files in the current directory
\us\pu
Purpose: 
          Create a catalog of fit files in current directory..
\up\sy
Syntax:
          CREATE/FCAT [catname] [dir_spec]
\ys\pa
          catname = name of catalog, defaulted to `fcatalog.cat'
\ap\pa
          dir_spec = file specifications as used in the VMS `$ DIRECTORY'
              or UNIX `$ ls' command;
\\
              or table,label if the filenames are specified in a column of a 
              Midas table;
\\
              if set to `NULL', the catalog is created without entries;
\\
              defaulted to `*.fit'
\ap\no
Note: 
          The file type of a MIDAS catalog is `.cat' . The catalog contains
          contains for each fit file an entry with:
\\
          sequence no., name
\\
          The catalog `xyz' is updated automatically by the system, if the
          catalog is the currently active fit file catalog (use the command
          "SET/FCAT xyz" to do that). I.e. creating a new fit file will also
          add a new entry to the catalog, whereas the command ADD/FCAT has to
          be used explicitly to add an entry to any other fit file catalog.
\\
          A fit 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
          fit file catalog), resp. via \#NO_catname, where NO is its sequence
          number in the fit file catalog catname.
\\
          Use the command CREATE/FCAT whenever your catalog does not
          reflect the actual directory because you executed some operating
          system commands like `$ COPY' (for VMS) or `$cp ' (for Unix) !
\on\see
See also:
          READ/FCAT, SET/FCAT, CLEAR/FCAT, SHOW/FCAT, DELETE/FCAT
\\

          ADD/FCAT, SUBTRACT/FCAT, SORT/FCAT, SEARCH/FCAT, PRINT/FCAT
\\
          CREATE/ICAT, CREATE/TCAT, CREATE/ACAT
\ees\exs
Examples:
\ex
          CREATE/FCAT
            Create the fit file catalog `fcatalog.cat' with entries for all
            fit files with filetype `.fit' in your current directory
\xe\ex
          CREATE/FCAT torreon null
            Create the fit file catalog `torreon.cat' with initially no 
            entries; it may be filled via ADD/FCAT commands later on
\xe\ex
          CREATE/FCAT mazatlan n*.fit
            Create the fit file catalog `mazatlan.cat' with entries for all 
            fit files matching n*.fit, e.g. n.fit, n123.fit, net.fit ...
\xe\ex
          CREATE/FCAT juarez matamoros,:files
            Create the fit catalog `juarez.cat' with entries for all fit
            files stored in column :files of table `matamoros.tbl'.
\xe\ex
          create/fcat guadalajara n*.fit,z*
            Create the fit file catalog `guadalajara.cat' with entries for all 
            fit files matching n*.fit and z* .
\xe \sxe
