Calindock version 1.2.0

About Calindock

Calindock is a Mac OS X dockling that displays a monthly or daily calendar in the Dock.  Calindock is currently being released as freeware!

A Word About Docklings

Docklings are small!  Completely magnified or at full size they are only 128 x 128 pixels.  That's not a lot of room for displaying something with as much info as a monthly calendar.  If you don't use the Dock's magnification feature or don't have your Dock size set somewhere near "Large" Calindock may not currently be a terribly useful dockling for you!  

Instructions

To use Calindock, either double click the "Calindock.dock" icon or simply drag the “Calindock.dock” icon to the Dock and drop it where you'd like it to appear.  By default Calindock displays the current month.  The current day will be highlighted.  Clicking the Calindock dockling will display a menu that enables you to move forward and back in time through the calendar.  You can always return to the current month by simply selecting "Current Month" from this menu.

There are a couple of other menu options.  The "Calendar Format" menu option allows you to toggle between either a monthly or daily calendar.  Use the "Week Begins" option to change the starting day for your week to either Sunday or Monday.  Note that this option and the ability to change dates are not available while using the daily calendar format.

Should the date on your computer change, Calindock updates itself to reflect the new date.  Please note that it may take a few seconds for Calindock to display the change!

System Requirements

• Mac OS X 10.0.0 or better

Version History

Version 1.2.0
• Added the option to view the calendar in a daily format 
• Localized all of Calindock for German and Japanese
• Updated to use the latest release of Brian Webster's dockling template

Version 1.1.0
• Completely rewrote Calindock from the ground up for major reliability boost
• Added the preference for beginning the week on either Sunday or Monday
• Localized everything in Calindock but the menu 
• Alleviated Calindock being "double drawn"

	Version 1.0.2
• Patched a fairly massive memory leak
• Significantly lessened the frequency of Calindock being "double drawn"

Version 1.0.1
• Fixed a pesky little bug that was causing woes for some users of Mac OS X 10.0.3

Version 1.0.0
• Initial release

Future Plans

• A custom Finder icon and a better "calendar" image would be nice.
• Country localization.  If you would like to help translate, please let me know!
• Adding the option for launching a larger free floating calendar window.
• You tell me!  What would you like to see?  See the "Feedback" section below.

Legalities

While I am heavily in favor of having Calindock reach as wide an audience as possible, there is one major restriction regarding the distribution of Calindock. Calindock may not be distributed in whole or part by any individual, entity or organization in any manner without the express written consent of:

Mike McNamara
mike@criticalmatter.com

That's a pretty harsh restriction, eh? No worries. If you have an honest interest in distributing Calindock and aren't looking to include Calindock on a for-profit shareware type CD-ROM, I'm sure that we can come to a very free arrangement.

The software and accompanying documentation are provided 'as is' without warranty of any kind. The author Mike McNamara and Critical Matter, Inc. do not warrant, guarantee or make representations regarding the use or the results of the use of the software or accompanying documentation in terms of correctness, accuracy, reliability, currentness, or otherwise. The entire risk as to the results and performance of the software is assumed by you. If the software or documentation is defective, you -- not Mike McNamara or Critical Matter, Inc. -- assume the entire cost of all necessary servicing, repair or correction. 

Bugs and Issues

	• The API's used to create this dockling are unsupported by Apple!  The next time Apple releases an update for Mac OS X, there is a chance that Calindock may not function properly.  THIS IS NOT APPLE'S FAULT OR PROBLEM!

	• If you are running Mac OS X version 10.0.4 you will likely get an error window when Calindock starts up stating that the dockling may not function properly.  THIS IS TO BE EXPECTED!  This is built in to Brian Webster's dockling template.  Any dockling created this template will show this same error window. You should only see this error once.  Until someone lets me know how to update a dockling icon in the Dock using Apple's unpublished dockling API, I will continue to use Brian's excellent dockling template.

Beta Testers

Special thanks to the following people for their time:

Roger Bond 
Frédéric Miserey
Richard Peskin

Thanks and Other Things

Much thanks and respect to the following people:

Brian Webster - who wrote the cool dockling template that enabled me to write Calindock 
Kimberly McNamara - my wife, who I love the most
JP May - who always needs a good calendar
My Family - who are the best
Norbert Rittel - for excellent German translation services
Christopher Li - for excellent Japanese translation services

URL's worth checking out:

Brian Webster's dockling article - http://www.stepwise.com/Articles/Technical/2001-03-30.01.html

Feedback

Please give me feedback!  Do you love Calindock?  Do you hate it?  Are there some features you'd like to see added?  Please drop me an email:

mike@criticalmatter.com

If you don't write, I won't know how to make Calindock better!