Debian Codegraph @

upstream/debian-unstable/man1/recset.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3.
2 .TH RECSET "1" "April 2026" "GNU recutils 1.9" "User Commands"
3 .SH NAME
4 recset \- manipulate fields in a recfile
5 .SH SYNOPSIS
6 .B recset
7 [\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]...
8 .SH DESCRIPTION
9 Alter or delete fields in records.
10 .TP
11 \fB\-\-no\-external\fR
12 don't use external descriptors.
13 .TP
14 \fB\-\-force\fR
15 alter the records even if violating record
16 restrictions.
17 .TP
18 \fB\-\-help\fR
19 print a help message and exit.
20 .TP
21 \fB\-\-version\fR
22 show version and exit.
23 .SS "Record selection options:"
24 .TP
25 \fB\-i\fR, \fB\-\-case\-insensitive\fR
26 make strings case\-insensitive in selection
27 expressions.
28 .TP
29 \fB\-t\fR, \fB\-\-type\fR=\fI\,TYPE\/\fR
30 operate on records of the specified type only.
31 .TP
32 \fB\-e\fR, \fB\-\-expression\fR=\fI\,RECORD_EXPR\/\fR
33 selection expression.
34 .TP
35 \fB\-q\fR, \fB\-\-quick\fR=\fI\,STR\/\fR
36 select records with fields containing a string.
37 .TP
38 \fB\-n\fR, \fB\-\-number\fR=\fI\,NUM\/\fR,...
39 select specific records by position, with ranges.
40 .TP
41 \fB\-m\fR, \fB\-\-random\fR=\fI\,NUM\/\fR
42 select a given number of random records.
43 .SS "Field selection options:"
44 .TP
45 \fB\-f\fR, \fB\-\-fields\fR=\fI\,FIELDS\/\fR
46 comma\-separated list of field names with optional
47 subscripts.
48 .SS "Actions:"
49 .TP
50 \fB\-s\fR, \fB\-\-set\fR=\fI\,VALUE\/\fR
51 change the value of the selected fields.
52 .TP
53 \fB\-a\fR, \fB\-\-add\fR=\fI\,VALUE\/\fR
54 add the selected fields with the given value.
55 .TP
56 \fB\-S\fR, \fB\-\-set\-add\fR=\fI\,VALUE\/\fR
57 change the value of the selected fields. If they don't
58 exist then add a new field with that value.
59 .TP
60 \fB\-r\fR, \fB\-\-rename\fR=\fI\,NAME\/\fR
61 rename the selected fields to a given name. If an entire
62 record set is selected then the field is renamed in the
63 record descriptor as well.
64 .TP
65 \fB\-d\fR, \fB\-\-delete\fR
66 delete the selected fields.
67 .TP
68 \fB\-c\fR, \fB\-\-comment\fR
69 comment out the selected fields.
70 .SH AUTHOR
71 Written by Jose E. Marchesi.
72 .SH "REPORTING BUGS"
73 Report bugs to: bug\[email protected]
74 .br
75 GNU recutils home page: <https://www.gnu.org/software/recutils/>
76 .br
77 General help using GNU software: <http://www.gnu.org/gethelp/>
78 .SH COPYRIGHT
79 Copyright \(co 2010\-2020 Jose E. Marchesi.
80 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
81 .br
82 This is free software: you are free to change and redistribute it.
83 There is NO WARRANTY, to the extent permitted by law.
84 .SH "SEE ALSO"
85 The full documentation for
86 .B recset
87 is maintained as a Texinfo manual. If the
88 .B info
89 and
90 .B recset
91 programs are properly installed at your site, the command
92 .IP
93 .B info recutils
94 .PP
95 should give you access to the complete manual.