NAME

viewres - graphical class browser for Xt

 

SYNOPSIS

viewres [-option ...]

 

DESCRIPTION

The viewres program displays a tree showing the widget class hierarchy of the Athena Widget Set. Each node in the tree can be expanded to show the resources that the corresponding class adds (i.e. does not inherit from its parent) when a widget is created. This application allows the user to visually examine the structure and inherited resources for the Athena Widget Set.

 

OPTIONS

Viewres accepts all of the standard toolkit command line options as well as the following:

 

- top name

This option specifies the name of the highest widget in the hierarchy to display. This is typically used to limit the display to a subset of the tree. The default is Object.

 

- variable

This option indicates that the widget variable names (as declared in header files) should be displayed in the nodes rather than the widget class name. This is sometimes useful to distinguish widget classes that share the same name (such as Text).

 

- vertical

This option indicates that the tree should be displayed top to bottom rather left to right.

 

VIEW MENU

The way in which the tree is displayed may be changed through the entries in the View menu:

 

Show Variable Names

This entry causes the node labels to be set to the variable names used to declare the corresponding widget class. This operation may also be performed with the SetLabelType(variable) translation.

 

Show Class Names

This entry causes the node labels to be set to the class names used when specifying resources. This operation may also be performed with the SetLabelType(class) translation.

 

Layout Horizontal

This entry causes the tree to be laid out from left to right. This operation may also be performed with the SetOrientation(West) translation.

 

Layout Vertical

This entry causes the tree to be laid out from top to bottom. This operation may also be performed with the SetOrientation(North) translation.

 

Show Resource Boxes

This entry expands the selected nodes (see next section) to show the new widget and constraint resources. This operation may also be performed with the Resources(on) translation.

 

Hide Resource Boxes

This entry removes the resource displays from the selected nodes (usually to conserve space). This operation may also be performed with the Resources(off) translation.

SELECT MENU

Resources for a single widget class can be displayed by clicking Button2 on the corresponding node, or by adding the node to the selection list with Button1 and using the Show Resource Boxes entry in the View menu.

 

Since Button1 actually toggles the selection state of a node, clicking on a selected node will cause it to be removed from the selected list.

 

Collections of nodes may also be selected through the various entries in the Select menu:

 

Unselect All

This entry removes all nodes from the selection list. This operation may also be performed with the Select(nothing) translation.

 

Select All

This entry adds all nodes to the selection list. This operation may also be performed with the Select(all) translation.

 

Invert All

This entry adds unselected nodes to, and removes selected nodes from, the selection list. This operation may also be performed with the Select(invert) translation.

 

Select Parent

This entry selects the immediate parents of all selected nodes. This operation may also be performed with the Select(parent) translation.

 

Select Ancestors

This entry recursively selects all parents of all selected nodes. This operation may also be performed with the Select(ancestors) translation.

 

Select Children

This entry selects the immediate children of all selected nodes. This operation may also be performed with the Select(children) translation.

 

Select Descendants

This entry recursively selects all children of all selected nodes. This operation may also be performed with the Select(descendants) translation.

 

Select Has Resources

This entry selects all nodes that add new resources (regular or constraint) to their corresponding widget classes. This operation may also be performed with the Select(resources) translation.

 

Select Shown Resource Boxes

This entry selects all nodes whose resource boxes are currently expanded (usually so that they can be closed with Hide Resource Boxes). This operation may also be performed with the Select(shown) translation.

 

ACTIONS

The following application actions are provided:

 

Quit( )

This action causes viewres to exit.

 

SetLabelType(type)

This action sets the node labels to display the widget variable or class names, according to the argument type.

 

SetOrientation (direction)

This action sets the root of the tree to be one of the following areas of the window: West, North, East, or South.

 

Select(what)

This action selects the indicated nodes, as described in the VIEW MENU section: nothing (unselects all nodes), invert, parent, ancestors, children,descendants, resources, shown.

 

Resources(op)

This action turns on, off, or toggles the resource boxes for the selected nodes. If invoked from within one of the nodes (through the keyboard or pointer), only that node is used.

WIDGET HIERARCHY

Resources may be specified for the following widgets:

Viewres viewres

Paned pane

Box buttonbox

Command quit

MenuButton view

SimpleMenu viewMenu

SmeBSB layoutHorizontal

SmeBSB layoutVertical

SmeLine linel

SmeBSB namesVariable

SmeBSB namesClass

SmeLine line2

SmeBSB viewResources

SmeBSB viewNoResources

MenuButton select

SimpleMenu selectMenu

SmeBSB unselect

SmeBSB selectAll

SmeBSB selectInvert

SmeLine line1

SmeBSB selectParent

SmeBSB selectAncestors

SmeBSB selectChildren

SmeBSB selectDescendants

SmeLine line2

SmeBSB selectHasResources

SmeBSB selectShownResources

Form treeform

Porthole porthole

Tree tree

Box variable-name

Toggle variable-name

List variable-name

Panner panner

where variable-name is the widget variable name of each node.

 

SEE ALSO

X(1), xrdb(1), listres(1), editres(1),appres(1), appropriate widget documents

 

COPYRIGHT

Copyright © 1990, X Consortium

See X(1) for the full statement of rights and permissions.

 

AUTHOR

Jim Fulton Fulton, MIT X Consortium

NAME

xauth - X authority file utility

 

SYNOPSIS

xauth [ -f authfile ] [ - vqib ] [ command arg ... ]

 

DESCRIPTION

The xauth program is used to edit and display the authorization information used in connecting to the X server. This program is usually used to extract authorization records from one machine and merge them in on another (as is the case when using remote logins or granting access to other users). Commands (described below) may be entered interactively, on the xauth command line, or in scripts. Note that this program does not contact the X server. Normally xauth is not used to create the authority file entry in the first place; xdm does that.

 

