summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKeith Packard <keithp@keithp.com>2013-02-28 11:36:18 -0800
committerKeith Packard <keithp@keithp.com>2013-02-28 11:36:18 -0800
commitd45135b4d283ce19545ef4696be4b91747ce03f8 (patch)
tree55b5e7d2c6c536211d42a84e71e298f31664db43
parentef165dc3f61e60683346b5ab9adec8a377238652 (diff)
Add manual
Signed-off-by: Keith Packard <keithp@keithp.com>
-rw-r--r--Makefile.am13
-rw-r--r--x-on-resize.c4
-rw-r--r--x-on-resize.man59
3 files changed, 74 insertions, 2 deletions
diff --git a/Makefile.am b/Makefile.am
index 978f26f..5064058 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -18,3 +18,16 @@ ChangeLog:
$(CHANGELOG_CMD)
dist-hook: ChangeLog INSTALL
+
+
+appmandir = $(APP_MAN_DIR)
+appman_PRE = x-on-resize.man
+appman_DATA = $(appman_PRE:man=$(APP_MAN_SUFFIX))
+
+EXTRA_DIST = $(appman_PRE)
+CLEANFILES = $(appman_DATA)
+SUFFIXES = .$(APP_MAN_SUFFIX) .man
+
+# String replacements in MAN_SUBSTS now come from xorg-macros.m4 via configure
+.man.$(APP_MAN_SUFFIX):
+ $(AM_V_GEN)$(SED) $(MAN_SUBSTS) < $< > $@
diff --git a/x-on-resize.c b/x-on-resize.c
index 93715a4..12f9558 100644
--- a/x-on-resize.c
+++ b/x-on-resize.c
@@ -172,8 +172,8 @@ main (int argc, char **argv)
if (start) {
if (config)
system(config);
- else
- printf("config\n");
+ if (resize)
+ system(resize);
}
for (;;) {
int configed = 0;
diff --git a/x-on-resize.man b/x-on-resize.man
new file mode 100644
index 0000000..d045928
--- /dev/null
+++ b/x-on-resize.man
@@ -0,0 +1,59 @@
+.\"
+.\" Copyright 2013 Keith Packard
+.\"
+.\" Permission to use, copy, modify, distribute, and sell this software and its
+.\" documentation for any purpose is hereby granted without fee, provided that
+.\" the above copyright notice appear in all copies and that both that
+.\" copyright notice and this permission notice appear in supporting
+.\" documentation, and that the name of Keith Packard not be used in
+.\" advertising or publicity pertaining to distribution of the software without
+.\" specific, written prior permission. Keith Packard makes no
+.\" representations about the suitability of this software for any purpose. It
+.\" is provided "as is" without express or implied warranty.
+.\"
+.\" KEITH PACKARD DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
+.\" INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
+.\" EVENT SHALL KEITH PACKARD BE LIABLE FOR ANY SPECIAL, INDIRECT OR
+.\" CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
+.\" DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+.\" TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+.\" PERFORMANCE OF THIS SOFTWARE.
+.\"
+.TH X-ON-RESIZE __appmansuffix__ __vendorversion__
+.SH NAME
+x-on-resize \- monitor for hotplug or screen reconfigure events
+.SH SYNOPSIS
+.B "x-on-resize"
+[\-\-help]
+[\-\-display \fIdisplay\fP]
+[\-\-config \fIconfig-script\fP]
+[\-\-resize \fIresize-script\fP]
+[\-\-start]
+.SH DESCRIPTION
+.I X-on-resize
+is used to monitor the X display for output configuration changes
+and/or screen resize events. When these occur, it can call external
+programs to respond to the new display environment.
+
+.SH OPTIONS
+.IP "\-h, \-\-help"
+Print out a summary of the usage and exit.
+.IP "\-d, \-\-display \fIname\fP"
+This option selects the X display to use. Note this refers to the X
+screen abstraction, not the monitor (or output).
+.IP "\-c, \-\-config \fIconfig-script\fP"
+This option selects the external script to run when the set of
+available outputs has changed. If not provided, x-on-resize prints
+"config" on stdout.
+.IP "\-r, \-\-resize \fIresize-script\fP"
+This option selects the external script to run when the size
+of the root window has changed. If not provided, x-on-resize prints
+"resize" on stdout.
+.IP "\-s, \-\-start"
+This directs x-on-resize to run any defined scripts at startup time in
+addition to when the specified conditions occur.
+.SH "SEE ALSO"
+Xrandr(__libmansuffix__), xrandr(__appmansuffix__)
+.SH AUTHORS
+Keith Packard,
+Open Source Technology Center, Intel Corporation.