Table of Contents

Name

hisf - display and manipulate history of datafiles.

Synopsis

hisf in=sf_in [parameter=value] ...

Description

hisf displays the history (Headline,History), as found at the beginning (see tsf(1NEMO) ) of any structured data file. Optionally it can append a new history text string to the (from data stripped) output file. The output (history) has some value in adding new history information to an existing data file.

Parameters

The following parameters are recognized in any order if the keyword is also given:
in=sf_in
Input file, in binary structured format. [no default].
out=out_file
output file, in pure history format. The data have been stripped off the input file. [default: none]
item=
Select which item to print. It can be a number, in which case the appropriate history item is output, or all, in which case all history is written out (the default), or headline, in which case only the (optional) one-line headline of the dataset is output. [Default: all].
history=string
String appended to the existing history from the input file [default: none].
skip=nskip
Number of lines to skip from the (reverse) history. Since running the program, causes hisf itself to appear on the history list, a default value of 1 is used to fake a more sensible output. [Default: 1].

Bugs

hisf will only find history/headline’s at the beginning of a datafile. Of course this could be seen as the definition of a ’history’ line. Use csf(1NEMO) for more manual work.

See Also

tsf(1NEMO) , csf(1NEMO) , history(3NEMO) , getparam(3NEMO)

Author

Peter Teuben

Files


src/kernel/io    history.c (-DTOOLBOX)

Update History


 8-Mar-88    V1.0: created              PJT
22-jul-91    V1.9: documentation updated    PJT
6-may-95    V2.3: doc up to date with code    PJT


Table of Contents