OPTIONS

The following options may be used with xauth. They may be given individually (e.g., - q - i) or may combined (e.g., - qi).

- f authfile

This option specifies the name of the authority file to use. By default, xauth will use the file specified by the XAUTHORITY environment variable or .Xauthority in the user's home directory.

- q	This option indicates that xauth should operate quietly and not print unsolicited status messages. This is the default if an xauth command is given on the command line or if the standard output is not directed to a terminal.

- v

This option indicates that xauth should operate verbosely and print status messages indicating the results of various operations (e.g., how many records have been read in or written out). This is the default if xauth is reading commands from its standard input and its standard output is directed to a terminal.

- i	This option indicates that xauth should ignore any authority file locks. Normally, xauth will refuse to read or edit any authority files that have been locked by other programs (usually xdm or another xauth).

- b	This option indicates that xauth should attempt to break any authority file locks before proceeding. Use this option only to clean up stale locks.

 

COMMANDS

The following commands may be used to manipulate authority files:

 

add displayname protocolname hexkey

An authorization entry for the indicated display using the given protocol and key data is added to the authorization file. The data is specified as an even-lengthed string of hexadecimal digits, each pair representing one octet. The first digit of each pair gives the most significant 4 bits of the octet, and the second digit of the pair gives the least significant 4 bits. For example, a 32 character hexkey would represent a 128-bit value. A protocol name consisting of just a single period is treated as an abbreviation for MIT-MAGIC-COOKIE-1.

 

[n]extract filename displayname...

Authorization entries for each of the specified displays are written to the indicated file. If the nextract command is used, the entries are written in a numeric format suitable for non-binary transmission (such as secure electronic mail). The extracted entries can be read back in using the merge and nmerge commands. If the filename consists of just a single dash, the entries will be written to the standard output.

 

[n]list [displayname...]

Authorization entries for each of the specified displays (or all if no displays are named) are printed on the standard output. If the nlist command is used, entries will be shown in the numeric format used by the nextract command; otherwise, they are shown in a textual format. Key data is always displayed in the hexadecimal format given in the description of the add command.

 

[n]merge [filename...]

Authorization entries are read from the specified files and are merged into the authorization database, superceding any matching existing entries. If the nmerge command is used, the numeric format given in the description of the extract command is used. If a filename consists of just a single dash, the standard input will be read if it hasn't been read before.

 

remove displayname...

Authorization entries matching the specified displays are removed from the authority file.

 

source filename

