home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 3 / 3063 / README < prev   
Encoding:
Text File  |  1991-03-15  |  5.8 KB  |  144 lines
  1.          README for XKAL - X Appointment Calendar
  2.  
  3.         George Ferguson, ferguson@cs.rochester.edu
  4.  
  5.                  27 Feb 1990
  6.  
  7. DISCLAIMER:
  8.  
  9.      This is no longer a BETA release, but there have been drastic
  10.      changes since the original (1.0beta). No doubt the increased complexity
  11.      of the program has introduced many new bugs. While it has been in
  12.      use for some time at our site, there are certainly many bugs left to
  13.      find.
  14.  
  15.      This software is provided as is with no warranty expressed or implied.
  16.      I hope you find it useful, but I won't be held responsible for
  17.      any damage that may occur from reading, compiling, installing or
  18.      using it.
  19.  
  20.      You are free to use any part of this code for other purposes. It
  21.      would be nice if you could keep my name on some part of whatever the
  22.      final product is.
  23.  
  24.  
  25. INSTALLATION:
  26.  
  27.      1. Edit the Imakefile to reflect any changes for your site. These
  28.     include setting BINDIR, LIBDIR, and MANDIR if needed, and
  29.     checking CDEBUGFLAGS if debugging or optimization is desired.
  30.  
  31.     This program uses the EzMenu widgets, which provides a resource
  32.     manager interface to the SimpleMenuWidget. You should check the
  33.     definitions in the Imakefile to reflect your installation of
  34.     the EzMenu package. In particular, you may not need the TARGET_MACH
  35.     flag if you only intend to compile for one architecture. Note that
  36.     the version of the EzMenu widgets used with this version (1.10 and
  37.     up) of xkal is slightly changed from that originally in xtex (and in
  38.     xkal 1.0beta). It allows only commas to separate arguments to action
  39.     procedures, rather than whitespace as well, since otherwise it was
  40.     too hard to pass things.
  41.  
  42.     Compiling this program requires the "ad2c" program. You should
  43.     set the AD2C variable as required. Actually, ad2c is only required
  44.     if you change Xkal.ad and want the new defaults compiled in as
  45.     fallback resources. If you don't have ad2c, you probably want
  46.     to remove the line that adds Xkal.ad.h to the "clean" target.
  47.  
  48.     Decide if you want to use the popup alert boxes. More importantly,
  49.     decide if you can compile them. If not (ie. if the subsequent make
  50.     barfs), then comment out the ALERT* definitions and error messages
  51.     will go to stderr.
  52.  
  53.     If you don't have dysize(3) you should uncomment the relevant
  54.     definitions (DYSIZE*) to include it. This includes Ultrix and
  55.     maybe SGI systems.
  56.  
  57.     If you don't have strcasecmp(3) you should uncomment the relevant
  58.     definitions (STRCASECMP*) to include it. This includes at least
  59.     Sun386i systems.
  60.  
  61.     If you have troubles compiling "string-convert.c" due to missing
  62.     or multiple declarations of "XtCXtToolkitError" and the like, just
  63.     remove "string-convert.o" from the definitions of OBJS[123] in the
  64.     Imakefile. This will mean that you will see the message
  65.         Cannot convert string "NULL" to type Widget
  66.     on startup, but otherwise doesn't affect xkal's operation.
  67.  
  68.      2. You may want to change defaults in Xkal.ad; consult the man page for
  69.     details, and see above about ad2c.
  70.  
  71.      2. Execute
  72.         % xmkmf
  73.     to create the Makefile.
  74.  
  75.      3. Execute
  76.         % make depend
  77.     to add the dependencies to the Makefile. This is necessary to
  78.     ensure that Xkal.ad.h is created when needed.
  79.     IMPORTANT: Ignore the error message from makedepend if Xkal.ad.h
  80.            is not found; it will be created automatically.
  81.  
  82.      4. Make the package using
  83.         % make
  84.     or install it directly with
  85.         % make install install.man
  86.  
  87. HISTORY:
  88.      Unless otherwise indicated, things are listed with the person who
  89.      suggested them. These people did not write code; I get the blame for
  90.      that). Apologies if I didn't credit someone.
  91.  
  92.      Released to alt.sources (version 1.0 beta), 13 Nov 1990.
  93.  
  94.      Patched 16 Nov 1990:
  95.     Bad values in XtSetValues(), lines 169, 172, 175 "day.c"
  96.         - douglis@cs.vu.nl (Fred Douglis)
  97.         - sengillo@isdc00.kodak.com (Alan Sengillo)
  98.  
  99.      Version 1.10 made available for ftp, 27 Feb 1991. The following are
  100.     some of the changes in this version, listed with the person who
  101.     suggested them (these people did not write code; I get the blame for
  102.     that). Apologies if I didn't credit someone.
  103.     From: netmgr@venus.csc.fi (Pekka Kyt|laakso)
  104.         Customize dow and month labels and allow Monday at start of
  105.         week for European users.
  106.     From: Colin Walls <ctw@sun.central-services.umist.ac.uk>
  107.         Allow calendar format and preprocessor. Actually it will
  108.         handle almost any date spec., and provides #include.
  109.     From: several people
  110.         Ultrix defs for dysize() and don't use += if possible.
  111.     From: rackow@antares.mcs.anl.gov (Gene Rackow)
  112.         Different reminder types, like monthly and yearly. In fact,
  113.         the appointment format is considerably more flexible, with
  114.         respect to both syntax and semantics.
  115.     From: weissman%pianoforte.esd.sgi.com@SGI.COM
  116.         Fixed major grossness in selectDay()
  117.     From: mucit@cs.rochester.edu (Bulent Murtezaoglu)
  118.         Two month format and better labelling algorithm for moved
  119.         appoints.
  120.     And from me:
  121.         - System and personal files, with #include functionality
  122.         - Added appointment editor to replace schedule editor
  123.         - Added defaults editor
  124.         - Fully customizable day layout, including start and end times,
  125.           increment, number and label of notes
  126.         - Switch to "criticality levels" for appointment highlighting
  127.         - Popup error messages where appropriate (if wanted)
  128.         - "xkal-system()" action for arbitrary commands
  129.         - Automail scripts
  130.         - Programs to write in xremind and pcal formats
  131.      Version 1.11 - 1 Mar 1991
  132.     gf: Get notesLabel in non-interactive mode
  133.      Version 1.12 - 2 Mar 1991
  134.     gf: Mail tomorrow's reminders in xkal-mail and xkal-automail, rather
  135.         than today's. Duuh...
  136.      Version 1.13 - 13 Mar 1991
  137.     From: rme@olympia.net.com (Richard Emberson)
  138.         - Added notes to README concerning EzMenu changes
  139.     From: jdm5548@diamond.tamu.edu (James Darrell McCauley)
  140.         - Added notes to README concerning handling string-convert.c
  141.           problems.
  142.         - Fixed bogus ad hoc handling of am/pm, and added noonStr
  143.           and midnightStr resources
  144.