Xdiary version 1.3 ================== Xdiary is an X application that displays a one month calendar or a full year calendar and/or an interactive daily diary. It can also serve as a click and point tool for printing calendars. More detailed features ---------------------- Xdiary is a simple tool for associating text with a specific date, useful for keeping a daily diary or work log. Xdiary normally operates two windows. Depending on the options, the first window shows a one month calendar or a full year calendar, while the second window displays a diary. The diary window has two panes: the upper pane displays the current day items and the bottom pane the past and next items that have been set. By clicking with the left mouse button on one of those, the current day is updated to the corresponding date. All data are stored in the user's home directory, in ~/.xdiary. By using templates, the diary entries can be configured or personalized to be suitable for a wide range of needs; the template file is by default ~/.xdiary-template; when non empty, its first line should in principle be a blank line, as it is normally used as a "title line" summarizing the day activities. See template.sample for an example showing how to set the template file. There are several printing options. One is to print a (hopefully beautiful :-) monthly or yearly calendar using a slightly enhanced version of Mark Hanson's 'pscal' utility. Pscal is a bash script producing a calendar in the form of a PostScript file, which can then be viewed with any PostScript viewer (such as ghostview, gv, ggv, etc); you should certainly have at least one of them installed on your system). Notice that pscal can also be used standalone; xdiary issues the relevant commands used during the printing events, so that users can possibly manage further pscal options that xdiary doesn't itself use. The final printing option consists of formatting a text file containing the diary items, starting from current day. The text file can then be edited and printed, e.g. with emacs. Several languages are supported. See the xdiary man page for details. Installation ------------ Xdiary is written completely in ANSI C, without any attempt to be backward compatible with K&R C compilers. To build xdiary, edit Imakefile if necessary (e.g. select or redefine the XAWLIB library as desired), then run "xmkmf" in the xdiary directory. Then type "make" to build the binary, "make install" to install binary in default X11/bin directory, "make install.man" to install the man page. Changes and credits ------------------- Xdiary was developed and tested on Harris Night Hawk 4000 and 5000 systems, running Harris' CX/RT real-time operating system. It has been tested with R6 on an NCR 3445 running NCR SVR4.0 MP (Thanks to Garry Paxinos at Metrolink). Xdiary was written by Jason Baietto (Jason.Baietto@mail.csd.harris.com). Version 1.0 originally appeared for X11 R4 in late 1990. A large part of the xdiary coding effort was devoted to the CalendarWidget in hopes that other developers might use it in their own applications. See the widget.man document for more information on using the CalendarWidget. Thanks are due to Chela Diaz de Villegas, Theresia Buesser, Joel Brogniart, Erwan David, Thilo Gramlich, Vasco Lopes Paulo, John T. McCranie and Silvio Bichisecchi for help with the multiple language support. Many thanks also to Jim Burmeister for GUI and documentation guidance. -Jason Baietto 05/09/94 Versions 2.x are strongly enhanced versions, tested with X11 R6. The interface of the diary window, especially, has been improved (double pane, week buttons...) and there is a possibility of building and printing calendars. This version is maintained by J.-P. Demailly, demailly@fourier.ujf-grenoble.fr - J.-P. Demailly 09/27/00
