Support GNU-style long options throughout, and introduce proper help

[xtoys] / xtell.c

/* -*-c-*-
 *
 * $Id: xtell.c,v 1.2 1998/11/21 22:30:25 mdw Exp $
 *
 * Wake up a waiting xwait process
 *
 * (c) 1998 Straylight/Edgeware
 */

/*----- Licensing notice --------------------------------------------------* 
 *
 * This file is part of the Edgeware X tools collection.
 *
 * X tools is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 * 
 * X tools is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with X tools; if not, write to the Free Software Foundation,
 * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 */

/*----- Revision history --------------------------------------------------* 
 *
 * $Log: xtell.c,v $
 * Revision 1.2  1998/11/21 22:30:25  mdw
 * Support GNU-style long options throughout, and introduce proper help
 * text to all programs.  Update manual pages to match.
 *
 * Revision 1.1  1998/11/16 23:00:49  mdw
 * Initial versions.
 *
 */

/*----- Header files ------------------------------------------------------*/

#include <stdio.h>
#include <stdlib.h>
#include <string.h>

#include <X11/Xlib.h>
#include <X11/Xutil.h>

#include "mdwopt.h"
#include "quis.h"
#include "xwait.h"

/*----- Main code ---------------------------------------------------------*/

static void version(FILE *fp)
{
  fprintf(fp, "%s (xtoys version " VERSION ")\n", QUIS);
}

static void usage(FILE *fp)
{
  fprintf(fp, "Usage: %s [-d DISPLAY] [-a ATOM] [-m MSG]\n", QUIS);
}

int main(int argc, char *argv[])
{
  char *display = 0;
  Display *dpy;
  Atom xwait_die;
  char *atom = XWAIT_DIE;
  char *msg = XWAIT_DIE_MSG;

  /* --- Parse options --- */

  ego(argv[0]);

  for (;;) {
    static struct option opt[] = {
      { "help", 	0,			0,	'h' },
      { "usage", 	0,			0,	'u' },
      { "version", 	0,			0,	'v' },
      { "display", 	required_argument,	0,	'd' },
      { "atom",		required_argument,	0,	'a' },
      { "msg",		required_argument,	0,	'm' },
      {	0,		0,			0,	0 }
    };

    int i = getopt_long(argc, argv, "d:a:m:", opt, 0);
    if (i < 0)
      break;
    switch (i) {
      case 'h':
	version(stdout);
	fputs("\n", stdout);
	usage(stdout);
	fputs(
"\n"
"Signals a waiting `xwait' process.  Specifically, writes a property\n"
"named ATOM to the X root window, with value MSG.\n"
"\n"
"Options:\n"
"\n"
"-h, --help		Display this help text\n"
"-u, --usage		Display a short usage summary\n"
"-v, --version		Display the program's version number\n"
"\n"
"-d, --display=DISPLAY	Choose X display to connect to\n"
"-a, --atom=ATOM		Choose property name to set\n"
"-m, --msg=MSG		Choose value of property to set\n",
          stdout);
	exit(0);
	break;
      case 'u':
	usage(stdout);
	exit(0);
	break;
      case 'v':
	version(stdout);
	exit(0);
	break;
	
      case 'd':
	display = optarg;
	break;
      case 'a':
	atom = optarg;
	break;
      case 'm':
	msg = optarg;
	break;
      default:
	fprintf(stderr, "Usage: xtell [-d DISPLAY] [-a ATOM] [-m MSG]\n");
	exit(EXIT_FAILURE);
	break;
    }
  }

  /* --- Connect to the display --- */

  dpy = XOpenDisplay(display);
  if (!dpy) {
    fprintf(stderr, "xtell: couldn't open display\n");
    exit(EXIT_FAILURE);
  }

  /* --- Find the right atom --- */

  xwait_die = XInternAtom(dpy, atom, False);

  /* --- Set the property value --- */

  {
    XTextProperty prop;
    if (!XGetTextProperty(dpy, DefaultRootWindow(dpy), &prop, xwait_die)) {
      fprintf(stderr, "xtell: no xwait listening for `%s'\n", atom);
      exit(EXIT_FAILURE);
    }
    XStringListToTextProperty(&msg, 1, &prop);
    XSetTextProperty(dpy, DefaultRootWindow(dpy), &prop, xwait_die);
  }

  /* --- Done --- */

  XCloseDisplay(dpy);
  return (0);
}

/*----- That's all, folks -------------------------------------------------*/