Hello community, here is the log from the commit of package xmessage for openSUSE:Factory checked in at 2013-01-22 18:10:50 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Comparing /work/SRC/openSUSE:Factory/xmessage (Old) and /work/SRC/openSUSE:Factory/.xmessage.new (New) ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "xmessage", Maintainer is "" Changes: -------- --- /work/SRC/openSUSE:Factory/xmessage/xmessage.changes 2012-05-08 12:06:01.000000000 +0200 +++ /work/SRC/openSUSE:Factory/.xmessage.new/xmessage.changes 2013-01-22 18:10:52.000000000 +0100 @@ -1,0 +2,19 @@ +Sat Jan 19 08:58:53 UTC 2013 - zai...@opensuse.org + +- Update to version 1.0.4: + + config: + - Add missing AC_CONFIG_SRCDIR. + - Move man pages into their own directory. + - Replace deprecated AM_CONFIG_HEADER with AC_CONFIG_HEADERS. + - Replace deprecated AC_HELP_STRING with AS_HELP_STRING. + - Remove AC_PROG_CC as it overrides AC_PROG_C_C99. + - Use AC_PROG_INSTALL now supplied by XORG_DEFAULT_OPTIONS. + - Upgrade to util-macros 1.8 for additional man page support. + - Update AC_PREREQ statement to 2.60. + + man: + - Replace hard coded man page section with substitution + strings. + - Remove trailing spaces and tabs. + - Point to the X manpage for more command line options. + +------------------------------------------------------------------- Old: ---- xmessage-1.0.3.tar.bz2 New: ---- xmessage-1.0.4.tar.bz2 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Other differences: ------------------ ++++++ xmessage.spec ++++++ --- /var/tmp/diff_new_pack.v2PKoo/_old 2013-01-22 18:10:52.000000000 +0100 +++ /var/tmp/diff_new_pack.v2PKoo/_new 2013-01-22 18:10:52.000000000 +0100 @@ -1,7 +1,7 @@ # # spec file for package xmessage # -# Copyright (c) 2012 SUSE LINUX Products GmbH, Nuernberg, Germany. +# Copyright (c) 2013 SUSE LINUX Products GmbH, Nuernberg, Germany. # # All modifications and additions to the file contributed by third parties # remain the property of their copyright owners, unless otherwise agreed @@ -15,17 +15,18 @@ # Please submit bugfixes or comments via http://bugs.opensuse.org/ # + Name: xmessage -Version: 1.0.3 +Version: 1.0.4 Release: 0 -License: MIT Summary: Utility to display a message or query in a window -Url: http://xorg.freedesktop.org/ +License: MIT Group: System/X11/Utilities +Url: http://xorg.freedesktop.org/ Source0: http://xorg.freedesktop.org/releases/individual/app/%{name}-%{version}.tar.bz2 BuildRequires: pkg-config BuildRequires: pkgconfig(xaw7) -BuildRequires: pkgconfig(xorg-macros) >= 1.4 +BuildRequires: pkgconfig(xorg-macros) >= 1.8 BuildRequires: pkgconfig(xt) # This was part of the xorg-x11 package up to version 7.6 Conflicts: xorg-x11 <= 7.6 ++++++ xmessage-1.0.3.tar.bz2 -> xmessage-1.0.4.tar.bz2 ++++++ ++++ 13859 lines of diff (skipped) ++++ retrying with extended exclude list diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/xmessage-1.0.3/ChangeLog new/xmessage-1.0.4/ChangeLog --- old/xmessage-1.0.3/ChangeLog 2010-01-30 08:15:19.000000000 +0100 +++ new/xmessage-1.0.4/ChangeLog 2013-01-13 07:23:35.000000000 +0100 @@ -1,3 +1,138 @@ +commit 2cc2b4bf7f370c5c804f4e75228677b2c58f1d7f +Author: Alan Coopersmith <alan.coopersm...@oracle.com> +Date: Sat Jan 12 22:21:57 2013 -0800 + + xmessage 1.0.4 + + Signed-off-by: Alan Coopersmith <alan.coopersm...@oracle.com> + +commit 36d79fb080723a019e18e166c36ccaf2127d199d +Author: Alan Coopersmith <alan.coopersm...@oracle.com> +Date: Sat Jan 12 22:21:05 2013 -0800 + + config: Add missing AC_CONFIG_SRCDIR + + Regroup AC statements under the Autoconf initialization section. + Regroup AM statements under the Automake initialization section. + + Signed-off-by: Alan Coopersmith <alan.coopersm...@oracle.com> + +commit 2e23c3cf3352eb66b2f9ee78c529d49a195ae0de +Author: Gaetan Nadon <mems...@videotron.ca> +Date: Wed Jan 19 10:06:56 2011 -0500 + + config: move man pages into their own directory + + Use services provided by XORG_MANPAGE_SECTIONS. + Use standard Makefile for man pages. + + Signed-off-by: Gaetan Nadon <mems...@videotron.ca> + +commit f84771abead3a89fd77db59d26ca194458e0bf22 +Author: Gaetan Nadon <mems...@videotron.ca> +Date: Thu Jan 13 17:15:36 2011 -0500 + + man: replace hard coded man page section with substitution strings + + Signed-off-by: Gaetan Nadon <mems...@videotron.ca> + +commit ee508e69c1160abdf339d8e32b575fb5da2598ec +Author: Gaetan Nadon <mems...@videotron.ca> +Date: Thu Jan 13 11:15:47 2011 -0500 + + man: remove trailing spaces and tabs + + Using s/[ \t]*$// + + Signed-off-by: Gaetan Nadon <mems...@videotron.ca> + +commit 402f6abee4b14c123a58065cb228277ab5c3cae7 +Author: Gaetan Nadon <mems...@videotron.ca> +Date: Wed Jan 12 16:28:02 2011 -0500 + + config: replace deprecated AM_CONFIG_HEADER with AC_CONFIG_HEADERS + + This silences an Autoconf warning + +commit 48ac5420e3efa494ff8a528ffdf02c94af7f22bb +Author: Gaetan Nadon <mems...@videotron.ca> +Date: Wed Jan 12 15:29:50 2011 -0500 + + config: replace deprecated AC_HELP_STRING with AS_HELP_STRING + + This silences an Automake warning. + + Signed-off-by: Gaetan Nadon <mems...@videotron.ca> + +commit 40c220b0515dbd0c8d619deed93c8e43d792b8ee +Author: Gaetan Nadon <mems...@videotron.ca> +Date: Wed Jan 12 13:10:21 2011 -0500 + + config: remove AC_PROG_CC as it overrides AC_PROG_C_C99 + + XORG_STRICT_OPTION from XORG_DEFAULT_OPTIONS calls + AC_PROG_C_C99. This sets gcc with -std=gnu99. + If AC_PROG_CC macro is called afterwards, it resets CC to gcc. + + Signed-off-by: Gaetan Nadon <mems...@videotron.ca> + +commit 8a534984a4215dd3282efad81f784dc2abc56a51 +Author: Gaetan Nadon <mems...@videotron.ca> +Date: Wed Jan 12 11:54:40 2011 -0500 + + config: use AC_PROG_INSTALL now supplied by XORG_DEFAULT_OPTIONS + + It depends on util-macros 1.8 or later + The existing statement can now be removed from the configuration file. + + Signed-off-by: Gaetan Nadon <mems...@videotron.ca> + +commit 08996e6dafa255b40264c0ce11e01d501a9f7ab9 +Author: Gaetan Nadon <mems...@videotron.ca> +Date: Wed Jan 12 11:23:52 2011 -0500 + + config: upgrade to util-macros 1.8 for additional man page support + + Use MAN_SUBST now supplied in XORG_MANPAGE_SECTIONS + The value of MAN_SUBST is the same for all X.Org packages. + + Signed-off-by: Gaetan Nadon <mems...@videotron.ca> + +commit 5c896e0f10fe6f87443f1656cff8cf5466822cf0 +Author: Gaetan Nadon <mems...@videotron.ca> +Date: Wed Jan 12 10:21:24 2011 -0500 + + config: update AC_PREREQ statement to 2.60 + + Unrelated to the previous patches, the new value simply reflects + the reality that the minimum level for autoconf to configure + all x.org modules in one pass is 2.60 dated June 2006. + + A version later than 2.60 can be used, but no new features from such + a later version can be used in configure.ac. + + Although the code in this module can be configured with a version earlier + than 2.60, most of code is now contained in macros from util-macros + which use features of version 2.60, at the present or in the future. + + ftp://ftp.gnu.org/gnu/autoconf/autoconf-2.60.tar.gz + + Signed-off-by: Gaetan Nadon <mems...@videotron.ca> + +commit 4bebccd8fde390d347df168415204dd296d09e9e +Author: Julien Cristau <jcris...@debian.org> +Date: Mon Nov 8 17:20:29 2010 +0100 + + man: point to the X manpage for more command line options + + It was already listed in 'SEE ALSO', but adding a reference in the + 'OPTIONS' section is probably easier to find. + + Reported-by: Ivan Vilata i Balaguer <i...@selidor.net> + Cc: 505...@bugs.debian.org + Signed-off-by: Julien Cristau <jcris...@debian.org> + Reviewed-by: Peter Hutterer <peter.hutte...@who-t.net> + commit ad5f249bf731ee06958e0948f0898ac3f3e26352 Author: Alan Coopersmith <alan.coopersm...@sun.com> Date: Fri Jan 29 23:14:56 2010 -0800 diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/xmessage-1.0.3/Makefile.am new/xmessage-1.0.4/Makefile.am --- old/xmessage-1.0.3/Makefile.am 2010-01-30 08:12:35.000000000 +0100 +++ new/xmessage-1.0.4/Makefile.am 2013-01-13 07:23:13.000000000 +0100 @@ -19,6 +19,7 @@ # TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR # PERFORMANCE OF THIS SOFTWARE. +SUBDIRS = man bin_PROGRAMS = xmessage AM_CFLAGS = $(CWARNFLAGS) $(XMESSAGE_CFLAGS) @@ -31,9 +32,6 @@ xmessage.c \ xmessage.h -appman_PRE = \ - xmessage.man - # App default files DISTCHECK_CONFIGURE_FLAGS = --with-appdefaultdir=\$${datadir}/X11/app-defaults @@ -43,37 +41,7 @@ app-defaults/Xmessage \ app-defaults/Xmessage-color -appmandir = $(APP_MAN_DIR) - -appman_DATA = $(appman_PRE:man=@APP_MAN_SUFFIX@) - -EXTRA_DIST = $(appman_PRE) MAINTAINERCLEANFILES = ChangeLog INSTALL -CLEANFILES = $(appman_DATA) - -SED = sed - -# Strings to replace in man pages -XORGRELSTRING = @PACKAGE_STRING@ - XORGMANNAME = X Version 11 - -MAN_SUBSTS = \ - -e 's|__vendorversion__|"$(XORGRELSTRING)" "$(XORGMANNAME)"|' \ - -e 's|__xorgversion__|"$(XORGRELSTRING)" "$(XORGMANNAME)"|' \ - -e 's|__xservername__|Xorg|g' \ - -e 's|__xconfigfile__|xorg.conf|g' \ - -e 's|__projectroot__|$(prefix)|g' \ - -e 's|__apploaddir__|$(appdefaultdir)|' \ - -e 's|__appmansuffix__|$(APP_MAN_SUFFIX)|g' \ - -e 's|__libmansuffix__|$(LIB_MAN_SUFFIX)|g' \ - -e 's|__adminmansuffix__|$(ADMIN_MAN_SUFFIX)|g' \ - -e 's|__miscmansuffix__|$(MISC_MAN_SUFFIX)|g' \ - -e 's|__filemansuffix__|$(FILE_MAN_SUFFIX)|g' - -SUFFIXES = .$(APP_MAN_SUFFIX) .man - -.man.$(APP_MAN_SUFFIX): - $(AM_V_GEN)$(SED) $(MAN_SUBSTS) < $< > $@ .PHONY: ChangeLog INSTALL diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/xmessage-1.0.3/configure.ac new/xmessage-1.0.4/configure.ac --- old/xmessage-1.0.3/configure.ac 2010-01-30 08:12:25.000000000 +0100 +++ new/xmessage-1.0.4/configure.ac 2013-01-13 07:23:13.000000000 +0100 @@ -21,34 +21,36 @@ dnl dnl Process this file with autoconf to create configure. -AC_PREREQ([2.57]) -AC_INIT(xmessage, [1.0.3], +# Initialize Autoconf +AC_PREREQ([2.60]) +AC_INIT(xmessage, [1.0.4], [https://bugs.freedesktop.org/enter_bug.cgi?product=xorg], xmessage) +AC_CONFIG_SRCDIR([Makefile.am]) +AC_CONFIG_HEADERS([config.h]) + +# Initialize Automake AM_INIT_AUTOMAKE([foreign dist-bzip2]) AM_MAINTAINER_MODE -# Require xorg-macros: XORG_DEFAULT_OPTIONS +# Require X.Org macros 1.8 or later for MAN_SUBSTS set by XORG_MANPAGE_SECTIONS m4_ifndef([XORG_MACROS_VERSION], - [m4_fatal([must install xorg-macros 1.4 or later before running autoconf/autogen])]) -XORG_MACROS_VERSION(1.4) + [m4_fatal([must install xorg-macros 1.8 or later before running autoconf/autogen])]) +XORG_MACROS_VERSION(1.8) XORG_DEFAULT_OPTIONS -AM_CONFIG_HEADER(config.h) - -AC_PROG_CC -AC_PROG_INSTALL - - # Checks for pkg-config packages PKG_CHECK_MODULES(XMESSAGE, xaw7) PKG_CHECK_MODULES(APPDEFS, xt) xt_appdefaultdir=`$PKG_CONFIG --variable=appdefaultdir xt` AC_ARG_WITH(appdefaultdir, - AC_HELP_STRING([--with-appdefaultdir=<pathname>], + AS_HELP_STRING([--with-appdefaultdir=<pathname>], [specify directory for app-defaults files (default is autodetected)]), [appdefaultdir="$withval"], [appdefaultdir="${xt_appdefaultdir}"]) AC_SUBST(appdefaultdir) -AC_OUTPUT([Makefile]) +AC_CONFIG_FILES([ + Makefile + man/Makefile]) +AC_OUTPUT diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/xmessage-1.0.3/man/Makefile.am new/xmessage-1.0.4/man/Makefile.am --- old/xmessage-1.0.3/man/Makefile.am 1970-01-01 01:00:00.000000000 +0100 +++ new/xmessage-1.0.4/man/Makefile.am 2013-01-13 07:23:13.000000000 +0100 @@ -0,0 +1,12 @@ + +appmandir = $(APP_MAN_DIR) +appman_PRE = xmessage.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 -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/xmessage-1.0.3/man/xmessage.man new/xmessage-1.0.4/man/xmessage.man --- old/xmessage-1.0.3/man/xmessage.man 1970-01-01 01:00:00.000000000 +0100 +++ new/xmessage-1.0.4/man/xmessage.man 2013-01-13 07:23:13.000000000 +0100 @@ -0,0 +1,180 @@ +.\" $XConsortium: xmessage.man,v 1.8 95/03/08 22:28:48 gildea Exp $ +.\" +.\" $XFree86$ +.\" +.TH XMESSAGE 1 __xorgversion__ +.SH NAME +xmessage \- display a message or query in a window (X-based /bin/echo) +.SH SYNOPSIS +.B xmessage +[ +.B \-buttons +.I label1\fR[\fP\fB:\fPvalue1\fR]\fP\fB,\fPlabel2\fR[\fP\fB:\fPvalue2\fR]\fP\fB,\fP +\&\|.\|.\|. +] [ +.I options +] +.B \-file +.I filename +.br +.B xmessage +[ +.B \-buttons +.I label1\fR[\fP\fB:\fPvalue1\fR]\fP\fB,\fPlabel2\fR[\fP\fB:\fPvalue2\fR]\fP\fB,\fP +\&\|.\|.\|. +] [ +.I options +] +.I message +\&.\|.\|. +.SH DESCRIPTION +The +.I xmessage +program +displays a window containing a message from the command line, a file, +or standard input. +Along the lower edge of the message is row +of buttons; clicking the left mouse button +on any of these buttons will cause \fIxmessage\fP to exit. +Which button was pressed is returned in the exit status and, +optionally, by writing the label of the button to standard output. +.PP +The program +is typically used by shell scripts to display information to the user +or to ask the user to make a choice. +.PP +Unless a size is specified, \fIxmessage\fP +sizes itself to fit the message, up to a maximum size. +If the message is too big for the window, \fIxmessage\fP will display +scroll bars. +.SH OPTIONS +These are the command line options that \fIxmessage\fP understands, in addition +to the standard ones listed in +.BR X (__miscmansuffix__). +.TP 8 +.B \-buttons \fIbutton,button,.\|.\|.\fP +This option will cause \fIxmessage\fP to create one button for each +comma-separated \fIbutton\fP argument. +The corresponding resource is \fBbuttons\fP. +Each \fIbutton\fP consists of a label optionally followed by a colon +and an exit value. +The label is the name of the Command button widget created and will be the +default text displayed to the user. Since this is the name of the widget +it may be used to change any of the resources associated with that button. +The exit value will be returned by \fIxmessage\fP +if that button is selected. The default exit value is 100 plus the +button number. Buttons are numbered from the left starting with one. +The default string if no \fB\-buttons\fP option is given is \fBokay:0\fP. +.TP 8 +.B \-default \fIlabel\fP +Defines the button with a matching \fIlabel\fP to be the default. +If not specified there is no default. +The corresponding resource is \fBdefaultButton\fP. +Pressing Return anywhere in the \fIxmessage\fP window will activate +the default button. +The default button has a wider border than the others. +.TP 8 +.B \-file \fIfilename\fP +File to display. +The corresponding resource is \fBfile\fP. +A \fIfilename\fP of `\fB\-\fP' reads from standard input. +If this option is not supplied, \fIxmessage\fP will +display all non-option arguments in the style of \fIecho\fP. +Either \fB\-file\fP or a message on the command line +should be provided, but not both. +.TP 8 +.B \-print +This will cause the program to write the label of the button pressed to +standard output. Equivalent to setting the \fBprintValue\fP resource +to TRUE. +This is one way to get feedback as to which button was pressed. +.TP 8 +.B \-center +Pop up the window at the center of the screen. +Equivalent to setting the \fBcenter\fP resource to TRUE. +.TP 8 +.B \-nearmouse +Pop up the window near the mouse cursor. +Equivalent to setting the \fBnearMouse\fP resource to TRUE. +.TP 8 +.B \-timeout \fIsecs\fP +Exit with status 0 after \fIsecs\fP seconds if the user has not +clicked on a button yet. +The corresponding resource is \fBtimeout\fP. +.SH "WIDGET HIERARCHY" +Knowing the name and position in the hierarchy of each widget is +useful when specifying resources for them. In the following chart, the +class and name of each widget is given. +.LP +.nf +Xmessage (xmessage) + Form form + Text message + Command (label1) + Command (label2) + . + . + . +.fi +.SH RESOURCES +The program has a few top-level application resources that allow +customizations that are specific to \fIxmessage\fP. +.TP 8 +.B file +A String specifying the file to display. +.TP 8 +.B buttons +A String specifying the buttons to display. +See the \fB\-buttons\fP command-line option. +.TP 8 +.B defaultButton +A String specifying a default button by label. +.TP 8 +.B printValue +A Boolean value specifying whether the label of the +button pressed to exit the program is written to standard output. +The default is FALSE. +.TP 8 +.B center +A Boolean value specifying whether to pop up the window at the center +of the screen. The default is FALSE. +.TP 8 +.B nearMouse +A Boolean value specifying whether to pop up the window near the mouse +cursor. The default is FALSE. +.TP 8 +.B timeout +The number of seconds after which to exit with +status 0. The default is 0, which means never time out. +.TP 8 +.B "maxHeight (\fPclass\fB Maximum) +The maximum height of the text part of the window in pixels, +used if no size was specified in the geometry. +The default is 0, which means use 70% of the height of the screen. +.TP 8 +.B "maxWidth (\fPclass\fB Maximum) +The maximum width of the text part of the window in pixels, +used if no size was specified in the geometry. +The default is 0, which means use 70% of the width of the screen. +.SH ACTIONS +.TP 8 +.B exit(\fIvalue\fP) +exit immediately with an exit status of \fIvalue\fP (default 0). This +action can be used with translations to provide alternate ways of +exiting \fIxmessage\fP. +.TP 8 +.B default-exit() +exit immediately with the exit status specified by the default button. +If there is no default button, this action has no effect. +.SH "EXIT STATUS" +If it detects an error, \fIxmessage\fP returns 1, so this value should +not be used with a button. +.SH "SEE ALSO" +.IR X (__miscmansuffix__), +.IR echo (__appmansuffix__), +.IR cat (__appmansuffix__) +.br +.SH AUTHORS +Chris Peterson, MIT Project Athena +.br +Stephen Gildea, X Consortium diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' --exclude Makefile.in --exclude configure --exclude config.guess --exclude '*.pot' --exclude mkinstalldirs --exclude aclocal.m4 --exclude config.sub --exclude depcomp --exclude install-sh --exclude ltmain.sh old/xmessage-1.0.3/xmessage.man new/xmessage-1.0.4/xmessage.man --- old/xmessage-1.0.3/xmessage.man 2009-10-16 23:39:49.000000000 +0200 +++ new/xmessage-1.0.4/xmessage.man 1970-01-01 01:00:00.000000000 +0100 @@ -1,178 +0,0 @@ -.\" $XConsortium: xmessage.man,v 1.8 95/03/08 22:28:48 gildea Exp $ -.\" -.\" $XFree86$ -.\" -.TH XMESSAGE 1 __xorgversion__ -.SH NAME -xmessage \- display a message or query in a window (X-based /bin/echo) -.SH SYNOPSIS -.B xmessage -[ -.B \-buttons -.I label1\fR[\fP\fB:\fPvalue1\fR]\fP\fB,\fPlabel2\fR[\fP\fB:\fPvalue2\fR]\fP\fB,\fP -\&\|.\|.\|. -] [ -.I options -] -.B \-file -.I filename -.br -.B xmessage -[ -.B \-buttons -.I label1\fR[\fP\fB:\fPvalue1\fR]\fP\fB,\fPlabel2\fR[\fP\fB:\fPvalue2\fR]\fP\fB,\fP -\&\|.\|.\|. -] [ -.I options -] -.I message -\&.\|.\|. -.SH DESCRIPTION -The -.I xmessage -program -displays a window containing a message from the command line, a file, -or standard input. -Along the lower edge of the message is row -of buttons; clicking the left mouse button -on any of these buttons will cause \fIxmessage\fP to exit. -Which button was pressed is returned in the exit status and, -optionally, by writing the label of the button to standard output. -.PP -The program -is typically used by shell scripts to display information to the user -or to ask the user to make a choice. -.PP -Unless a size is specified, \fIxmessage\fP -sizes itself to fit the message, up to a maximum size. -If the message is too big for the window, \fIxmessage\fP will display -scroll bars. -.SH OPTIONS -These are the command line options that \fIxmessage\fP understands. -.TP 8 -.B \-buttons \fIbutton,button,.\|.\|.\fP -This option will cause \fIxmessage\fP to create one button for each -comma-separated \fIbutton\fP argument. -The corresponding resource is \fBbuttons\fP. -Each \fIbutton\fP consists of a label optionally followed by a colon -and an exit value. -The label is the name of the Command button widget created and will be the -default text displayed to the user. Since this is the name of the widget -it may be used to change any of the resources associated with that button. -The exit value will be returned by \fIxmessage\fP -if that button is selected. The default exit value is 100 plus the -button number. Buttons are numbered from the left starting with one. -The default string if no \fB\-buttons\fP option is given is \fBokay:0\fP. -.TP 8 -.B \-default \fIlabel\fP -Defines the button with a matching \fIlabel\fP to be the default. -If not specified there is no default. -The corresponding resource is \fBdefaultButton\fP. -Pressing Return anywhere in the \fIxmessage\fP window will activate -the default button. -The default button has a wider border than the others. -.TP 8 -.B \-file \fIfilename\fP -File to display. -The corresponding resource is \fBfile\fP. -A \fIfilename\fP of `\fB\-\fP' reads from standard input. -If this option is not supplied, \fIxmessage\fP will -display all non-option arguments in the style of \fIecho\fP. -Either \fB\-file\fP or a message on the command line -should be provided, but not both. -.TP 8 -.B \-print -This will cause the program to write the label of the button pressed to -standard output. Equivalent to setting the \fBprintValue\fP resource -to TRUE. -This is one way to get feedback as to which button was pressed. -.TP 8 -.B \-center -Pop up the window at the center of the screen. -Equivalent to setting the \fBcenter\fP resource to TRUE. -.TP 8 -.B \-nearmouse -Pop up the window near the mouse cursor. -Equivalent to setting the \fBnearMouse\fP resource to TRUE. -.TP 8 -.B \-timeout \fIsecs\fP -Exit with status 0 after \fIsecs\fP seconds if the user has not -clicked on a button yet. -The corresponding resource is \fBtimeout\fP. -.SH "WIDGET HIERARCHY" -Knowing the name and position in the hierarchy of each widget is -useful when specifying resources for them. In the following chart, the -class and name of each widget is given. -.LP -.nf -Xmessage (xmessage) - Form form - Text message - Command (label1) - Command (label2) - . - . - . -.fi -.SH RESOURCES -The program has a few top-level application resources that allow -customizations that are specific to \fIxmessage\fP. -.TP 8 -.B file -A String specifying the file to display. -.TP 8 -.B buttons -A String specifying the buttons to display. -See the \fB\-buttons\fP command-line option. -.TP 8 -.B defaultButton -A String specifying a default button by label. -.TP 8 -.B printValue -A Boolean value specifying whether the label of the -button pressed to exit the program is written to standard output. -The default is FALSE. -.TP 8 -.B center -A Boolean value specifying whether to pop up the window at the center -of the screen. The default is FALSE. -.TP 8 -.B nearMouse -A Boolean value specifying whether to pop up the window near the mouse -cursor. The default is FALSE. -.TP 8 -.B timeout -The number of seconds after which to exit with -status 0. The default is 0, which means never time out. -.TP 8 -.B "maxHeight (\fPclass\fB Maximum) -The maximum height of the text part of the window in pixels, -used if no size was specified in the geometry. -The default is 0, which means use 70% of the height of the screen. -.TP 8 -.B "maxWidth (\fPclass\fB Maximum) -The maximum width of the text part of the window in pixels, -used if no size was specified in the geometry. -The default is 0, which means use 70% of the width of the screen. -.SH ACTIONS -.TP 8 -.B exit(\fIvalue\fP) -exit immediately with an exit status of \fIvalue\fP (default 0). This -action can be used with translations to provide alternate ways of -exiting \fIxmessage\fP. -.TP 8 -.B default-exit() -exit immediately with the exit status specified by the default button. -If there is no default button, this action has no effect. -.SH "EXIT STATUS" -If it detects an error, \fIxmessage\fP returns 1, so this value should -not be used with a button. -.SH "SEE ALSO" -.IR X (__miscmansuffix__), -.IR echo (1), -.IR cat (1) -.br -.SH AUTHORS -Chris Peterson, MIT Project Athena -.br -Stephen Gildea, X Consortium -- To unsubscribe, e-mail: opensuse-commit+unsubscr...@opensuse.org For additional commands, e-mail: opensuse-commit+h...@opensuse.org