aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEuAndreh <eu@euandre.org>2022-10-21 15:01:53 -0300
committerEuAndreh <eu@euandre.org>2022-10-21 15:02:12 -0300
commitd5b0642608a705d5c5de9e8a7f46095e23efa0bf (patch)
tree622b36593c6667158dcb40a66242cdf777c3cffe
parentbin/update: Combine `repos` and `vcs` to fetch updates from repositories (diff)
downloaddotfiles-d5b0642608a705d5c5de9e8a7f46095e23efa0bf.tar.gz
dotfiles-d5b0642608a705d5c5de9e8a7f46095e23efa0bf.tar.xz
bin/x: Generate WIP version of the POD manpage
Remove FIXME marker.
-rw-r--r--Makefile4
-rwxr-xr-xbin/x53
2 files changed, 11 insertions, 46 deletions
diff --git a/Makefile b/Makefile
index 4e2f14a..f0ef75c 100644
--- a/Makefile
+++ b/Makefile
@@ -2,6 +2,7 @@
pod2man = \
+ share/man/man1/x.1 \
share/man/man1/z.1 \
@@ -21,6 +22,9 @@ derived-assets = \
all: $(derived-assets)
+share/man/man1/x.1: bin/x
+ pod2man bin/x > $@
+
share/man/man1/z.1: bin/z
pod2man bin/z > $@
diff --git a/bin/x b/bin/x
index 2133c2f..42f5770 100755
--- a/bin/x
+++ b/bin/x
@@ -106,58 +106,19 @@ for (@ARGV) {
exit status_for(system @CMD);
+
__END__
=head1 NAME
-z - automatically uncompress arguments to other commands
+x - chain shell commands without creating a subshell
=head1 SYNOPSYS
-z COMMAND FILE... ARGUMENTS...
+x COMMANDS... [ '&&' / '||' / '|' ] COMMANDS...
+
+x COMMANDS... [ 'AND' / 'OR' / 'PIPE' ] COMMANDS...
+
+x -h
=cut
-# FIXME: implement manpage in pod
-# .TH x 1 1970-01-01 "x latest" "x user manual"
-#
-#
-# .SH NAME
-#
-# x - chain shell commands without creating a subshell.
-#
-#
-# .SH SYNOPSYS
-#
-# \fBx\fR [\fIOPTIONS\fR] COMMAND... [ \fI'&&'\fR / \fI'||'\fR / \fI'|'\fR ] COMMAND...
-#
-#
-# .SH DESCRIPTION
-#
-# \fBx\fR is a \m[blue]\fBtool\fP\m[], from
-# .pdfhref W -D https://euandre.org/ -- The best website ever
-# .
-#
-#
-# .SH OPTIONS
-#
-# .TP
-# \fB-h\fR, \fB--help\fR
-# Show help text.
-#
-#
-# .SH OPERATORS
-#
-#
-# =pod
-# =head1 Heading Text
-# =head2 Heading Text
-# =head3 Heading Text
-# =head4 Heading Text
-# =over indentlevel
-# =item stuff
-# =back
-# =begin format
-# =end format
-# =for format text...
-# =encoding type
-# =cut