% @(#)write_out.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:44:03 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      write_out.hlq
%.AUTHOR     KB, IPG/ESO
%.KEYWORDS   MIDAS, help files, WRITE/OUT
%.PURPOSE    On-line help file for the command: WRITE/OUT
%.VERSION    1.0  20-FEB-1986 : Creation, KB
%----------------------------------------------------------------
\se
SECTION./OUT
\es\co
WRITE/OUT						13-JAN-1991  KB
\oc\su
WRITE/OUT text_spec [section] [label]
	display text on terminal
\us\pu
Purpose: 
           Display text on terminal.
\up\sy
Syntax: 
           WRITE/OUT text_spec [section] [label]
\ys\pa
           text_spec = text string to be displayed (a) or name of text file (b)
\\
               (a) if the text string contains spaces it should be enclosed in
               double quotes (")
\\
               (b) complete specification of textfile, the type must be ".txt"
               and be appended to the name
\ap\pa
           section = char. string serving as section in textfile, only used in
               connection with text file (b)
\ap\pa
           label = char. string which is appended to section, to mark the
               beginning of the paragraph you want to display, only used in
               connection with text file (b)
\ap\sa
See also:
           WRITE/ERROR
\as\no
Note:  
           If you use WRITE/OUT with the text file option, then:
\\
           1) no variable substitution will be done in the text lines.
\\
           2) If section and label are omitted, the complete file will be
              displayed on the terminal (and stored into the logfile).
\on\exs
Examples:
\ex
           WRITE/OUT I am here to look at you and your pretty pictures.
           This command line would result in the following text output:
\\
           I am here to look at you and yourprettypictures.
\\
           However,
\\
           WRITE/OUT "I am here to look at you and your pretty pictures."
           is correct and yields the desired output.
\xe\ex
           WRITE/OUT display.txt  
           displays the contents of ASCII file display.txt
\\
           assume, display.txt contains the following lines:
\\
           aaaaaaaaaaaaaaaaa
\\
           Para_1
\\
           we all like weissbier
\\
           Paraxcf
\\
           bbbbbbbbbbbbbbbbbbbbbbbbbbbbb
\xe\ex
           WRITE/OUT display.txt Para _1
           displays all the lines of the ASCII file display.txt which are
           found after a line beginning with Para_1
           until a line beginning with ParaXYZ (XYZ may be any characters!)
           is found or until EOF, therefore it displays the line:
\\
           we all like weissbier
\xe\ex
           WRITE/OUT display.txt Para xcf
           displays:
\\
           bbbbbbbbbbbbbbbbbbbbbbbbbbbbb
\xe\ex
           WRITE/OUT {inputi} is in my keyword inputi
	   displays the content of the keyword inputi, e.g. if 0008 would be 
	   the value in inputi, the following output appears on the screen:
	   0008 is in my keyword inputi
\xe\ex
           WRITE/OUT {mylongchar}
           displays the content of the keyword mylongchar.
	   Be aware: even if mylongchar would be defined as longer than 100
           characters e .g. WRITE/KEY mylongchar/C/1/200 "a" all
	   you would only see the first 100 characters "a". To see the last 
	   one hundred characters, you would have to type:
           WRITE/OUT {mylongchar(101:200)}           
\xe \sxe