From 13ee16173e46c09ba97fd35e6000a3455aaac174 Mon Sep 17 00:00:00 2001 From: emma Date: Fri, 29 Mar 2024 16:47:00 -0600 Subject: [PATCH] fop.1: initial commit --- docs/fop.1 | 60 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 docs/fop.1 diff --git a/docs/fop.1 b/docs/fop.1 new file mode 100644 index 0000000..aa71b50 --- /dev/null +++ b/docs/fop.1 @@ -0,0 +1,60 @@ +.\" Copyright (c) 2024 DTB +.\" Copyright (c) 2024 Emma Tebibyte +.\" +.\" This work is licensed under CC BY-SA 4.0. To see a copy of this license, +.\" visit . + +.TH fop 1 + +.SH NAME + +fop \(en field operator + +.SH SYNOPSIS + +fop +.RB ( -d ) +.RB [ delimiter ] +.RB index +.RB program... + +.SH DESCRIPTION + +Performs operations on specified fields in input data. + +.SH OPTIONS + +.B -d +.RS +Sets a delimiter by which the input data will be split into fields. The default +is an ASCII record separator (␞). +.RE + +.SH STANDARD INPUT + +Data will be read from the standard input. + +.SH CAVEATS + +Field indices are zero-indexed, which may be unexpected behavior for some users. + +.SH RATIONALE + +With the assumption that tools will output data separated with ASCII field +separators, there is + +The idea for this utility originated in the fact that GNU ls(1) utility contains +a +.B -h +option which enables human-readable units in file size outputs. This +functionality was broken out into hru(1), but there was no easy way to modify +the field in the ouput of ls(1p) without a new tool. + +.SH COPYRIGHT + +Copyright © 2024 Emma Tebibyte. License AGPLv3+: GNU AGPL version 3 or later +. + +.SH SEE ALSO + +sed(1p)