r19 - 20 Jul 2007 - 05:04:14 - JaredRhineYou are here: OSAF >  Projects Web  >  ChandlerHome > ZeroPointOneRelease > ChandlerZeroPointOneREADME

Chandler 0.1 README

<Current OSAF Thinking>

This is a version of the Chandler 0.1 README that has been slightly reformatted to take advantage of the wiki's superior presentation capabilities. The authoritative version is also available. This file might also be updated with any major bugs found after the 0.1 release.


We at OSAF are delighted that you downloaded the 0.1 release of Chandler! We hope that this release of Chandler will give you a flavor of Chandler's architecture and APIs, and a glimse of what Chandler will do in the future.

Please note that Chandler is still in its extremely early stages, with only a very limited set of capabilities.

Please also understand that many things are in flux. In particular, because our underlying database is undergoing changes, you should not store important information in Chandler yet.

REPEAT: You should not store important information in Chandler yet.

Please read the license before installing, in the file named LICENSE.txt.

For information on how to run Chandler, please see the README appropriate for your platform:


License

Chandler 0.1 Copyright (c) 2002-2003 Open Source Applications Foundation

The 0.1 version of Chandler is available under the GNU General Public License, version 2, as described in

You can also see the authoritative version of the GNU GPL.

We expect that subsequent versions of Chandler will also be available under one or more additional licenses. For more detail on our licensing plans, see the Chandler Licensing Plan.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.


Overview

Chandler is a Personal Information Manager for Windows, Linux, and Mac OS X. When completed, it will integrate calendar, contacts, tasks, email, and instant messaging features. It will be modular, extensible, peer-to-peer, and enable easily sharing information items between users.

This is only the 0.1 release, so it is very primitive. Many things will improve. However, it does show the skeleton of the framework and APIs. It does have basic sharing enabled.


Requirements

Chandler uses a number of components (e.g. python), but all the software you should need to run Chandler is shipped with Chandler. In general, OSAF develops on Windows XP, Linux Red Hat 8 and Red Hat 9, and Mac OS 10.2 ("Jaguar"). We have no reason to believe that it wouldn't work on other reasonably current versions of operating systems, but in general, haven't tested them.

One occasional difficulty is libraries on Unix machines. If you are running with something other than a standard Red Hat 8 or Red Hat 9 release, you might need to either install a few modules or rebuild the binaries.


Major Known Bugs as of the 0.1 Release

Localization

  • You cannot set the locale properly on the Mac or Linux (Bug:251). A warning error appears on startup on the Mac; Linux fails silently.

Documentation

Calendar

  • Moving events in the Calendar is different across Windows, Mac OS, and Linux (Bug:409). (We inherited behavior from wxWindows and have not yet decided if or how we will change that behavior.)
    • Under Windows, drag-and-drop to move calendar events and Control-drag to copy events.
    • Under Linux, drag-and-drop to copy calendar events and Shift-drag to move events.
    • Under MacOS, drag-and-drop to copy events; there is no way (yet) to move events.
  • If you make a copy of an event in the Calendar, it doesn't persist. In other words, if you copy an event, switch to a different Parcel (e.g. Contacts), and switch back, you won't see the copied event. You'll only see the original event. (Bug:425)
  • Under Linux, if the active locale is UTF-8 (the default on RedHat 8.0 or 9), the month panel may display Korean characters in place of Roman letters and Arabic numerals. The work-around is to set the LANG environment variable to a non-Unicode value (i.e. "export LANG=en_US") before starting Chandler.
  • Event text does not always display correctly in Month View. (If it is long, it can spill over into the next day's box instead of wrapping into the next line of that day.)
  • You cannot (yet) create events in Month View.

ZaoBao

  • ZaoBao, an RSS aggregator, takes a long time to load the very first time. (It's going out to the network to initialize a bunch of RSS feeds.)

Timeclock

  • The second part of the multi-level Timeclock menu "Select currency label" does not appear. (Bug:406)
  • When you switch to the Timeclock parcel, only the last digit of the Floss Recycling rate appears in the text entry field. (Bug:474)

Repository

  • The repository view window is too small to be useful (Bug:472).
  • Repository parcel can be slow to load.

Contacts

  • If you add an Interests attribute to a Contact on Linux, you will get error messages on standard out. (Bug:275)


Major bugs found in the 0.1 after its release

If we find major (repeat, major) bugs in the 0.1 release after it ships, we will try to document them here. If you find a major bug that isn't mentioned in the "Known Bugs" section, please mention it. (Also please make sure it's reported in Bugzilla.

Further information

Technical information

End-user documentation

Developer documentation

Non-technical information

<End Current OSAF Thinking>


-- DuckySherwood - 15 Apr 2003
Edit | WYSIWYG | Attach | Printable | Raw View | Backlinks: Web, All Webs | History: r19 < r18 < r17 < r16 < r15 | More topic actions
 
Open Source Applications Foundation
Except where otherwise noted, this site and its content are licensed by OSAF under an Creative Commons License, Attribution Only 3.0.
See list of page contributors for attributions.