% @(#)write_keyw.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:44:03 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      write_keyw.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, WRITE/KEYWORD
%.PURPOSE    On-line help file for the command: WRITE/KEYWORD
%.VERSION    1.0  03-JUN-1986 : Creation, KB
%.VERSION    1.1  16-MAR-1993 : Update, KB
%----------------------------------------------------------------
\se
SECTION./KEYW
\es\co
WRITE/KEYWORD						07-SEP-1998  KB
\oc\su
WRITE/KEYWORD key data [flg]
	write values into a keyword
\us\pu
Purpose: 
           Store values into a keyword.
\up\sy
Syntax:  
           WRITE/KEYWORD key data [flg]
\ys\pa
           key = complete keyword specification;
\\
               either name/type/first_elem/noval, e.g. INPUTI/I/1/2
\\
               or only keyword name, e.g. INPUTI, if the keyword exists
               already;
\\
               as many as `noval' data values will be written into the keyword
               `name' of given type, beginning at the first element
               (which is 1 if just keyword name is given).
\ap\pa
           data = data values, separated by a comma
\ap\pa
           flg = optional flag, if set to ALL, the keyword will be filled
               completely with the value given as data, so you set all key
               elements to that value
\ap\sa
See also:
           DEFINE/LOCAL_KEYWORD, READ/KEYWORD, SHOW/KEYWORD, HELP/KEYWORD,
\\
           COPY/KEYWORD, DELETE/KEYWORD
\\
           chapter 3 of the MIDAS Users Guide, volume A
\as\no
Note:  
           Valid types are I for integer, R for real, D for double precision,
           C for character keywords and C*nnn for character array keywords.
\\
           Contrary to descriptors, keywords cannot be extended once they have
           been defined with a given size.
\\
           Integer keywords can also be filled with hex. data by preceding
           the data values with `0x'.
\on\exs
Examples:
\ex
           WRITE/KEYWORD RR/R/1/5 1.,2.,3.,4.,5.
             Set real keyword elements RR(1), ..., RR(5) to 1.,2.,3.,4.,5.
\xe\ex
           WRITE/KEYWORD lola/I/1/5 22 ALL
             Set all elements of integer keyword lola to 22.
\xe\ex
           WRITE/KEYWORD inputi 0xff,10,-0xaaa
             Set the first 3 elements of integer keyword INPUTI to 
             255, 10 and -2730.
\xe\ex
           WRITE/KEYWORD petrita/c/6/5 zyxwvutsrq
             Change the contents of character keyword petrita(6:10) to the
             string 'zyxwv', so if petrita contained originally the string
             'whatastupidexample', it will be changed to 'whatazyxwvdexample'
             (the additional characters are ignored).
\xe\ex
           WRITE/KEYWORD clonk/c*5/1/10 abcde all
             Define character keyword `clonk' as a character array, like
\\
             "CHARACTER CLONK(10)*5" in FORTRAN or "char clonk[10][5]" in C,
\\
             and fill all its 10 elements (which are strings of 5 chars.) with
             the string 'abcde'.
\xe \sxe