packages icon



 xcalendar(1)                   X Version 11                    xcalendar(1)
                               1 October 1991



 NAME
      xcalendar - calendar with a notebook for X11

 SYNTAX
      xcalendar [month [year]]

 DESCRIPTION
      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 upin 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
      ShowEntries. 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*sep1988  " 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 approriate 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.





                                    - 1 -      Formatted:  November 14, 2024






 xcalendar(1)                   X Version 11                    xcalendar(1)
                               1 October 1991



      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



                                    - 2 -      Formatted:  November 14, 2024






 xcalendar(1)                   X Version 11                    xcalendar(1)
                               1 October 1991



                                 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;

           calendarDir       - path name of directory to use for storing calendar
                               files instead of keeping them in $HOME/Calendar;

           oldStyle          - uses version 3.0 and prior file naming convention,
                               default: True;

           markCurrent       - if True mark the current day (if visible; color
                               displays only), default: False;

           updateCurrent     - number of seconds between attempts to update the
                               marking of the current day, default: 60;

           currentForeground - foreground color for current day highlight;


      Date Widget resources:

           monthnames        - string of '/' separated month names;

           monthnms          - string of '/' separated month abbreviations;

           daynames          - string of '/' separated day names;

           daynms            - string of '/' separated day abbreviations;

           date              - format string for date.  The formatting
                               characters that are understood are:

                    %W      Full weekday name
                    %w      Three-char weekday name
                    %M      Full month name
                    %m      Three-char abbreviation for that month
                    %d      The date (numerical day number of the month)
                    %Y      Full year (4 digits)
                    %y      2-digit year number

                               default: "%W, %M %d";



                                    - 3 -      Formatted:  November 14, 2024






 xcalendar(1)                   X Version 11                    xcalendar(1)
                               1 October 1991



 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.1
           XCalendar.dayEditor.title: Day Editor
           XCalendar.helpWindow.title: XCalendar Help
           XCalendar*Font: 8x13

           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*succday*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




                                    - 4 -      Formatted:  November 14, 2024






 xcalendar(1)                   X Version 11                    xcalendar(1)
                               1 October 1991



           XCalendar.BorderWidth:        2
           XCalendar*calendar.borderWidth:    1
           XCalendar*borderWidth: 0
           XCalendar*date*borderWidth: 0
           XCalendar*date*vertDistance: 5

           XCalendar*date*font:          8x13bold
           XCalendar*daynames*font:      8x13bold
           XCalendar*dayEditor*editorTitle*font: 8x13bold
           XCalendar*helpWindow*editorTitle*font: 8x13bold

           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: 300x150
           XCalendar*helpWindow*geometry: 600x350

           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

           !! Keyboard accelerators
           XCalendar*editorControls*doneButton*accelerators: #override       Meta<Key>q: set() notify() reset()
           XCalendar*editorControls*saveButton*accelerators: #override       Meta<Key>s: set() notify() reset()
           XCalendar*editorControls*clearEntry*accelerators: #override       Meta<Key>c: set() notify() reset()

           XCalendar*daybuttons*prevday*accelerators: #override       Meta<Key>p: set() notify() reset()
           XCalendar*daybuttons*succday*accelerators: #override       Meta<Key>n: set() notify() reset()

           XCalendar*prev*accelerators: #override       <Key>p: set() notify() reset()
           XCalendar*succ*accelerators: #override       <Key>n: set() notify() reset()
           XCalendar*quitButton*accelerators: #override       <Key>q: set() notify()




                                    - 5 -      Formatted:  November 14, 2024






 xcalendar(1)                   X Version 11                    xcalendar(1)
                               1 October 1991



 FILES
      $HOME/Calendar/*

 SEE ALSO
      xrdb(1)

 BUGS
      I'm sure there are some.

 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

      Mike Urban
      Jet Propulsion Labs, NASA

      Joel Neisen
      Minnesota Supercomputer Center

      Hiroshi Kuribayashi
      Omron Corp.


























                                    - 6 -      Formatted:  November 14, 2024