home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: InfoMgt / InfoMgt.zip / cal29a.zip / readme.cal < prev    next >
Text File  |  1993-07-24  |  5KB  |  131 lines
  1. CAL is a nicely-enhanced version of the unix `cal' command for MSDOS.
  2. Features:
  3.  
  4.  * Hilights today's date when displaying a monthly calendar.
  5.  
  6.  * Displays an optional user-definable list of `special day'
  7.    descriptions (like appointments) to the right of the monthly
  8.    calendar display.  Cal can be set optionally to ignore appointments
  9.    older than the current day.  Next month's appointments may also be
  10.    shown if there is room to do so.  Multiple appointment data files may
  11.    also be specified on the commandline.
  12.    
  13.  * You can specify your own appointment and color definition files on the
  14.    commandline, or use the defaults.
  15.  
  16.  * Completely configurable colors -- eight separate color attributes.
  17.  
  18.  * No ANSI driver needed for colors, and the output may be redirected
  19.    anywhere, just like the unix version.
  20.  
  21.  * Commandline-compatible with unix `cal' command, but with several
  22.    enhanced switch settings.
  23.  
  24.  * Source code included; enhanced to compile using colors under OS/2.
  25.  
  26. The executable distributed in the archive was compiled using Zortech C++
  27. 3.1, and compressed with LZEXE.
  28.  
  29. This archived collection of files is placed into the Public Domain.
  30. Feel free to redistribute the this archive, but PLEASE make sure the
  31. archive contains all the original files, namely:
  32.  
  33.         readme.cal        - this file
  34.         cal.exe           - the MSDOS executable program
  35.         cal.doc           - documentation for cal.exe
  36.         cal.dat           - optional sample data file of appointment dates
  37.         cal.col           - optional sample file of color attributes
  38.         source\readme.os2 - some notes about compiling the source for OS/2
  39.         source\cal.c      - source code for cal
  40.         source\getopt.c   - GNU getopt() support
  41.         source\getopt.h   - header for getopt
  42.         source\copying    - GNU general public license
  43.        
  44. Note:  _I_ think the colors defined in the color definition file
  45. cal.col are ugly!  If you want to use the more attractive (in my
  46. opinion) default colors, just delete or rename cal.col.  This file
  47. is only included to show you how it works.
  48.  
  49. The source code should be compilable for any OS.  No guarantees are made
  50. in this regard, however.
  51.  
  52. Requests, bug reports, suggestions, donations, proposals for
  53. contract work, and so forth may be sent to:
  54.  
  55.         Attn: Alex Matulich
  56.         Unicorn Research Corporation
  57.         4621 N. Landmark Drive
  58.         Orlando, FL 32817-1235
  59.         USA
  60.         407-657-4974  FAX 407-657-6149
  61.  
  62. or send e-mail to alex@bilver.oau.org (alex%bilver@peora.sdc.ccur.com).
  63.  
  64.  
  65. Version history:
  66.  
  67. 1.0
  68. Port to MSDOS of original unix-to-Amiga port by Gary L. Brant.
  69.  
  70. 2.0
  71. Modified to display calendar in colors without ANSI.SYS, while retaining
  72. output redirectability.  Added current day indicator in monthly display.
  73. Made all code compatible with unix and ANSI C by putting all MSDOS-specific
  74. code into blocks activated by #define MSDOS at beginning of source file.
  75.  
  76. 2.1
  77. Added display of special date descriptions to monthly calendar.  Re-wrote
  78. some code sections to accommodate this feature.  All arrays are now
  79. dynamic to reduce the size of the executable.
  80.  
  81. 2.2
  82. Fixed an intermittent pointer-trashing bug in the date description section
  83. that caused the monthly display to display garbage at times.
  84.  
  85. 2.3
  86. Removed hardcoded color settings, and added capability to read external
  87. color file.
  88.  
  89. 2.4
  90. Added -d switch to inhibit the display of outdated date descriptions
  91. (changed to --f in version 2.7).
  92.  
  93. 2.5
  94. Fixed two bugs reported by J"urgen Koslowski.  The "last weekday of month"
  95. function in the cal.dat file now works, and the single-month display now
  96. looks fine if the year doesn't have 4 digits.  Also re-wrote the section
  97. that processes command-line arguments.
  98.  
  99. 2.6
  100. Fixed a bug reported by Paul Beam.  Date descriptions longer than 50
  101. characters now do not blank out the next line in the calendar.
  102.  
  103. 2.7
  104. Other contributors added improved commandline switches, allowing the
  105. appointment file and color file to be specified on the commandline, and
  106. also the ability to display next month's appointments on the current
  107. month if there is room to do so.  Processing of commandline arguments
  108. has been completely replaced by the GNU getopt.c library functions.  The
  109. source will now use colors if compiled under OS/2, also, and search PATH
  110. and DPATH for data files.  A potentially serious bug pertaining to path
  111. concatenation was caught.
  112.  
  113. 2.8
  114. Added --europe switch, so that the calendar display has Monday as the
  115. first day of the week, which is a more familiar format in Europe.
  116.  
  117. 2.9
  118. A contributor sent code with several fine modifications, but it was useful
  119. only for the Borland compiler.  I have re-done it for ANSI compatibility.
  120. The maximum number of appointments to be displayed now defaults to 24, and
  121. is adjustable on the commandline.  Multiple data files may be specified.
  122. Cal no longer stops reading a data file when it has filled up its maximum
  123. number of descriptions; it now reads through the whole file so that it can
  124. sort out all dates to be displayed.
  125.  
  126. 2.9a
  127. Fixed a bug in 2.8 and 2.9 that caused cal to attempt to read its color
  128. file before determining its home directory.  Also added a contributor's
  129. suggestion to detect the number of columns for MSDOS displays wider than 
  130. 80 columns, so that appointments won't be truncated if they really can fit.
  131.