Program: HISTORY Purpose: read, or update history or comment in set header Category: HEADER, UTILITY File: history.c Author: M.G.R. Vogelaar Keywords: INSET= Give set, subsets: Maximum number of subsets is 1024. ***STRING= Enter string to add to hist./comm.: [interactive mode] You can use HISTORY in an automatic or interactive mode. If you start HISTORY with a STRING= specification, then this string will be added to the history or comments depending on ITEM=. Otherwise, the interactive mode is started. ITEM= Select COMMENT or HISTORY items: C/[H] MODE= Do you want to EDIT or READ history items? E/[R] Description: In automatic mode: Add string in STRING= to history or comments items (ITEM=) for all subsets. If STRING= is empty, goto interactive mode. In interactive mode: List (or edit) all available information in the header of INSET= stored under the commentary (FITS) keywords COMMENT or HISTORY. One of these is selected with ITEM= If you want a list of the stored information, use MODE=R (the default). If you want to edit the infor- mation, use MODE=E In this mode, you enter the editor (specified with the environment variable EDITOR) and edit or create the file. If you save the changes in the editor, then also the header information will be updated. "History text should contain a history of steps and procedures associated with the processing of the associated data (NOST)". INSET= could also select subsets (e.g. INSET=AURORA FREQ 3:10). Read and edit actions are repeated for each subset separately. Before starting an edit action, the edit prompt will display which subset is used. Usually you will read/edit history and comment at top level. Then you need only to give the name of the set (e.g. INSET=AURORA) If you cancel an edit action, or leave the editor without writing the changes, the header information will not be changed. Notes: Use Hermes debug mode ( S) for debug information. Updates: Apr 25, 1995: VOG, Document created. Apr 25, 1996: VOG, STRING= added (automatic mode)