tomwalters@0: .TH HDR 1 "1 September 1993"
tomwalters@0: 
tomwalters@0: .SH NAME
tomwalters@0: hdr \- Operations on AIM header.
tomwalters@0: 
tomwalters@0: .SH SYNTAX 
tomwalters@0: hdr [options] [file]
tomwalters@0: 
tomwalters@0: .SH DESCRIPTION
tomwalters@0: Read an AIM output file. If no filename is given then input is expected
tomwalters@0: on the stdin. The input from AIM is expected to consist of an AIM header
tomwalters@0: followed by some data.
tomwalters@0: The header operations are: stripping, querying, or modifying.
tomwalters@0: 
tomwalters@0: .SH OPTIONS
tomwalters@0: Options take the form:  <name>=<value>
tomwalters@0: and abbreviated option names are recognised provided they are unambiguous
tomwalters@0: wrt other names in the input header.
tomwalters@0: 
tomwalters@0: .nf
tomwalters@0: 
tomwalters@0: 1. Stripping. If no options are given, then strip the header
tomwalters@0:    and write the data which follows the header on the stdout.
tomwalters@0:    Eg:
tomwalters@0: 	gensai output=stdout ... | hdr | ...
tomwalters@0: 
tomwalters@0: 2. Querying. An empty value field (ie. <name>=) is interpreted
tomwalters@0:    as a query, and the corresponding option value found in the
tomwalters@0:    header is printed on the stderr.
tomwalters@0:    Eg., to query the value of option pwidth_aid:
tomwalters@0: 
tomwalters@0: 	hdr pwid=  file
tomwalters@0: 
tomwalters@0:    Special option names are:
tomwalters@0: 
tomwalters@0: 	"all"       causes all option values to be printed.
tomwalters@0: 	"format"    causes the format of the AIM output file to be printed.
tomwalters@0: 
tomwalters@0: 3. Modifying. Each option of the form <name>=<value> is
tomwalters@0:    substituted for the corresponding option found in the input
tomwalters@0:    header. A new header is constructed using the input header
tomwalters@0:    and all given substitutions, and the new header is written
tomwalters@0:    on the stdout, followed by the data which follows the input
tomwalters@0:    header.
tomwalters@0:    Eg., to change the value of pwidth_aid to 32ms:
tomwalters@0: 
tomwalters@0: 	hdr pwid=32ms  file >  file2
tomwalters@0: 
tomwalters@0: .fi
tomwalters@0: 
tomwalters@0: .SH "SEE ALSO"
tomwalters@0: edframe, fbank
tomwalters@0: 
tomwalters@0: .SH COPYRIGHT
tomwalters@0: .LP
tomwalters@0: Copyright (c) Applied Psychology Unit, Medical Research Council, 1995
tomwalters@0: .LP
tomwalters@0: Permission to use, copy, modify, and distribute this software without fee 
tomwalters@0: is hereby granted for research purposes, provided that this copyright 
tomwalters@0: notice appears in all copies and in all supporting documentation, and that 
tomwalters@0: the software is not redistributed for any fee (except for a nominal 
tomwalters@0: shipping charge). Anyone wanting to incorporate all or part of this 
tomwalters@0: software in a commercial product must obtain a license from the Medical 
tomwalters@0: Research Council.
tomwalters@0: .LP
tomwalters@0: The MRC makes no representations about the suitability of this 
tomwalters@0: software for any purpose.  It is provided "as is" without express or 
tomwalters@0: implied warranty.
tomwalters@0: .LP
tomwalters@0: THE MRC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING 
tomwalters@0: ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL 
tomwalters@0: THE A.P.U. BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES 
tomwalters@0: OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, 
tomwalters@0: WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, 
tomwalters@0: ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS 
tomwalters@0: SOFTWARE.
tomwalters@0: