Syntax
tagreplace [-h][-a][-m [ fieldname op [fieldvalue]]... [-n num]
[-r [fieldname [fieldvalue]...][-f replacefilename]
[tagfilename]
Description
Modifier flags
- -h
- Disables normal header processing. If this is not present then
the first record is assumed to be a header, and will always be output
intact as the new header record.
- -a
- The selection and replacement process will operate on ALL matching
records, rather than just the first (which is the default).
Matching just the first is expected to be the most common case where the
selection is done by giving the primary tag of the file to match against.
- -m [fieldname op [fieldvalue]]
- gives the condition to match to select
the record(s) for replacement.
- -n num
- replace record number num
- -r [fieldname [fieldvalue]]
- gives the fields to be replaced using the
command line - the given fields in the selected record(s) will be replaced,
but the others will be unchanged.
- -f replacementfilename
- the entire contents of the selected record(s)
will be replaced by the contents of the file, which must be in valid tag
format.
- -d
- Print debugging information to stderr
Conditions
Most condition tests are of the form
fieldname operator value
but some do not require the value.
Bugs
The whole thing is not yet implemented