aboutsummaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
Diffstat (limited to 'man')
-rw-r--r--man/man1/tl.121
-rw-r--r--man/man1/tlcs.124
2 files changed, 45 insertions, 0 deletions
diff --git a/man/man1/tl.1 b/man/man1/tl.1
new file mode 100644
index 00000000..7560debb
--- /dev/null
+++ b/man/man1/tl.1
@@ -0,0 +1,21 @@
+.TH TL 1 "February 2016" "Manual page for tl"
+.SH NAME
+.B tl
+\- tag lines with a string prefix or suffix
+.SH USAGE
+.B tl [-h] [-p PREFIX] [-s SUFFIX] [--] [FILE1 FILE2 ...]
+.SH DESCRIPTION
+Tag lines from files or stdin with a string prefix or suffix before writing
+them to stdout. Specifying neither prefix nor suffix is acceptable, in which
+case the stream is simply reproduced on stdout, acting like cat(1).
+.P
+Option -h gives help. Specify a prefix with -p, and/or a suffix with -s. If no
+file arguments are given, defaults to reading standard input.
+.P
+ $ tl -p 'file: ' /path/to/file
+ $ dmesg | tl -s ' (stdout)'
+.SH SEE ALSO
+tlcs(1)
+.SH AUTHOR
+Tom Ryder <tom@sanctum.geek.nz>
+
diff --git a/man/man1/tlcs.1 b/man/man1/tlcs.1
new file mode 100644
index 00000000..4c39612e
--- /dev/null
+++ b/man/man1/tlcs.1
@@ -0,0 +1,24 @@
+.TH TLCS 1 "February 2016" "Manual page for tlcs"
+.SH NAME
+.B tlcs
+\- execute command and tag stdout/stderr lines
+.SH USAGE
+.B tlcs [-h] [-c] [-o STDOUT_PREFIX] [-e STDERR_PREFIX] [--] COMMAND [ARG1...]
+.SH DESCRIPTION
+Execute a command and tag the output of the stdout and stderr streams, line by
+line, using tl(1) under the hood. Add -c when writing to a terminal to color
+the lines.
+.P
+Option -h gives help. Specify a stdout prefix with -o (default "stdout: "),
+and/or a stderr prefix with -e (default "stderr: "). Option -c prints stdout
+lines in green and stderr lines in red if the respective streams are writing to
+appropriate terminals. Remaining arguments are assumed to be a command and its
+arguments.
+.P
+ $ tlcs cat ~/.vimrc
+ $ tlcs -e 'FAIL: ' nonexistent-command
+.SH SEE ALSO
+tl(1)
+.SH AUTHOR
+Tom Ryder <tom@sanctum.geek.nz>
+