58 |
|
with a backslash in most shells. |
59 |
|
If no argument is given, the default newline terminator is re-established. |
60 |
|
.PP |
61 |
< |
An output is either a file or a command. |
62 |
< |
If an output file exists, it will not be overwritten unless the |
61 |
> |
Output is either to a file, to a command, to the standard output, or to discard. |
62 |
> |
If a named output file exists, it will not be overwritten unless the |
63 |
|
.I \-f |
64 |
|
option is given, or it is being appended using the |
65 |
|
.I \-a |
66 |
|
option. |
67 |
+ |
The same output file may not appear more than once. |
68 |
|
Commands are given in quotes, and begin with an exclamantion point ('!'). |
69 |
< |
A period ('.') may also be specified as output, |
70 |
< |
which indicates that no output is desired for this field. |
71 |
< |
The corresponding data will be skipped on the input. |
69 |
> |
At most, one command may reliably write to its standard output, and |
70 |
> |
doing so is incompatible with |
71 |
> |
.I rsplit |
72 |
> |
also writing to standard output. |
73 |
> |
A hyphen ('-') by itself tells |
74 |
> |
.I rsplit |
75 |
> |
to write directly to its standard output, and may appear multiple times. |
76 |
> |
The options before the first appearance determine the |
77 |
> |
standard output header parameters. |
78 |
> |
A period ('.') tells |
79 |
> |
.I rsplit |
80 |
> |
to discard the corresponding data, and also may appear multiple times. |
81 |
|
.PP |
82 |
|
The |
83 |
|
.I \-oa |
114 |
|
option is given with a positive integer argument, this will be the |
115 |
|
maximum number of records that will be written by |
116 |
|
.I rsplit. |
107 |
– |
.PP |
108 |
– |
A hyphen ('-') by itself can be used to indicate the standard |
109 |
– |
output, and may appear multiple times. |
110 |
– |
The options before the first appearance determine the |
111 |
– |
header parameters, if any. |
112 |
– |
Results will be unpredictable if the standard output is specified |
113 |
– |
in this way |
114 |
– |
and any of the command outputs also writes to their standard output. |
115 |
– |
At most, one command may reliably write to its standard output. |
117 |
|
.PP |
118 |
|
The |
119 |
|
.I \-ih |