% @(#)show_desc.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:58 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      show_desc.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, SHOW/DESCRIPTOR
%.PURPOSE    On-line help file for the command: SHOW/DESCRIPTOR
%.VERSION    1.0  13-APR-1984 : Creation, KB
%.VERSION    1.1  04-JUN-1991 : Update, KB
%.VERSION    1.2  05-DEC-1991 : Add 3rd par., KB
%----------------------------------------------------------------
\se
SECTION./DESC
\es\co
SHOW/DESCR					20-JUL-1998  KB
\oc\su
SHOW/DESCR frame [descr_list] [flag]
	show existing descriptors with name, type and size 
\us\pu
Purpose: 
          Display name, type and size of descriptors of given frame.
\up\sy
Syntax:  
          SHOW/DESCR frame [descr_list] [flag]
\ys\pa
          frame = name of image
\ap\pa
          descr_list = descriptor name(s) or pattern(s) separated by a comma,
\\
             or `*' to display all descriptors,
\\
             or patternA|patternB (character `|' as used for OR in C or the
             pipe symbol in Unix) to display all descriptors with names
             matching patternA but not patternB,
\\
             or 'name.ascii' if ASCII file `name.ascii' contains the
             descriptors to be read (file type .ascii is required);
\\
             defaulted to '*', i.e. all descriptors of frame
\ap\pa
          flag = H(idden) if you only want descr. info in keyword OUTPUTI (see
               Note) and no display;
\\
               defaulted to N(ohidden)
\ap\sa
See also:
          READ/DESCR, PRINT/DESCR, WRITE/DESCR, DELETE/DESCR, WRITE/DHELP
\as\no
Note:  
          For patterns there are the following possibilities:
\\
          `abc*' => all descr. beginning with `abc' match
\\
          `*abc' => all descr. ending with `abc' match
\\
          `*abc*' => all descr. containing `abc' match
\\
          `abc*def' => all descr. beginning with `abc' and ending with `def'
          match the pattern.
\\
          If help text is available for a descriptor it is also displayed,
          otherwise the string (...) is output.
\\
          If descr_list is set to a specific descr. name (not '*' or a pattern),
          also the elements 1,2,3,4 of integer keyword OUTPUTI are filled:
\\
          OUTPUTI(1) = 1 or 0, if descr. exists or not.
\\
          If OUTPUTI(1) is 1, then (2) = descr. type (1,2,3 or 4 for integer,
          real, character or double descr);
\\
          (3) and (4) hold no. of elements and bytes per element of descr.
\\
          This information can then be used in a procedure.
\on\exs
Examples:
\ex
          SHOW/DESC durazno
            Show all the descriptors of frame `durazno.bdf'.
\xe \ex
          SHOW/DESC pera.tbl
            Show all the descriptors of table file `pera.tbl'.
\\
            Note, that we have to specify the full file name if it is not an
            image file.
\xe \ex
          SHOW/DESC pina eso*rms
            Show type and size of all hierarchical ESO descriptors of frame 
            `pina.bdf'  ending with `rms', e.g. ESO.GEN.AMBI.TEMPRMS.
\xe\ex
          SHOW/DESCR pina ESO.*|*.det.*
            Show type and size of all hierarchical ESO keywords of `pina.bdf' 
            except those with names containing the string `DET', e.g. descr.
            ESO.DET.CHIP1.PSZX would not be shown.
\xe \ex
          SHOW/DESC manzana BugsBunny
            Show type and size of descriptor BugsBunny of frame `manzana.bdf' 
            if it exists. The keyword OUTPUTI will be set accordingly. Also,
            display any help text if it exists.
\xe \sxe