Page: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
16 17



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.

Home

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.

Home

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

Home

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.

Home

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

Home

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.

Home

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

Home

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.

Home

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

Home

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

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

Home

<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;

Home

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

Home

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

Home

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)
<

Home

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)

Home

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
Home

Contents Previous Chapter Chapter 1 Cont. Next Chapter