From 949d55ab57d690f80a530acc7d674055bc8e3814 Mon Sep 17 00:00:00 2001 From: Tom Ryder Date: Wed, 24 Feb 2016 10:14:28 +1300 Subject: Add tl(1) and tlcs(1) --- man/man1/tl.1 | 21 +++++++++++++++++++++ man/man1/tlcs.1 | 24 ++++++++++++++++++++++++ 2 files changed, 45 insertions(+) create mode 100644 man/man1/tl.1 create mode 100644 man/man1/tlcs.1 (limited to 'man') 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 + 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 + -- cgit v1.2.3