The specified file is treated as a script containing xauth commands to execute. Blank lines and lines beginning with a sharp sign ( # ) are ignored. A single dash may be used to indicate the standard input, if it hasn't already been read.

 

into

Information describing the authorization file, whether or not any changes have been made, and from where xauth commands are being read is printed on the standard output.

 

exit

If any modifications have been made, the authority file is written out (if allowed), and the program exits. An end of file is treated as an implicit exit command.

 

quit

The program exits, ignoring any modifications. This may also be accomplished by pressing the interrupt character.

 

help [string]

A description of all commands that begin with the given string (or all commands if no string is given) is printed on the standard output.

 

?

A short list of the valid commands is printed on the standard output.

DISPLAY NAMES

Display names for the add, [n]extract, [n]list, [n]merge, and remove commands use the same format as the DISPLAY environment variable and the common - display command line argument. Display specific information (such as the screen number) is unnecessary and will be ignored. Same-machine connections (such as local-host sockets, shared memory, and the Internet Protocol hostname localhost) are referred to as hostname/unix:displaynumber so that local entries for different machines may be stored in one authority file.

 

EXAMPLE

The most common use for xauth is to extract the entry for the current display, copy it to another machine, and merge it into the user's authority file on the remote machine:

% xauth extract - $DISPLAY | rsh otherhost xauth merge -

 

ENVIRONMENT

This xauth program uses the following environment variables:

XAUTHORITY

to get the name of the authority file to use if the - f option isn't used.

HOME

to get the user's home directory if XAUTHORITY isn't defined.

 

FILES

$HOME|.Xauthority

default authority file if XAUTHORITY isn't defined.

 

BUGS

Users that have unsecured networks should take care to use encrypted file transfer mechanisms to copy authorization entries between machines. Similarly, the MIT-MAGIC-COOKIE-1 protocol is not very useful in unsecure environments. Sites that are interested in additional security may need to use encrypted authorization mechanisms such as Kerberos.

Spaces are currently not allowed in the protocol name. Quoting could be added for the truly perverse.

 

AUTHOR

Jim Fulton, MIT X Consortium

NAME

xbiff - mailbox flag for X

 

SYNOPSIS

xbiff [ - toolkitoption ... ] [ - option ... ]

 

DESCRIPTION

The xbiff program displays a little image of a mailbox. When there is no mail, the flag on the mailbox is down. When mail arrives, the flag goes up and the mailbox beeps. By default, pressing any mouse button in the image forces xbiff to remember the current size of the mail file as being the "empty" size and to lower the flag.

 

OPTIONS

Xbiff accepts all of the standard X Toolkit command line options along with the additional options listed below:

 

- help

This option indicates that a brief summary of the allowed options should be printed on the standard error.

 

- update seconds

This option specifies the frequency in seconds at which xbiff should update its display. If the mailbox is obscured and then exposed, it will be updated immediately. The default is 30 seconds.

 

- file filename

This option specifies the name of the file which should be monitored. By default, it watches /usr/spool/mail/username, where username is your login name.

 

- volume percentage

This option specifies how loud the bell should be rung when new mail comes in.

 

- shape

This option indicates that the mailbox window should be shaped if masks for the empty or full images are given.

The following standard X Toolkit command line arguments are commonly used with xbiff:

 

- display display

This option specifies the X server to contact.

 

- geometry geometry

This option specifies the preferred size and position of the mailbox window. The mailbox is 48 pixels wide and 48 pixels high and will be centered in the window.

 

- bg color

This option specifies the color to use for the background of the window.

 

- bd color

This option specifies the color to use for the border of the window.

 

- bw number

This option specifies the width in pixels of the border surrounding the window.

 

- fg color

This option specifies the color to use for the foreground of the window.

 

- rv

This option indicates that reverse video should be simulated by swapping the foreground and background colors.

 

- xrm resourcestring

This option specifies a resource string to be used. This is especially useful for setting resources that do not have separate command line options.

X DEFAULTS

The application class name is XBiff. This program uses the Mailbox widget. It understands all of the core resource names and classes as well as:

 

checkCommand (class CheckCommand)

Specifies a shell command to be executed to check for new mail rather than examining the size of file. The specified string value is used as the argument to a system(3) call and may therefore contain i/o redirection. An exit status of 0 indicates that new mail is waiting, 1 indicates that there has been no change in size, and 2 indicates that the mail has been cleared. By default, no shell command is provided.

 

file (class File)

Specifies the name of the file to monitor. The default is to watch /usr/spool/mail/username, where username is your login name.

 

onceOnly (class Boolean)

Specifies that the bell is only rung the first time new mail is found and is not rung again until at least one interval has passed with no mail waiting. The window will continue to indicate the presence of new mail until it has been retrieved. The default is false.

 

width (class Width)

Specifies the width of the mailbox.

 

height (class Height)

Specifies the height of the mailbox.

 

update (class Interval)

Specifies the frequency in seconds at which the mail should be checked. The default is 30.

 

volume (class Volume)

Specifies how loud the bell should be rung. The default is 33 percent.

 

foreground (class Foreground)

Specifies the color for the foreground.

 

reverseVideo (class ReverseVideo)

Specifies that the foreground and background should be reversed.

 

flip (class Flip)

Specifies whether or not the image that is shown when mail has arrived should be inverted. The default is "true."

 

fullPixmap (class Pixmap)

Specifies a bitmap to be shown when new mail has arrived. The default is flagup.

 

emptyPixmap (class Pixmap)

Specifies a bitmap to be shown when no new mail is present. The default is flagdown.

 

shapeWindow (class ShapeWindow)

Specifies whether or not the mailbox window should be shaped to the given fullPixmapMask and emptyPixmapMask. The default is false.

 

fullPixmapM ask (class PixmapMask)

Specifies a mask for the bitmap to be shown when new mail has arrived. The default is none.

 

emptyPixmapMask (class PixmapMask)

Specifies a mask for the bitmap to be shown when no new mail is present. The default is none.

 

ACTIONS

The Mailbox widget provides the following for use in event translations:

check( )

This action causes the widget to check for new mail and display the flag appropriately.

unset( )

This action causes the widget to lower the flag until new mail comes in.

set( )

This action causes the widget to raise the flag until the user resets it.

 

The default translation is

< ButtonPress>: unset( )

 

ENVIRONMENT

DISPLAY

to get the default host and display number.

 

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

 

SEE ALSO

X(1), xrdb(1), stat(2)

 

BUGS

The mailbox bitmaps are ugly.

 

AUTHOR

Jim Fulton, MIT X Consortium

Additional hacks by Ralph Swick, DEC/MIT Project Athena

NAME

xcalc - scientific calculator for X

 

SYNOPSIS

xcale [-stipple] [-rpn] [-toolkitoption...]

 

DESCRIPTION

xcalc is a scientific calculator desktop accessory that can emulate a TI-30 or an HP-10C.

 

OPTIONS

xcalc aeeepts all of the standard toolkit command line options along with two additional options:

- stipple

This option indicates that the background of the calculator should be drawn using a stipple of the foreground and background colors. On monochrome displays improves the appearance.

- rpn

This option indicates that reverse notation should be used. In this mode the calculator will look and behave like an HP-1OC. Without this flag, it will emulate a TI-30.

 

OPERATION

Pointer Usage: Operations may be performed with pointer button 1, or in some eases, with the keyboard. Many common calculator operations have keyboard accelerators. To quit, press pointer button 3 on the AC key of the TI calculator, or the ON key of the HP calculator.

 

Calculator Key Usage (TI mode): The numbered keys, the +/- key, and the +, -, ^*, /, and = keys all do exactly what you would expect them to. It should be noted that the operators obey the standard rules of precedence. Thus, entering "3+ 4^*5=" results in "23", not "35". The parentheses can be used to override this. For example, "(1+ 2+ 3)^*(4+ 5+ 6)= " results in "6^*15= 90".

 

The entire number in the calculator display can be selected, in order to paste the result of a calculation into text.

The action procedures associated with each function are given below. These are useful if you are interested in defining a custom calculator. The action used for all digit keys is digit(n), where n is the corresponding digit, 0..9.

1/x	Replaces the number in the display with its reciprocal. The corresponding action procedure is reciprocal( ).
x^2	Squares the number in the display. The corresponding action procedure is square( ).
SQRT	Takes the square root of the number in the display. The corresponding action procedure is squareRoot( ).
CE/C	When pressed once, clears the number in the display without clearing the state of the machine. Allows you to re-enter a number if you make a mistake. Pressing it twice clears the state, also. The corresponding action procedure for TI mode is clear( ).
AC	Clears the display, the state, and the memory. Pressing it with the third pointer button turns off the calculator, in that it exits the program. The action procedure to clear the state is off( ); to quit, quit( ).
INV	Invert function. See the individual function keys for details. The corresponding action procedure is nverse( ).
sin	Computes the sine of the number in the display, as interpreted by the current DRG mode (see DRG, below). If inverted, it computes the arcsine. The corresponding action procedure is sine( ).
cos	Computes the cosine, or arccosine when inverted. The corresponding action procedure is cosine( ).
tan	Computes the tangent, or arctangent when inverted. The corresponding action procedure is tangent( ).
DRG	Changes the DRG mode, as indicated by 'DEG', 'RAD', or 'GRAD' at the bottom of the calculator "liquid crystal" display. When in 'DEG' mode, numbers in the display are taken as being degrees. In 'RAD' mode, numbers are in radians, and in 'GRAD' mode, numbers are in grads. When inverted, the DRG key has a feature of converting degrees to radians to grads and vice-versa. Example: put the calculator into 'DEG' mode, and enter "45 INVDRG". The display should now show something along the lines of ".785398", which is 45 degrees converted to radians. The corresponding action procedure is degree( ).
e	The constant 'e'. (2.7182818...). The corresponding action procedure is e( ).
EE	Used for entering exponential numbers. For example, to get "-2.3E-4" you'd enter "2 .3 + /- EE 4 + /-". The corresponding action procedure is scientific( ).
log	Calculates the log (base 10) of the number in the display. When inverted, it raises "10.0" to the number in the display. For example, entering "3 INV log" should result in "1000". The corresponding action procedure is logarithm( ).
ln	Calculates the log (base e) of the number in the display. When inverted, it raises "e" to the number in the display. For example, entering "e ln" should result in "1". The corresponding action procedure is naturalLog( ).
y^x	Raises the number on the left to the power of the number on the right. For example "2 y^x 3 = " results in "8", which is 2^3. For a further example, "(1+ 2+ 3) y^x (1+ 2) = " equals "6 y^x 3" which equals "216". The corresponding action procedure is power( ).
PI	The constant 'pi'. (3.1415927....) The corresponding action procedure is pi( ).
x!	Computes the factorial of the number in the display. The number in the display must be an integer in the range 0-500, though, depending on your math library, it might overflow long before that. The corresponding action procedure is factorial( ).
(	Left parenthesis. The corresponding action procedure for TI calculators is leftParen( ).
)	Right parenthesis. The corresponding action procedure for TI calculators is rightParen( ).
/	Division. The corresponding action procedure is divide( ).
*	Multiplication. The corresponding action procedure is multiply( ).
-	Subtraction. The corresponding action procedure is subtract( ).
+	Addition. The corresponding action procedure is add( ).
=	Perform calculation. The TI-specific action procedure is equal( ).
STO	Copies the number in the display to the memory location. The corresponding action procedure is store( ).
RCL	Copies the number from the memory location to the display. The corresponding action procedure is recall( ).
SUM	Adds the number in the display to the number in the memory location. The corresponding action procedure is sum( ).
EXC	Swaps the number in the display with the number in the memory location. The corresponding action procedure for the TI calculator is exchange( ).
+ /-	Negate; change sign. The corresponding action procedure is negate( ).
.	Decimal point. The action procedure is decimal( ).
	Calculator Key Usage (RPN mode): The number keys, CHS (change sign), +, -, *, /, and ENTR keys all do exactly what you would expect them to do. Many of the remaining keys are the same as in TI mode. The differences are detailed below. The action procedure for the ENTR key is enter( ).
<-	This is a backspace key that can be used if you make a mistake while entering a number. It will erase digits from the display. (See BUGS). Inverse backspace will clear the X register. The corresponding action procedure is back( ).
ON	Clears the display, the state, and the memory. Pressing it with the third pointer button turns off the calculator, in that it exits the program. To clear state, the action procedure is off; to quit, quit( ).
INV	Inverts the meaning of the function keys. This would be the f key on an HP calculator, but xcalc does not display multiple legends on each key. See the individual function keys for details.
10^x	Raises "10.0" to the number in the top of the stack. When inverted, it calculates the log (base 10) of the number in the display. The corresponding action procedure is tenpower( ).
e^x	Raises "e" to the number in the top of the stack. When inverted, it calculates the log (base e) of the number in the display. The action procedure is epower( ).
STO	Copies the number in the top of the stack to a memory location. There are 10 memory locations. The desired memory is specified by following this key with a digit key.
RCL	Pushes the number from the specified memory location onto the stack.
SUM	Adds the number on top of the stack to the number in the specified memory location.
x:y	Exchanges the numbers in the top two stack positions, the X and Y registers. The corresponding action procedure is XexchangeY( ).
R v	Rolls the stack downward. When inverted, it rolls the stack upward. The corresponding action procedure is roll( ).
blank	These keys were used for programming functions on the HP-1OC. Their functionality has not been duplicated in xcalc.

Finally, there are two additional action procedures: bell( ), which rings the bell; and selection( ), which performs a cut on the entire number in the calculator's "liquid crystal" display.

ACCELERATORS

Accelerators are shortcuts for entering commands. xcalc provides some sample keyboard accelerators; also users can customize accelerators. The numeric keypad accelerators provided by xcalc should be intuitively correct. The accelerators defined by xcalc on the main keyboard are given below:

TI Key	HP Key	Keyboard Accelerator	TI Function	HP Function
SQRT	SQRT	r	squareRoot( )	squareRoot( )
AC	ON	space	clear( )	clear( )
AC	<-	Delete	clear( )	back( )
AC	<-	Backspace	clear( )	back( )
AC	<-	Control-H	clear( )	back( )
AC		Clear	clear( )
AC	ON	q	quit( )	quit( )
AC	ON	Conlrol-C	quit( )	quil( )
INV	i	i	inverse( )	inverse( )
sin	s	s	sine( )	sine( )
cos	c	c	cosine( )	cosine( )
tan	t	t	tangent( )	tangent( )
DRG	DRG	d	degree( )	degree( )
e		e	e( )
ln	ln	l	naturalLog( )	naturalLog( )
y^x	y^x	^	power( )	power( )
PI	PI	p	pi( )	pi( )
x!	x!	!	factorial( )	factorial( )
(		(	leftParen( )
)		)	rightParen( )
/	/	/	divide( )	divide( )
*	*	*	multiply( )	multiply( )
-	-	-	subtract( )	subtract( )
+	+	+	add( )	add( )
=		=	equal( )
0..9	0..9	0..9	digit( )	digit( )
.	.	.	decimal( )	decimal( )
+ /-	CHS	n	negate( )	negate( )
	x:y	x		XexchangeY( )
	ENTR	Return		enter( )
	ENTR	Linefeed		enter( )

 

CUSTOMIZATION

The application class name is XCalc.

xcalc has an enormous application defaults file which specifies the position, label, and function of each key on the calculator. It also gives translations to serve as keyboard accelerators. Because these resources are not specified in the source code, you can create a customized calculator by writing a private application defaults file, using the Athena Command and Form widget resources to specify the size and position of buttons, the label for each button, and hl function of each button.

The foreground and background colors of each calculator key can be individually specified. For the TI calculator, a classical color resource specification might be:

XCalc.ti.Command.background:

gray50

XCalc.ti.Command.foreground:

white

For each of buttons 20, 25, 30, 35, and 40, specify:

XCalc.ti.button20.background:

black

XCalc.ti.button20.foreground:

white

For each of buttons 22, 23, 24, 27, 28, 29, 32, 33, 34, 37, 38, and 39:

XCalc.ti.button22.background:

white

XCalc.ti.button22.foreground:

black

WIDGET HIERARCHY

In order to specify resources, it is useful to know the hierarchy of the widgets which compose xcalc. In the notation below, indentation indicates hierarchical structure. The widget class name is given first, followed by the widget instance name.

XCalc xcalc

Form ti or hp (the name depends on the mode)

Form bevel

Form screen

Label M

Toggle LCD

Label INV

Label DEG

Label RAD

Label GRAD

Label P

Command button1

Command button2

Command button3

and so on, ...

Command button38

Command button39

Command button40

APPLICATION RESOURCES

rpn (Class Rpn) Specifies that the rpn mode should be used. The default is TI mode.

stipple (Class Stipple) Indicates that the background should be stippled. The default is "on" for monochrome displays, and "off" for color displays.

cursor (Class Cursor) The name of the symbol used to represent the pointer. The default is "hand2".

COLORS

If you would like xcalc to use its ti colors, include the following in the # ifdef COLOR section of the file you read with xrdb:

*cuslomizalion:	-color

This will cause xcalc to pick up the colors in the app-defaults color customization file:< XRoot> /lib/X11/app-defaults/XCalc-color.

 

SEE ALSO

X(1), xrdb(1), the Athena Widget Set - C Language Interface manual

 

BUGS

HP mode: A bug report claims that the sequence of keys 5, ENTER, < - should clear the display, but it doesn't.

 

COPYRIGHT

Copyright 1988, 1989, X Consortium

See X(1) for a full statement of rights and permissions.

 

AUTHORS

John Bradley, University of Pennsylvania

Mark Rosenstein, MIT Project Athena

Donna Converse, MIT X Consortium

<NAME

xcalendar - calendar with a notebook for X11

 

SYNTAX

xcalendar [month [year]]

 

DESCRIPTION

The xcalendar is a simple interactive calendar program with a notebook capability. It is built on the X Toolkit and the Athena Widgets.

If month and year are not provided on the command line they are assumed to be current.

 

INTERACTIONS

Clicking the left mouse button on a day will start a text editor. You can edit and save a text. This text will be associated with the day. You can later on read and edit this text when you open the editor for the same day. The text is saved in a file in the directory ^~/Calendar. The editor lets you also clear an entry associated with a particular day. You can also scroll through days while in the editor by clicking on the arrows on either side of the date label. If an already open day is scrolled to, an appropriate message is displayed and the editor is brought up in read only mode.

It is also possible to scroll through months in the main window by clicking on the arrows on either side of the current date label.

You can highlight all entries in a month by invoking the function countries. By default this function is called when the left mouse button is pressed in the title window (where month and a year are displayed). Pressing again the same button will unhighlight the entries.

 

MISSING FEATURES

To remove all entries in a particular month you have to use your system's commands. The naming scheme for the files makes it easy: the command "rm ^~/Calendar/xc*sepl988 " on UNIX(TM) will remove all entries from September 1988. The facility to do that from the xcalendar should be provided.

One can imagine many other useful features. For example automatic parsing of the current day entry in search for appointments to trigger alarms (reminders) at the appropriate time. Well, maybe one day...

 

RESOURCES

The resource data base lets you alter the visual appearance of the program. You can change fonts, border widths, labels, and other resources used by widgets. One use of this facility is to change names of week days and months.

Here are the names of widgets you can use to set various resources:

XCalendar

- class of the application

xcalendar

- top level pane

controls

- control panel

quitButton

- quit button

helpButton

- help button

date	- date label

calendar

- calendar pane

daynumbers

- day numbers frame

1-49	- day number buttons

daynames

- day names frame

MON,TUE,WED,THU,FRI,SAT,SUN

- day name buttons

helpWindow

- help window

bcontrols

- month buttons frame

prev	- previous month button

succ	- succeeding month button

cdate

- current date widget

dayEditor

- editor popup

editorFrame

- editor frame

editorTitle

- editor title

editor

- editor

daybuttons

- day buttons frame

prevday

- previous day button

succday

- succeeding day button

editorControls

- control panel

doneButton

- done button

saveButton

- save button

clearEntry

- clear entry button

Application specific resources:

reverseVideoMark	- if True the entries are highlighted in reverse video; default True for black and white, and False for color displays;

setMarkBackground	- if True and reverseVideoMark is False the entries are highlighted by setting background to markBackground;

markBackground	- background color for highlighting entries;

setMarkForeground	- analogous to setMarkBackground;

markForeground	- foreground color for highlighting entries;

setMarkBackground and setMarkForeground can take any combination of values.

january,february,..,december

- these resources can be used for changing names of months;

firstDay

- an integer between 1-7, indicating the day to start a week with, default: 7 (Sunday);

markOnStartup	- if True mark the entries upon startup, default: False;

helpFile

- full pathname of the xcalendar.hlp file, default: /usr/lib/X11/xcalendar.hlp;

textBufferSize

- maximum size of the text buffer in the day editor, default: 2048;

DEFAULT RESOURCE DATA BASE:

!

XCalendar*showGrip:

False

XCalendar*calendar*internalBorderWidth:

0

XCalendar*input:

True

XCalendar*resize:

False

XCalendar*resizable:

True

XCalendar.title:

XCalendar v.3.0

XCalendar.dayEditor.title:

Day Editor

XCalendar.helpWindow.title:

XCalendar Help

XCalendar*Font:	813

XCalendar*helpFile:	/usr/local/X11R5/lib/X11/xcalendar/xcalendar.hlp

XCalendar*firstDay:	7

!bitmaps

XCalendar*prev*bitmap:

/usr/local/X11R5/lib/X11/xcalendar/larrow.xbm

XCalendar*succ*bitmap:

/usr/local/X11R5/lib/X11/xcalendar/rarrow.xbm

XCalendar*prevday*bitmap:

/usr/local/X11R5/lib/X11/xcalendar/larrow.xbm

XCalendar*sucoday*bitmap:

/usr/local/X11R5/lib/X11/xcalendar/rarrow.xbm

XCalendar*helpButton*bitmap:

/usr/local/X11R5/lib/X11/xcalendar/qmark.xbm

XCalendar*quitButton*bitmap:	/usr/local/X11R5/lib/X11/xcalendar/quit.xbm

! colors

! Note:

These may cause problems using the -rv option on monochrome displays

XCalendar*Background:

lightgray

XCalendar*markBackground:

Steel Blue

XCalendar*daynames*Background:

lightgray

XCalendar*daynames.SUN*Foreground:

Red

XCalendar*daynames.SAT*Foreground:

Black

XCalendar*daynumbers*Foreground:

Black

XCalendar*daynumbers.1*Foreground:

Red

XCalendar*daynumbers.8*Foreground:

Red

XCalendar*daynumbers.15*Foreground:

Red

XCalendar*daynumbers.22*Foreground:

Red

XCalendar*daynumbers.29*Foreground:

Red

XCalendar*daynumbers.36*Foreground:

Red

XCalendar*helpButton*Background:

slategray

XCalendar*helpButton*Foreground:

White

XCalendar*quitButton*Background:

slategray

XCalendar*quitButton*Foreground:

White

XCalendar*editorTitle*Background:

lightgray

XCalendar*editorTitle*Foreground:

Black

XCalendar*editorControls*Background:

lightgray

XCalendar*editorControls*Command.Background:

slategray

XCalendar*editorControls*Command.Foreground:	White

XCalendar*setMarkBackground:

True

XCalendar*markOnStartup:	True

XCalendar.BorderWidth:

2

XCalendar*calendar.borderWidth:

1

XCalendar*borderWidth:

0

XCalendar*date*borderWidth:

0

XCalendar*date*vertDistance:	5

XCalendar*date*font:

813bold

XCalendar*daynames*font:

813bold

XCalendar*dayEditor*editorTitle*font:

813bold

XCalendar*helpWindow*editorTitle*font:	813bold

XCalendar*helpButton*vertDistance:

12

XCalendar*quitButton*vertDistance:

12

XCalendar*editorTitle*vertDistance:	5

XCalendar*editorControls*doneButton*label:

Done

XCalendar*editorControls*saveButton*label:

Save

XCalendar*editorControls*clearEntry*label:	Clear Entry

XCalendar*dayEditor*geometry:

300l50

XCalendar*helpWindow*geometry:	600350

XCalendar*doneButton*Label:

done

XCalendar*editorTitle*Label:

Help

XCalendar*helpButton*Label:

help

XCalendar*quitButton*Label:

quit

XCalendar*saveButton*Label:	save

XCalendar*bcontrols*borderWidth:

0

XCalendar*prev*highlightThickness:

0

XCalendar*succ*highlightThickness:	0

XCalendar*prevday*highlightThickness:

0

XCalendar*succday*highlightThickness:

0

XCalendar*daybuttons*borderWidth:	0

XCalendar*Scrollbar.borderWidth:

1

XCalendar*editor.scrollVertical:

whenNeeded

 

FILES

$HOME/Calendar/*

 

BUGS

Save button handler in the editor cannot detect when a text is pasted. Workaround: type something to the editor to activate save button.

 

AUTHORS

Copyright 1988 by Massachusetts Institute of Technology Roman J. Budzianowski, MIT Project Athena

Copyright 1990 by Purdue University Richard Bingle, Computer Science

Enhancements by Beth Chaney Purdue University Computer Science Department

NAME

xclipboard - X clipboard client

 

SYNOPSIS

xclipboard [ - toolkitoption... ] [ - w ] [ - nw ]

 

DESCRIPTION

The xclipboard program is used to collect and display text selections that are sent to the CLIPBOARD by other clients. It is typically used to save CLIPBOARD selections for later use. It stores each CLIPBOARD selection as a separate string, each of which can be selected. Each time CLIPBOARD is asserted by another application, xclipboard transfers the contents of that selection to a new buffer and displays it in the text window. Buffers are never automatically deleted, so you'll want to use the delete button to get rid of useless items.

Since xclipboard uses a Text Widget to display the contents of the clipboard, text sent to the CLIPBOARD may be re-selected for use in other applications. xclipboard also responds to requests for the CLIPBOARD selection from other clients by sending the entire contents of the currently displayed buffer.

An xclipboard window has the following buttons across the top:

quit	When this button is pressed, xclipboard exits.

delete

When this button is pressed, the current buffer is deleted and the next one displayed.

new	Creates a new buffer with no contents. Useful in constructing a new CLIPBOARD selection by hand.

save	Displays a File Save dialog box. Pressing the Accept button saves the currently displayed buffer to the file specified in the text field.

next	Displays the next buffer in the list.

previous

Displays the previous buffer.

 

OPTIONS

The xclipboard program accepts all of the standard X Toolkit command line options as well as the following:

- w	This option indicates that lines of text that are too long to be displayed on one line in the clipboard should wrap around to the following lines.

- nw	This option indicates that long lines of text should not wrap around. This is the default behavior.

 

WIDGETS

In order to specify resources, it is useful to know the hierarchy of the widgets which compose xclipboard. In the notation below, indentation indicates hierarchical structure. The widget class name is given first, followed by the widget instance name.

XClipboard xclipboard

Form form

Command Quit

Command delete

Command new

Command Save

Command next

Command prev

Label index

Text text

TransientShell fileDialogShell

Dialog fileDialog

Label label

Command accept

Command cancel

Text value

TransientShell failDialogShell Dialog failDialog Label label

Command continue

SENDING/RETRIEVING CLIPBOARD CONTENTS

Text is copied to the clipboard whenever a client asserts ownership of the CLIPBOARD selection. Text is copied from the clipboard whenever a client requests the contents of the CLIPBOARD selection. Examples of event bindings that a user may wish to include in a resource configuration file to use The clipboard are:

*VT100.Translations: # override

< Btn3Up>:	select-end(CLIPBOARD) n
< Btn2Up>:	insert-selection(PRIMARY,CLIPBOARD) n
< Btn2Down>:	ignore ( )

SEE ALSO

X(1), xcutsel(1), xterm(1), individual client documentation for how to make a selection and send it to the CLIPBOARD.

 

ENVIRONMENT

DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

 

FILES

< XRoot> /lib/X11/app-defaults/XClipboard - specifies required resources

 

AUTHOR

Ralph R. Swick, DEC/MIT Project Athena

Chris D. Peterson, MIT X Consortium

Keith Packard, MIT X Consortium

NAME

xclock - analog / digital clock for X

 

SYNOPSIS

xclock [ - help] [ - analog ] [ - digital ] [ - chime ] [ - hd color ] [ - hl color ] [ - update seconds ] [ - padding number ]

 

DESCRIPTION

The xclock program displays the time in analog or digital form. The time is continuously updated at a frequency which may be specified by the user.

 

OPTIONS

Xclock accepts all of the standard X Toolkit command line options along with the additional options listed below:

- help

This option indicates that a brief summary of the allowed options should be printed on the standard error.

- analog

This option indicates that a conventional 12 hour clock face with tick marks and hands should be used. This is the default.

- digital or - d

This option indicates that a 24 hour digital clock should be used.

- chime

This option indicates that the clock should chime once on the half hour and twice on the hour.

- hands color(or - hd color)

This option specifies the color of the hands on an analog clock. The default is black.

- highlight color(or - hl color)

This option specifies the color of the edges of the hands on an analog clock, and is only useful on color displays. The default is black.

- update seconds

This option specifies the frequency in seconds at which xclock should update its display. If the clock is obscured and then exposed, it will be updated immediately. A value of 30 seconds or less will enable a second hand on an analog clock. The default is 60 seconds.

- padding number

This option specifies the width in pixels of the padding between the window border and clock text or picture. The default is 10 on a digital clock and 8 on an analog clock.

 

X DEFAULTS

This program uses the Clock widget. It understands all of the core resource names and classes as well as:

width(class Width)

Specifies the width of the clock. The default for analog clocks is 164 pixels; the default for digital clocks is whatever is needed to hold the clock when displayed in the chosen font.

height (class Height)

Specifies the height of the clock. The default for analog clocks is 164 pixels; the default for digital clocks is whatever is needed to hold the clock when displayed in the chosen font.

update (class Interval)

Specifies the frequency in seconds at which the time should be redisplayed.

foreground(class Foreground)

Specifies the color for the tic marks. The default is depends on whether reverseVideo is specified. If reverseVideo is specified the default is Iwhite, otherwise the default is black.

hands(class Foreground)

Specifies the color of the insides of the clock's hands. The default is depends on whether reverseVideo is specified. If reverseVideo is specified the default is lwhite, otherwise the default is black.

highlight(class Foreground)

Specifies the color used to highlight the clock's hands. The default is depends on whether reverseVideo is specified. If reverseVideo is specified the default is lwhite, otherwise the default is black.

analog(class Boolean)

Specifies whether or not an analog clock should be used instead of a digital one. The default is True.

chlme(class Boolean)

Specifies whether or not a boll should be rung on the hour and half hour.

padding(class Margin)

Specifies the amount of internal padding in pixels to be used. The default is 8.

font(class Font)

Specifies the font to be used for the digital clock. Note that variable width fonts currently will not always display correctly.

 

WIDGETS

In order to specify resources, it is useful to know the hierarchy of the widgets which compose xclock. In the notation below, indentation indicates hierarchical structure. The widget class name is given first, followed by the widget instance name.

       XClock xclock
       Clock clock

ENVIRONMENT

DISPLAY

to get the default host and display number.

XENVIRONMENT

to get the name of a resource file that overrides the global resources stored in the RESOURCE_MANAGER property.

 

FILES

/usr/lib/X11/app-defaults/XClock - specifies required resources

 

SEE ALSO

X(1), xrdb(1), time(3C)

 

BUGS

Xclock believes the system clock.

When in digital mode, the string should be centered automatically.

 

AUTHORS

Tony Della Fera (MIT-Athena, DEC)

Dave Mankins (MIT-Athena, BBN)

Ed Moy (UC Berkeley)

NAME

xcmsdb - Device Color Characterization utility for X Color Management System

 

SYNOPSIS

xemsdb [ - query ] [ - remove ] [ - format 32|16|8 ] [ filename ]

 

DESCRIPTION

xcmsdb is used to load, query, or remove Device Color Characterization data stored in properties on the root window of the screen as specified in section 7, Device Color Characterization, of the ICCCM. Device Color Characterization data (also called the Device Profile) is an integral part of Xlib's X Color Management System (Xcms), necessary for proper conversion of color specification between deviceindependent and device-dependent forms. Xcms uses 33 matrices stored in the XDCCC_LINEAR_RGB_MATRICES property to convert color specifications between CIEXYZ and RGB Intensity (XcmsRGBi, also referred to as linear RGB). Xcms then uses display gamma information stored in the XDCCC_LINEAR_RGB_CORRECTION property to convert color specifications between RGBi and RGB device (XcmsRGB, also referred to as device RGB).

Note that Xcms allows clients to register function sets in addition to its built-in function set for CRT color monitors. Additional function sets may store their device profile information in other properties in function set specific format. This utility is unaware of these non-standard properties.

The ASCII readable contents of filename (or the standard input if no input file is given) are appropriately transformed for storage in properties, provided the - query or - remove options are not specified.

 

OPTIONS

xcmsdb program accepts the following options:

- query

This option attempts to read the XDCCC properties off the screen's root window. If successful, it transforms the data into a more readable format, then sends the data to standard out.

- remove

This option attempts to remove the XDCCC properties on the screen's root window.

- format 32|16|8

Specifies the property format (32, 16, or 8 bits per entry) for the XDCCC_LINEAR_RGB_CORRECTION property. Precision of encoded floating point values increases with the increase in bits per entry. The default is 32 bits per entry.

 

SEE ALSO

xprop(1), Xlib documentation

 

ENVIRONMENT

DISPLAY

to figure out which display and screen to use.

 

AUTHOR

Chuck Adams, Tektronix Inc. Al Tabayoyon, SynChromatics Inc. (added multi-visual support)

NAME

xcutsel - interchange between cut buffer and selection

 

SYNOPSIS

xcutsel [ -toolkitoption...] [-selection selection] [-cutbuffer number]

 

DESCRIPTION

The xcutsel program is used to copy the current selection into a cut buffer and to make a selection that contains the current contents of the cut buffer. It acts as a bridge between applications that don't support selections and those that do.

By default, xcutsel will use the selection named PRIMARY and the cut buffer CUT_BUFFER0. Either or both of these can be overridden by command line arguments or by resources.

An xcutsel window has the following buttons:

quit

When this button is pressed, xcutsel exits. Any selections held by xcutsel are automatically released.

copy PRIMARY to O

When this button is pressed, xcutsel copies the current selection into the cut buffer.

copy O to PRIMARY

When this button is pressed, xcutsel converts the current contents of the cut buffer into the selection.

The button labels reflect the selection and cutbuffer selected by command line options or through the resource database.

When the "copy 0 to PRIMARY" button is activated, the button will remain inverted as long as xcutsel remains the owner of the selection. This serves to remind you which client owns the current selection. Note that the value of the selection remains constant; if the cutbuffer is changed, you must again activate the copy button to retrieve the new value when desired.

OPTlONS

Xcutsel accepts all of the standard X Toolkit command line options as well as the following:

- selection name

This option specifies the name of the selection to use. The default is PRIMARY. The only supported abbreviations for this option are "-select", "-sel" and "-s", as the standard toolkit option "-selectionTimeout" has a similar name.

- cutbuffer number

This option specifies the cut buffer to use. The default is cut buffer 0.

 

X DEFAULTS

This program accepts all of the standard X Toolkit resource names and classes as well as:

selection (class Selection)

This resource specifies the name of the selection to use. The default is PRIMARY.

cutBuffer (class CutBuffer)

This resource specifies the number of the cut buffer to use. The default is 0.

 

WIDGET NAMES

The following instance names may be used when user configuration of the labels in them is desired:

sel-cut (class Command)

This is the "copy SELECTION to BUFFER" button.

cut-sel (class Command)

This is the "copy BUFFER to SELECTION" button.

quit (class Command)

This is the "quit" button.

 

SEE ALSO

X(1), xclipboard(1), xterm(1), text widget documentation, individual client documentation for how to make a selection.

 

BUGS

There is no way to change the name of the selection or the number of the cut buffer while the program is running.

 

AUTHOR

Ralph R. Swick, DEC/MIT Project Athena