Table of Contents


hisf - display and manipulate history of datafiles.


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


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.


The following parameters are recognized in any order if the keyword is also given:
Input file, in binary structured format. [no default].
output file, in pure history format. The data have been stripped off the input file. [default: none]
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].
String appended to the existing history from the input file [default: none].
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].


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)


Peter Teuben


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