; HITEXT
;---------------------------------------------------------------
;! writes lines from history extension file to text file
;# Verb Catalog General
;-----------------------------------------------------------------------
;;  Copyright (C) 1995, 2008-2009, 2019
;;  Associated Universities, Inc. Washington DC, USA.
;;
;;  This program is free software; you can redistribute it and/or
;;  modify it under the terms of the GNU General Public License as
;;  published by the Free Software Foundation; either version 2 of
;;  the License, or (at your option) any later version.
;;
;;  This program is distributed in the hope that it will be useful,
;;  but WITHOUT ANY WARRANTY; without even the implied warranty of
;;  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;;  GNU General Public License for more details.
;;
;;  You should have received a copy of the GNU General Public
;;  License along with this program; if not, write to the Free
;;  Software Foundation, Inc., 675 Massachusetts Ave, Cambridge,
;;  MA 02139, USA.
;;
;;  Correspondence concerning AIPS should be addressed as follows:
;;         Internet email: aipsmail@nrao.edu.
;;         Postal address: AIPS Project Office
;;                         National Radio Astronomy Observatory
;;                         520 Edgemont Road
;;                         Charlottesville, VA 22903-2475 USA
;-----------------------------------------------------------------------
HITEXT    LLLLLLLLLLLLUUUUUUUUUUUU CCCCCCCCCCCCCCCCCCCCCCCCCCCCC
HITEXT:  Verb to copy the history file to a text file
INNAME                             Image name(name).
INCLASS                            Image name(class).
INSEQ           0.0      9999.0    Image name(seq. #). 0=>high
INDISK          0.0         9.0    Disk drive #. 0=>any
OUTTEXT
                                   File to write
HISTART         0.0                start output w record HISTART
                                      <= 0 => 1
HIEND           0.0                end output w record HIEND
                                      < HISTART => end
PRTASK                             output only history of task
----------------------------------------------------------------
HITEXT
Type: Verb
Use:  HITEXT allows the user to copy selected lines from the
      history file of an image or uv data set to a text file.
      This text file may then be edited with the user's favorite
      editor and then put back into one or more history files
      (using verb HINOTE).  To replace a history file with an
      edited file, first run HITEXT, then clear the hsitory with
      verb STALIN or DELEXT, edit the text file, and finally
      read it back with HINOTE.  If you are doing this, you
      should not use adverbs HISTART, HIEND, and PRTASK!
Adverbs:
  INNAME......Image name(name).   Standard defaults.
  INCLASS.....Image name(class).  Standard defaults.
  INSEQ.......Image name(seq. #).  0 => highest.
  INDISK......Disk drive # of image.  0 => any.
  OUTTEXT.....OUTTEXT specifies a text file to be created and
              filled with the selected lines of history.
  HISTART.....Write history records beginning with record
              HISTART.  0 or too large => 1.
  HIEND.......Write history records ending with record HIEND.
              < HISTART => maximum history entry.
  PRTASK......Write only those history records which begin with
              the same n non-blank characters as are given in
              PRTASK.  This is not particularly reliable, but
              should select the messages of particular tasks.
              Thus, PRTASK = 'UV   ' should write all messages
              from UVLOD, UVMAP, UVSRT, etc. but skip those from
              IMLOD, IMAGR, APCLN, etc.
----------------------------------------------------------------
