aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEuAndreh <eu@euandre.org>2024-01-29 09:25:07 -0300
committerEuAndreh <eu@euandre.org>2024-01-29 09:25:07 -0300
commitea544646fc14ce84f5c100879d37156a118f3d88 (patch)
tree83ff2a5e08df5bf081924cc7d1a7c3ae78fac9be
parentetc/guix/home.scm: Group newer dependencies by pilfered project (diff)
downloaddotfiles-ea544646fc14ce84f5c100879d37156a118f3d88.tar.gz
dotfiles-ea544646fc14ce84f5c100879d37156a118f3d88.tar.xz
bin/numbered: Add micro utility alongside its manpage
-rwxr-xr-xbin/numbered4
-rwxr-xr-xshare/man/en/man1/numbered.152
2 files changed, 56 insertions, 0 deletions
diff --git a/bin/numbered b/bin/numbered
new file mode 100755
index 0000000..d30c016
--- /dev/null
+++ b/bin/numbered
@@ -0,0 +1,4 @@
+#!/bin/sh
+set -eu
+
+exec awk '{ printf "%s\t%s\n", NR, $0 }'
diff --git a/share/man/en/man1/numbered.1 b/share/man/en/man1/numbered.1
new file mode 100755
index 0000000..835e137
--- /dev/null
+++ b/share/man/en/man1/numbered.1
@@ -0,0 +1,52 @@
+.TH numbered 1
+.
+.
+.SH NAME
+.
+numbered - add line numbering to the given input.
+.
+.
+.SH SYNOPSYS
+.
+\fBnumbered\fR
+.
+.
+.SH DESCRIPTION
+.
+.PP
+\fBnumbered\fR adds line numbering to the text content of the given input.
+.
+.PP
+\fBnumbered\fR reads from \fISTDIN\fR and writes to \fISTDOUT\fR.
+.
+.
+.SH OPTIONS
+.
+.
+None.
+.
+.SH EXAMPLES
+.
+.PP
+Add line numbering to a single file:
+.
+.RS
+.nf
+$ numbered < Makefile
+.fi
+.RE
+.
+.
+.PP
+Add line numbering to multiple files:
+.
+.RS
+.nf
+$ cat f1.txt f2.txt | numbered
+.fi
+.RE
+.
+.
+.SH SEE ALSO
+.
+\fBcat(1), \fBawk\fR(1)