summaryrefslogtreecommitdiff
path: root/xembed.1
diff options
context:
space:
mode:
authorConnor Lane Smith <cls@lubutu.com>2015-05-06 17:46:10 +0100
committerChristoph Lohmann <20h@r-36.net>2015-05-09 20:03:08 +0200
commitd60069a3e7a9e382f3221f8e405ad8c05abeea20 (patch)
tree457490ce70458e79e7adeb3ec019a2bf74cd93dc /xembed.1
parent0728caee306423cd1dc139e000828329c9285ab7 (diff)
add xembed wrapper utility
xembed will cause a command to attempt to XEmbed into the window given by the environment variable XEMBED, so long as it is in the foreground of its controlling terminal. This causes a process to effectively take the place of the terminal window, unless it is backgrounded. Signed-off-by: Christoph Lohmann <20h@r-36.net>
Diffstat (limited to 'xembed.1')
-rw-r--r--xembed.135
1 files changed, 35 insertions, 0 deletions
diff --git a/xembed.1 b/xembed.1
new file mode 100644
index 0000000..5b0c28c
--- /dev/null
+++ b/xembed.1
@@ -0,0 +1,35 @@
+.TH XEMBED 1 tabbed\-VERSION
+.SH NAME
+xembed \- XEmbed foreground process
+.SH SYNOPSIS
+.B xembed
+.I flag command
+.RI [ "argument ..." ]
+.SH DESCRIPTION
+If the environment variable XEMBED is set, and
+.B xembed
+is in the foreground of its controlling tty, it will execute
+.IP
+command flag $XEMBED [argument ...]
+.LP
+Otherwise it will execute
+.IP
+command [argument ...]
+.LP
+.SH EXAMPLE
+In a terminal emulator within a
+.B tabbed
+session, the shell alias
+.IP
+$ alias surf='xembed -e surf'
+.LP
+will cause `surf' to open in a new tab, unless it is run in the background,
+i.e. `surf &', in which case it will instead open in a new window.
+.SH AUTHORS
+See the LICENSE file for the authors.
+.SH LICENSE
+See the LICENSE file for the terms of redistribution.
+.SH SEE ALSO
+.BR tabbed (1)
+.SH BUGS
+Please report them.