ZBROWSER(1)

NAME
zbrowser - manage Zephyr WindowGrams with a summary box

SYNOPSIS
zbrowser [X Toolkit arguments]

DESCRIPTION
zbrowser is an X Toolkit application to supplement the zwgc program. It is in the prototype stage now.

The browser consists of a Viewport widget, with a scrollbar on the left hand side always on. The body of the widget is a form across the top with control buttons and a box widget below it which contains WindowGram summary lines (see zwgc(1)).

While the zbrowser is running, any messages that arrive cause summary lines to appear in the body of the browser. These summary lines are command button labels, and can be clicked on. Clicking on a summary line selects it (note that highlighting of selections is not yet implemented.) Once a message is selected, one of the control buttons can be pressed. The buttons are:

delete
    Sends a mouse click to that WindowGram, causing it to delete itself.

unmap
    Unmaps the WindowGram, so that it is not visible on the screen though still visible in the browser.

map Maps the WindowGram, if it was unmapped (has no effect if it is already mapped.)

quit
    Exits the zbrowser. Use with care, as it is difficult to retrieve any windowgrams that have been unmapped.

When starting the browser, currently the easiest way to get a reasonable screen position is to left click the mouse to pop up the message (thus creating a browser the size of the control box) and then grabbing it in the middle of the bottom and resizing downwards.

zbrowser gets the summary information directly from the ZEPHYR_SUMMARY Atom which every WindowGram window has in it. If this Atom is empty or missing, the browser creates an empty label. Any window with the name "Zwgc" is assumed to be a WindowGram.

X DEFAULTS
zbrowser supports everything available by default from these widget types. This allows a large amount of customization; see xmh(1) for more details, as it has a similar set of functions.

BUGS
It uses the X Toolkit, which at this stage is somewhat unstable; the scrollbar is there because of the custom version of the Viewport widget used.

Quit doesn't remap everything that was unmapped.

Starting up the program should have it search out and incorporate all outstanding WindowGrams. This will be in the next version.

This version dumps a large amount of debugging information to standard output during a normal run. The only way to turn it off currently is to invoke the browser as
	zbrowser > /dev/null

SEE ALSO
zephyr(1), zwgc(1), xrdb(1), xmh(1)
Project Athena Technical Plan Section E.4.1, `Zephyr Notification Service'

AUTHOR

Mark W. Eichin (MIT-Project Athena) <eichin@athena.mit.edu>

RESTRICTIONS
Copyright (c) 1987,1988 by the Massachusetts Institute of Technology. All Rights Reserved.
zephyr(1) specifies the terms and conditions for redistribution.