.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH RECSET "1" "February 2024" "GNU recutils 1.9" "User Commands"
.SH NAME
recset \- manipulate fields in a recfile
.SH SYNOPSIS
.B recset
[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]...
.SH DESCRIPTION
Alter or delete fields in records.
.TP
\fB\-\-no\-external\fR
don't use external descriptors.
.TP
\fB\-\-force\fR
alter the records even if violating record
restrictions.
.TP
\fB\-\-help\fR
print a help message and exit.
.TP
\fB\-\-version\fR
show version and exit.
.SS "Record selection options:"
.TP
\fB\-i\fR, \fB\-\-case\-insensitive\fR
make strings case\-insensitive in selection
expressions.
.TP
\fB\-t\fR, \fB\-\-type\fR=\fI\,TYPE\/\fR
operate on records of the specified type only.
.TP
\fB\-e\fR, \fB\-\-expression\fR=\fI\,RECORD_EXPR\/\fR
selection expression.
.TP
\fB\-q\fR, \fB\-\-quick\fR=\fI\,STR\/\fR
select records with fields containing a string.
.TP
\fB\-n\fR, \fB\-\-number\fR=\fI\,NUM\/\fR,...
select specific records by position, with ranges.
.TP
\fB\-m\fR, \fB\-\-random\fR=\fI\,NUM\/\fR
select a given number of random records.
.SS "Field selection options:"
.TP
\fB\-f\fR, \fB\-\-fields\fR=\fI\,FIELDS\/\fR
comma\-separated list of field names with optional
subscripts.
.SS "Actions:"
.TP
\fB\-s\fR, \fB\-\-set\fR=\fI\,VALUE\/\fR
change the value of the selected fields.
.TP
\fB\-a\fR, \fB\-\-add\fR=\fI\,VALUE\/\fR
add the selected fields with the given value.
.TP
\fB\-S\fR, \fB\-\-set\-add\fR=\fI\,VALUE\/\fR
change the value of the selected fields.  If they don't
exist then add a new field with that value.
.TP
\fB\-r\fR, \fB\-\-rename\fR=\fI\,NAME\/\fR
rename the selected fields to a given name.  If an entire
record set is selected then the field is renamed in the
record descriptor as well.
.TP
\fB\-d\fR, \fB\-\-delete\fR
delete the selected fields.
.TP
\fB\-c\fR, \fB\-\-comment\fR
comment out the selected fields.
.SH AUTHOR
Written by Jose E. Marchesi.
.SH "REPORTING BUGS"
Report bugs to: bug\-recutils@gnu.org
.br
GNU recutils home page: <https://www.gnu.org/software/recutils/>
.br
General help using GNU software: <http://www.gnu.org/gethelp/>
.SH COPYRIGHT
Copyright \(co 2010\-2020 Jose E. Marchesi.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B recset
is maintained as a Texinfo manual.  If the
.B info
and
.B recset
programs are properly installed at your site, the command
.IP
.B info recutils
.PP
should give you access to the complete manual.