HP-UX

NAME

xcal - display calendar in an X11 window

SYNOPSIS

xcal [ options ]

DESCRIPTION

The xcal program prints a calendar for the current month in an X11 window.  The calendar highlights the current day of the month.  At midnight the calendar redraws itself to display the new date. 

The calendar displayed is the Gregorian calendar for years after 1752 and the Julian calendar for years prior to 1752.  The displayed calendar is the same as "/usr/bin/cal" for compatibility. 

The xcal window can display the calendar for other months of any year.  When the xcal window is active, the following keyboard keys affect the calendar as follows:

The key Changes the calendar to the:

Left arrow Previous month. 

Prev Previous month. 

Right arrow Next month. 

Next Next month. 

Up arrow Same month of the next year. 

Down arrow Same month of the previous year. 

Home arrow Current month. 

Clear line Current month. 

Clear display Current month. 

The mouse may also be used to change the calendar.  Two arrows appear on the top line of the calendar.  Pressing a mouse button on the left arrow changes the calendar to the previous month.  The right arrow changes the calendar to the next month.  Press a mouse button anywhere else on the window and the calendar reverts to the current month. 

OPTIONS

-display display
Specifies the server to connect to; see X(1).

-geometry spec
Specify the size and location of the window in pixels.

-fg color
Specify the foreground (text) color.

-bg color
Specify the background color.

-fn font
Specify the font used to display the calendar.

-vSpace pixels
Specify the vertical padding of the calendar.

-hSpace pixels
Specify the horizontal padding of the calendar.

ENVIRONMENT

DISPLAY
The default host and display number.

X RESOURCES

xcal is configured from the X11 defaults files:

/usr/lib/X11/app-defaults/XCal
$HOME/.Xdefaults  or  $HOME/.vue/$DISPLAY/current/vue.resources

The app-defaults file sets up the system-wide xcal configuration.  The user’s personal $HOME/.Xdefaults modifies the behavior of xcal for the user.  If you are using the Visual User Environment (VUE), then see also the VUE CUSTOMIZATION section, below.  The rest of this section describes resources that can be customized in the .Xdefaults file. 
 
The syntax for all xcal resources is
 
XCal.<resource_name>:<resource_value>
 
For example,
XCal.hSpace:10
 
Specific resource options for the calendar are:

Font Font used for the calendar. 
(default = fixed)

Geometry Size and/or location of the window. 
(default = based on size of font)

Foreground Foreground (text) color
(default is ‘black’).

Background Background color
(default is ‘white’).

hSpace Horizontal padding of the window in pixels.  Ignored if geometry width is specified. 
(default is ‘5’).

vSpace Vertical padding of the window in pixels.  Ignored if geometry height is specified. 
(default is ‘2’).

VUE CUSTOMIZATION

If you are using the Visual User Environment (VUE) then you must let VUE know when you make changes to your .Xdefaults file.  In order for your changes to take effect, run:
 
xrdb -nocpp -merge $HOME/.Xdefaults
 
VUE automatically saves your new defaults in the file $HOME/.vue/$DISPLAY/current/vue.resources. 
 
You can also edit the vue.resources file directly.  If you do so, and want to store your changes for the next time you login, then run:
 
xrdb -load $HOME/.vue.$DISPLAY.current/vue.resources
 
 
Background Information for the X-Knowledgeable Reader
 
The X Resource Data Base (xrdb) allows users to customize the look and behavior of their applications.  The advantage of using xrdb becomes apparent in a distributed environment where a program may be running on one machine and displaying output on another machine.  This allows users to specify different defaults for the different systems they use.  The xrdb is kept on the server side (the display side), not on the client side (where the program is running).  Therefore, at run time the program can check to see what kind of display it is displaying to.
 
You can use any file (not just .Xdefaults ) to specify customizations, and then run:
 
xrdb -nocpp -merge <filename>
 
But this is not recommended, because some clients do not use xrdb. Any additions or changes of defaults should be made to both .Xdefaults and the xrdb files. 

FILES

/usr/lib/X11/app-defaults/XCal
${HOME}/.Xdefaults or $HOME/.vue/$DISPLAY/current/vue.resources

SEE ALSO

cal(1)

WARNINGS

Requires HP-UX version 6.5, and X11 version 3. 

AUTHOR

xcal was developed by HP to operate under the X Window System. 

  —  April 21, 1994