Qtopia1-6 merge

still to test
bic changes to be resolved
more changes to be made?

21 files changed, 4871 insertions, 3870 deletions

diff --git a/library/backend/categories.cpp b/library/backend/categories.cpp
index 6e011c4..e37b3b9 100644
--- a/library/backend/categories.cpp
+++ b/library/backend/categories.cpp
@@ -1,48 +1,65 @@
 /**********************************************************************
-** Copyright (C) 2000 Trolltech AS.  All rights reserved.
+** Copyright (C) 2000-2002 Trolltech AS.  All rights reserved.
 **
-** This file is part of Qtopia Environment.
+** This file is part of the Qtopia Environment.
 **
 ** This file may be distributed and/or modified under the terms of the
-** GNU General Public License version 2 as published by the Free
-** Software Foundation and appearing in the file LICENSE.GPL included
-** in the packaging of this file.
+** GNU General Public License version 2 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file.
 **
-** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING
-** THE WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A
-** PARTICULAR PURPOSE.
+** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
+** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 **
 ** See http://www.trolltech.com/gpl/ for GPL licensing information.
 **
 ** Contact info@trolltech.com if any conditions of this licensing are
 ** not clear to you.
 **
 **********************************************************************/
-#include "categories.h"
+#include <qtopia/categories.h>
+#include <qtopia/stringutil.h>
 #include <qfile.h>
 #include <qcstring.h>
 #include <qtextstream.h>
-#include "stringutil.h"
 
 using namespace Qtopia;
 
 /***********************************************************
  *
  * CategoryGroup
  *
  **********************************************************/
 
 #ifdef PALMTOPCENTER
 UidGen CategoryGroup::sUidGen( UidGen::PalmtopCenter );
 #else
 UidGen CategoryGroup::sUidGen( UidGen::Qtopia );
 #endif
 
+/*! \class CategoryGroup categories.h
+  \brief Helper class that is used by Categories
+
+  CategoryGroup is a group of categories that is associated with an
+  application or global set. Mainly it defines a map of ids to
+  category labels and category labels to ids. Lookups can be done with
+  labels or unique idenifiers.
+
+  \ingroup qtopiaemb
+  \ingroup qtopiadesktop
+  \warning Categories API will likely change between Qtopia 1.5 and Qtopia 3
+  \sa Categories::appGroupMap(), Categories::globalGroup()
+ */
+
+/*! Add \a label and return the UID. If failure, then 0 is returned. Note
+  that All and Unfiled are reserved labels.
+  \internal
+*/
 int CategoryGroup::add( const QString &label )
 {
     if ( label == QObject::tr("All") || label == QObject::tr("Unfiled") )
         return 0;
 
     QMap<QString,int>::Iterator findIt = mLabelIdMap.find( label );
     if ( findIt != mLabelIdMap.end() )
         return 0;
@@ -53,117 +70,133 @@ int CategoryGroup::add( const QString &label )
 
 void CategoryGroup::insert( int uid, const QString &label )
 {
     uidGen().store( uid );
     mIdLabelMap[uid] = label;
     mLabelIdMap[label] = uid;
 }
 
+/*! \internal
+ */
 bool CategoryGroup::add( int uid, const QString &label )
 {
     if ( label == QObject::tr("All") || label == QObject::tr("Unfiled") )
         return FALSE;
 
     QMap<QString,int>::ConstIterator labelIt = mLabelIdMap.find( label );
     if ( labelIt != mLabelIdMap.end() )
         return FALSE;
     QMap<int,QString>::ConstIterator idIt = mIdLabelMap.find( uid );
     if ( idIt != mIdLabelMap.end() )
         return FALSE;
     insert( uid, label );
     return TRUE;
 }
 
+/*! Returns TRUE if \a label was removed from the group, FALSE if not.
+  \internal
+ */
 bool CategoryGroup::remove( const QString &label )
 {
     QMap<QString,int>::Iterator findIt = mLabelIdMap.find( label );
     if ( findIt == mLabelIdMap.end() )
         return FALSE;
 
     mIdLabelMap.remove( *findIt );
     mLabelIdMap.remove( findIt );
 
     return TRUE;
 }
 
+/*! Returns TRUE if \a uid was removed from the group, FALSE if not.
+  \internal
+ */
 bool CategoryGroup::remove( int uid )
 {
     QMap<int,QString>::Iterator idIt = mIdLabelMap.find( uid );
     if ( idIt == mIdLabelMap.end() )
         return FALSE;
 
     mLabelIdMap.remove( *idIt );
     mIdLabelMap.remove( idIt );
 
     return TRUE;
 }
 
+/*! \internal
+ */
 bool CategoryGroup::rename( int uid, const QString &newLabel )
 {
     if ( newLabel == QObject::tr("All") || newLabel == QObject::tr("Unfiled") )
         return FALSE;
 
     QMap<int, QString>::Iterator idIt = mIdLabelMap.find( uid );
     if ( idIt == mIdLabelMap.end() )
         return FALSE;
 
     mLabelIdMap.remove( *idIt );
     mLabelIdMap[newLabel] = uid;
     *idIt = newLabel;
 
     return TRUE;
 }
 
+/*! \internal
+ */
 bool CategoryGroup::rename( const QString &oldLabel, const QString &newLabel )
 {
     return rename( id(oldLabel), newLabel );
 }
 
+/*! Returns TRUE if \a uid is stored in this group, FALSE if not. */
 bool CategoryGroup::contains(int uid) const
 {
     return ( mIdLabelMap.find( uid ) != mIdLabelMap.end() );
 }
 
+/*! Returns TRUE if \a label is stored in this group, FALSE if not. */
 bool CategoryGroup::contains(const QString &label) const
 {
     return ( mLabelIdMap.find( label ) != mLabelIdMap.end() );
 }
 
-/** Returns label associated with the uid or QString::null if
- *   not found
+/*! Returns label associated with the \a uid or QString::null if
+  not found
  */
 const QString &CategoryGroup::label(int uid) const
 {
     QMap<int,QString>::ConstIterator idIt = mIdLabelMap.find( uid );
     if ( idIt == mIdLabelMap.end() )
         return QString::null;
     return *idIt;
 }
 
-/** Returns the uid associated with label or 0 if not found */
+/*! Returns the uid associated with \a label or 0 if not found */
 int CategoryGroup::id(const QString &label) const
 {
     QMap<QString,int>::ConstIterator labelIt = mLabelIdMap.find( label );
     if ( labelIt == mLabelIdMap.end() )
         return 0;
     return *labelIt;
 }
 
+/*! Returns a list of all labels stored in this group. */
 QStringList CategoryGroup::labels() const
 {
     QStringList labels;
     for ( QMap<int, QString>::ConstIterator it = mIdLabelMap.begin();
           it != mIdLabelMap.end(); ++it )
         labels += *it;
     // ### I don't think this is the place for this...
 //    labels.sort();
     return labels;
 }
 
+/*! Returns a list of all labels associated with the \a catids */
 QStringList CategoryGroup::labels(const QArray<int> &catids ) const
 {
     QStringList labels;
     if ( catids.count() == 0 )
         return labels;
     for ( QMap<int, QString>::ConstIterator it = mIdLabelMap.begin();
           it != mIdLabelMap.end(); ++it )
         if ( catids.find( it.key() ) != -1 )
@@ -172,19 +205,59 @@ QStringList CategoryGroup::labels(const QArray<int> &catids ) const
 }
 
 /***********************************************************
  *
  * Categories
  *
  **********************************************************/
 
-/** Add the category name as long as it doesn't already exist locally
- *  or globally.  Return TRUE if added, FALSE if conflicts.
- */
+/*!
+  \class Categories categories.h
+  \brief The Categories class is a database that groups categories and maps ids to names.
+
+  The Categories class is the low level Categories accessor class. To
+  add a category menu and filter for your application, see CategoryMenu.
+
+  The Categories class allows the developer to add, remove, and rename
+  categories. Categories can be created for an individual application
+  such as Todo List or to be used for all applications. Categories
+  that can be used by all applications are called global
+  categories. Each PalmtopRecord subclass stores categories as an
+  QArray<int> using PalmtopRecord::setCategories() and
+  PalmtopRecord::categories(). This allows each record to be assigned
+  to multiple categories. This also allows the user to rename a
+  category and for it to update automatically in all records.
+
+  This class provides several methods to convert between a category id
+  and it's associated string such as id(), ids(), label() and labels(). A
+  helper class called CategoryGroup is used to access categories of a
+  single application group, such as Todo List. Global categories can
+  also be accessed via CategoryGroup objects.  See appGroupMap() and
+  globalGroup() for the appropriate accessor methods.
+
+  Categories are stored in an xml file in the Settings directory
+  (Categories.xml). A global function called categoryFileName() will
+  return to appropriate QString file location to be passed to load()
+  and save() for the master categories database.
+
+  \ingroup qtopiaemb
+  \ingroup qtopiadesktop
+  \warning Categories API will likely change between Qtopia 1.5 and Qtopia 3
+  \sa CategoryGroup, CategoryMenu
+*/
+
+
+/*!
+  Add the category name as long as it doesn't already exist locally or
+  globally.  The \a uid is assigned to the category if successfully
+  added. Return \a uid if added, 0 if conflicts (error).
+
+  \internal
+*/
 int Categories::addCategory( const QString &appname,
                              const QString &catname,
                              int uid )
 {
     if ( mGlobalCats.contains(catname) )
         return 0;
 
     QMap< QString, CategoryGroup >::Iterator
@@ -199,16 +272,21 @@ int Categories::addCategory( const QString &appname,
     }
 
     CategoryGroup &cats = *appIt;
     cats.add( uid, catname );
     emit categoryAdded( *this, appname, uid );
     return uid;
 }
 
+/*!
+  Add the category name as long as it doesn't already exist locally or
+  globally.  Return UID if added, 0 if conflicts (error).
+*/
+
 int Categories::addCategory( const QString &appname,
                              const QString &catname )
 {
      if ( mGlobalCats.contains(catname) )
         return 0;
 
     QMap< QString, CategoryGroup >::Iterator
         appIt = mAppCats.find( appname );
@@ -224,36 +302,47 @@ int Categories::addCategory( const QString &appname,
     CategoryGroup &cats = *appIt;
     int uid = cats.add( catname );
     if ( !uid )
         return 0;
     emit categoryAdded( *this, appname, uid );
     return uid;
 }
 
+/*!
+  \internal
+*/
 int Categories::addGlobalCategory( const QString &catname, int uid )
 {
     mGlobalCats.add( uid, catname );
     emit categoryAdded( *this, QString::null, uid );
     return uid;
 }
 
+/*!
+  Add the global category \a catname while checking that it doesn't
+  already exist globally. Return UID if added, 0 if conflicts.
+
+  \sa addCategory()
+ */
 int Categories::addGlobalCategory( const QString &catname )
 {
     int uid = mGlobalCats.add( catname );
     if ( !uid )
         return 0;
     emit categoryAdded( *this, QString::null, uid );
     return uid;
 }
 
-/** Removes the category from the application; if it is not found
- *  in the application, then it attempts to remove it from
- *  the global list
- */
+/*!
+
+  Removes the \a catname from the application group. If it is not
+  found in the application group and \a checkGlobal is TRUE, then it
+  attempts to remove it from the global list
+*/
 bool Categories::removeCategory( const QString &appname,
                                  const QString &catname,
                                  bool checkGlobal )
 {
     QMap< QString, CategoryGroup >::Iterator
         appIt = mAppCats.find( appname );
     if ( appIt != mAppCats.end() ) {
         CategoryGroup &cats = *appIt;
@@ -263,65 +352,78 @@ bool Categories::removeCategory( const QString &appname,
             return TRUE;
         }
     }
     if ( !checkGlobal )
         return FALSE;
     return removeGlobalCategory( catname );
 }
 
+
+/*!
+  Removes the \a uid from the application group \a appname. Returns TRUE
+  if success, FALSE if not found.
+*/
 bool Categories::removeCategory( const QString &appname, int uid )
 {
     QMap< QString, CategoryGroup >::Iterator
         appIt = mAppCats.find( appname );
     if ( appIt != mAppCats.end() ) {
         CategoryGroup &cats = *appIt;
         if ( cats.remove( uid ) ) {
             emit categoryRemoved( *this, appname, uid );
             return TRUE;
         }
     }
     return FALSE;
 }
 
+/*!
+  Removes the global category \a catname. Returns TRUE
+  if success, FALSE if not found.
+*/
 bool Categories::removeGlobalCategory( const QString &catname )
 {
     int uid = mGlobalCats.id( catname );
     if ( mGlobalCats.remove( uid ) ) {
         emit categoryRemoved( *this, QString::null, uid );
         return TRUE;
     }
     return FALSE;
 }
 
-
+/*!
+  Removes the global category \a uid. Returns TRUE
+  if success, FALSE if not found.
+*/
 bool Categories::removeGlobalCategory( int uid )
 {
      if ( mGlobalCats.remove( uid ) ) {
         emit categoryRemoved( *this, QString::null, uid );
         return TRUE;
     }
     return FALSE;
 }
 
-/** Returns the sorted list of all categories that are associated with
- *   the app.  If includeGlobal parameter is TRUE then the returned
- *   categories will include the global category items.
+/*!
+  Returns the sorted list of all categories that are associated with
+  the \a app.  If \a includeGlobal is TRUE then the returned
+  categories will include the global category items.
  */
 QStringList Categories::labels( const QString &app,
                                 bool includeGlobal,
                                 ExtraLabels extra ) const
 {
     QMap< QString, CategoryGroup >::ConstIterator
         appIt = mAppCats.find( app );
     QStringList cats;
 
     if ( appIt != mAppCats.end() )
         cats += (*appIt).labels();
-    else qDebug("Categories::labels didn't find app %s", app.latin1() );
+    //else qDebug("Categories::labels didn't find app %s", app.latin1() );
     if ( includeGlobal )
         cats += mGlobalCats.labels();
 
     cats.sort();
     switch ( extra ) {
     case NoExtra: break;
     case AllUnfiled:
         cats.append( tr("All") );
@@ -333,32 +435,41 @@ QStringList Categories::labels( const QString &app,
     case UnfiledLabel:
         cats.append( tr("Unfiled") );
         break;
     }
 
     return cats;
 }
 
+/*!
+  Returns the label associated with the id
+*/
 QString Categories::label( const QString &app, int id ) const
 {
     if ( mGlobalCats.contains( id ) )
         return mGlobalCats.label( id );
     QMap< QString, CategoryGroup >::ConstIterator
         appIt = mAppCats.find( app );
     if ( appIt == mAppCats.end() )
         return QString::null;
     return (*appIt).label( id );
 }
 
-/** Returns a single string associated with the cat ids for display in
-    *   a combobox or any area that requires one string.  If catids are empty
-    *   then "Unfiled" will be returned.  If multiple categories are assigned
-    *   the first cat id is shown with " (multi)" appended to the string.
-    */
+/*!
+  Returns a single string associated with \a catids for display in a
+  combobox or any area that requires one string.  If \a catids are empty
+  then "Unfiled" will be returned.  If multiple categories are
+  assigned then the behavior depends on the DisplaySingle type.
+
+  If \a display is set to ShowMulti then " (multi)" appended to the
+  first string. If \a display is set to ShowAll, then a space
+  seperated string is returned with all categories.  If ShowFirst is
+  set, the just the first string is returned.
+*/
 QString Categories::displaySingle( const QString &app,
                                    const QArray<int> &catids,
                                    DisplaySingle display ) const
 {
     QStringList strs = labels( app, catids );
     if ( !strs.count() )
         return tr("Unfiled");
     strs.sort();
@@ -375,46 +486,61 @@ QString Categories::displaySingle( const QString &app,
             r = strs.join(" ");
             break;
         }
     }
             else r = strs.first(); 
     return r;
 }
 
+/*!
+
+  Returns all ids associated with the application CategoryGroup \a app
+  and the passed in \a labels in that group.
+*/
 QArray<int> Categories::ids( const QString &app, const QStringList &labels) const
 {
   QArray<int> results;
   QStringList::ConstIterator it;
   int i;
-  
+
   for ( i=0, it=labels.begin(); it!=labels.end(); i++, ++it ) {
     int value = id( app, *it );
     if ( value != 0 ) {
       int tmp = results.size();
       results.resize( tmp + 1 );
       results[ tmp ] = value;
     }
   }
   return results;
 }
 
+/*!
+  Returns the id associated with the app. If the id is not found in the
+  application CategoryGroup, then it searches the global CategoryGroup.
+  If it is not found it either, 0 is returned.
+*/
 int Categories::id( const QString &app, const QString &cat ) const
 {
     if ( cat == tr("Unfiled") || cat.contains( tr(" (multi.)") ) )
         return 0;
     int uid = mGlobalCats.id( cat );
     if ( uid != 0 )
         return uid;
     return mAppCats[app].id( cat );
 }
 
 
-/** Return TRUE if renaming succeeded; FALSE if app name not found,
- *   or if there was a name conflict
+/*!
+  Return TRUE if renaming succeeded; FALSE if \a appname or \a oldName
+  is not found, or if \a newName conflicts with an existing category
+  in the CategoryGroup.
+
+  It will first search the CategoryGroup associated with \a appname
+  and if not found it will try to replace in global CategoryGroup.
  */
 bool Categories::renameCategory( const QString &appname,
                                  const QString &oldName,
                                  const QString &newName )
 {
     QMap< QString, CategoryGroup >::Iterator
         appIt = mAppCats.find( appname );
 
@@ -424,27 +550,37 @@ bool Categories::renameCategory( const QString &appname,
         if ( id != 0 && cats.rename( id, newName ) ) {
             emit categoryRenamed( *this, appname, id );
             return TRUE;
         }
     }
     return renameGlobalCategory( oldName, newName );
 }
 
+/*!
+  Return TRUE if renaming succeeded; FALSE if \a appname or \a oldName
+  is not found, or if \a newName conflicts with an existing category
+  in the CategoryGroup. This function will only rename categories found
+  in the global CategoryGroup.
+ */
 bool Categories::renameGlobalCategory( const QString &oldName,
                                        const QString &newName )
 {
     int uid = mGlobalCats.id( oldName );
     if ( uid != 0 && mGlobalCats.rename( uid, newName ) ) {
         emit categoryRenamed( *this, QString::null, uid );
         return TRUE;
     }
     return FALSE;
 }
 
+/*!
+  Changes the grouping of a category. If a category was global and \a global
+  is set to TRUE, then the \a catname will be moved to the \a appname group.
+*/
 void Categories::setGlobal( const QString &appname,
                             const QString &catname,
                             bool global )
 {
     // if in global and should be in app; then move it
     if ( mGlobalCats.contains( catname ) && !global ) {
         mGlobalCats.remove( catname );
         addCategory( appname, catname );
@@ -453,49 +589,63 @@ void Categories::setGlobal( const QString &appname,
 
     // if in app and should be in global, then move it
     if ( !global )
         return;
     if ( removeCategory( appname, catname, FALSE ) )
         addGlobalCategory( catname );
 }
 
+/*!
+  Returns TRUE if the \a catname is in the global CategoryGroup, FALSE if not.
+*/
 bool Categories::isGlobal( const QString &catname ) const
 {
     return mGlobalCats.contains( catname );
 }
 
 
-/** Returns true if the catname is associated with any application
+/*!
+  Returns true if the \a catname is associated with any CategoryGroup,
+  including global.
  */
 bool Categories::exists( const QString &catname ) const
 {
     if ( isGlobal(catname) )
         return TRUE;
 
     for ( QMap<QString, CategoryGroup>::ConstIterator appsIt = mAppCats.begin(); appsIt != mAppCats.end(); ++appsIt )
         if ( exists( appsIt.key(), catname ) )
             return TRUE;
 
     return FALSE;
 }
 
+/*!
+  Returns TRUE if the \a catname is associated with the \a appname
+  CategoryGroup, FALSE if not found.
+ */
 bool Categories::exists( const QString &appname,
                          const QString &catname) const
 {
     QMap< QString, CategoryGroup >::ConstIterator
         appIt = mAppCats.find( appname );
 
     if ( appIt == mAppCats.end() )
         return FALSE;
 
     return (*appIt).contains( catname );
 }
 
+/*!
+  Saves the Categories database to the \a fname. See categoryFileName()
+  for the default file name string used for the shared category database.
 
+  Returns FALSE if there is error writing the file or TRUE on success.
+ */
 bool Categories::save( const QString &fname ) const
 {
     QString strNewFile = fname + ".new";
     QFile f( strNewFile );
     QString out;
     int total_written;
 
     if ( !f.open( IO_WriteOnly|IO_Raw ) ) {
@@ -529,26 +679,35 @@ bool Categories::save( const QString &fname ) const
     total_written = f.writeBlock( cstr.data(), cstr.length() );
     if ( total_written != int(cstr.length()) ) {
         f.close();
          QFile::remove( strNewFile );
          return FALSE;
     }
     f.close();
 
+#ifdef Q_OS_WIN32
+    QFile::remove( fname );
+#endif
     if ( ::rename( strNewFile.latin1(), fname.latin1() ) < 0 ) {
         qWarning( "problem renaming file %s to %s",
                   strNewFile.latin1(), fname.latin1());
         // remove the tmp file...
         QFile::remove( strNewFile );
     }
 
     return TRUE;
 }
 
+/*!
+  Loads the Categories database using \a fname. See categoryFileName()
+  for the default file name string used for the shared category database.
+
+  Returns FALSE if there is error reading the file or TRUE on success.
+ */
 bool Categories::load( const QString &fname )
 {
     QFile file( fname );
     if ( !file.open( IO_ReadOnly ) ) {
         qWarning("Unable to open %s", fname.latin1());
 
         addGlobalCategory(tr("Business"));
         addGlobalCategory(tr("Personal"));
@@ -614,22 +773,29 @@ bool Categories::load( const QString &fname )
             mGlobalCats.add( id.toInt(), name );
         else
             mAppCats[ app ].add( id.toInt(), name );
     }
 
     return TRUE;
 }
 
+/*!
+  Clear the categories in memory. Equivelent to creating an empty Categories
+  object.
+*/
 void Categories::clear()
 {
     mGlobalCats.clear();
     mAppCats.clear();
 }
 
+/*!
+  Dump the contents to standard out. Used for debugging only.
+*/
 void Categories::dump() const
 {
     qDebug("\tglobal categories = %s", mGlobalCats.labels().join(", ").latin1() );
     for ( QMap<QString, CategoryGroup>::ConstIterator appsIt = mAppCats.begin(); appsIt != mAppCats.end(); ++appsIt ) {
         const QString &app = appsIt.key();
         QStringList appcats = (*appsIt).labels();
         qDebug("\tapp = %s\tcategories = %s", app.latin1(),
                appcats.join(", ").latin1() );
@@ -670,8 +836,101 @@ void CheckedListView::setChecked( const QStringList &checked )
            if ( !showingChecked ) {
                ensureItemVisible( i );
                showingChecked = TRUE;
            }
         }
        else
            i->setOn( FALSE );
 }
+
+/*! \fn Categories &Categories::operator= ( const Categories &c )
+
+  Performs deep copy.
+ */
+
+
+/*! \fn  QStringList Categories::labels( const QString & app, const QArray<int> &catids ) const
+
+  Returns list of labels associated with the application and catids
+*/
+
+/*! \fn QStringList Categories::globalCategories() const
+
+  Returns list of all global category labels
+*/
+
+/*! \fn const QMap<QString, CategoryGroup> &Categories::appGroupMap() const
+
+  Returns a map of application names to CategoryGroup. The CategoryGroup
+  class defines a map of ids to category labels and category labels to ids.
+*/
+
+/*! \fn const CategoryGroup &Categories::globalGroup() const
+
+  Returns the global CategoryGroup. The CategoryGroup
+  class defines a map of ids to category labels and category labels to ids.
+*/
+
+/*! \fn void Categories::categoryAdded( const Categories &cats, const QString &appname, int uid)
+
+  Emitted if a category is added.
+
+  \a cats is a const reference to this object
+  \a appname is the CategoryGroup application name that the category was added to or QString::null if it was global
+  \a uid is the unique identifier associated with the added category
+        */
+
+/*! \fn void Categories::categoryRemoved( const Categories &cats, const QString &appname,
+  int uid)
+
+  Emitted if removed category is removed.
+
+  \a cats is a const reference to this object
+  \a appname is the CategoryGroup application name that the category was removed from or QString::null if it was the global CategoryGroup
+  \a uid is the unique identifier associated with the removed category
+*/
+
+
+/*! \fn void Categories::categoryRenamed( const Categories &cats, const QString &appname,
+  int uid)
+
+  Emitted if \a uid in the \a appname CategoryGroup is renamed in \a cats
+  object.
+
+  \a cats is a const reference to this object
+  \a appname is the CategoryGroup application name that the category was renamed in or QString::null if it was the global CategoryGroup
+  \a uid is the unique identifier associated with the renamed category
+*/
+
+/*! \fn Categories::Categories( QObject *parent=0, const char *name = 0 )
+
+  Constructor for an empty Categories object.
+*/
+
+/*! \fn Categories::Categories( const Categories &copyFrom )
+
+  Deep copy constructor
+*/
+
+/*! \fn Categories::~Categories()
+
+  Empty destructor. Call save() before destruction if there are changes
+  that need to be saved.
+*/
+
+/*! \fn CategoryGroup::clear()
+  \internal
+*/
+
+/*! \fn const QMap<int, QString> &CategoryGroup::idMap() const
+
+  Returns a const reference to the id to label QMap
+*/
+
+/*! \fn CategoryGroup::CategoryGroup()
+  \internal
+*/
+
+/*! \fn CategoryGroup::CategoryGroup(const CategoryGroup &c)
+  \internal
+*/
+
diff --git a/library/backend/contact.cpp b/library/backend/contact.cpp
index b10b19a..3f4934a 100644
--- a/library/backend/contact.cpp
+++ b/library/backend/contact.cpp
@@ -1,12 +1,12 @@
 /**********************************************************************
-** Copyright (C) 2001 Trolltech AS.  All rights reserved.
+** Copyright (C) 2000-2002 Trolltech AS.  All rights reserved.
 **
-** This file is part of Qtopia Environment.
+** This file is part of the Qtopia Environment.
 **
 ** This file may be distributed and/or modified under the terms of the
 ** GNU General Public License version 2 as published by the Free Software
 ** Foundation and appearing in the file LICENSE.GPL included in the
 ** packaging of this file.
 **
 ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
 ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
@@ -29,49 +29,427 @@
 
 #include <qobject.h>
 #include <qregexp.h>
 #include <qstylesheet.h>
 #include <qfileinfo.h>
 
 #include <stdio.h>
 
+/*!
+  \class Contact contact.h
+  \brief The Contact class holds the data of an address book entry.
+
+  This data includes information the name of the person, contact
+  information, and business information such as deparment and job title.
+
+  \ingroup qtopiaemb
+  \ingroup qtopiadesktop
+*/
+
 Qtopia::UidGen Contact::sUidGen( Qtopia::UidGen::Qtopia );
 
+/*!
+  Creates a new, empty contact.
+*/
 Contact::Contact()
     : Record(), mMap(), d( 0 )
 {
 }
 
+/*!
+  \internal
+  Creates a new contact.  The properties of the contact are
+  set from \a fromMap.
+*/
 Contact::Contact( const QMap<int, QString> &fromMap ) :
     Record(), mMap( fromMap ), d( 0 )
 {
     QString cats = mMap[ Qtopia::AddressCategory ];
     if ( !cats.isEmpty() )
         setCategories( idsFromString( cats ) );
     QString uidStr = find( Qtopia::AddressUid );
+
     if ( uidStr.isEmpty() )
         setUid( uidGen().generate() );
     else
         setUid( uidStr.toInt() );
+
+    if ( !uidStr.isEmpty() )
+        setUid( uidStr.toInt() );
 }
 
+/*!
+  Destroys a contact.
+*/
 Contact::~Contact()
 {
 }
 
+/*! \fn void Contact::setTitle( const QString &str )
+  Sets the title of the contact to \a str.
+*/
+
+/*! \fn void Contact::setFirstName( const QString &str )
+  Sets the first name of the contact to \a str.
+*/
+
+/*! \fn void Contact::setMiddleName( const QString &str )
+  Sets the middle name of the contact to \a str.
+*/
+
+/*! \fn void Contact::setLastName( const QString &str )
+  Sets the last name of the contact to \a str.
+*/
+
+/*! \fn void Contact::setSuffix( const QString &str )
+  Sets the suffix of the contact to \a str.
+*/
+
+/*! \fn void Contact::setFileAs( const QString &str )
+  Sets the contact to filed as \a str.
+*/
+
+/*! \fn void Contact::setDefaultEmail( const QString &str )
+  Sets the default email of the contact to \a str.
+*/
+
+/*! \fn void Contact::setHomeStreet( const QString &str )
+  Sets the home street address of the contact to \a str.
+*/
+
+/*! \fn void Contact::setHomeCity( const QString &str )
+  Sets the home city of the contact to \a str.
+*/
+
+/*! \fn void Contact::setHomeState( const QString &str )
+  Sets the home state of the contact to \a str.
+*/
+
+/*! \fn void Contact::setHomeZip( const QString &str )
+  Sets the home zip code of the contact to \a str.
+*/
+
+/*! \fn void Contact::setHomeCountry( const QString &str )
+  Sets the home country of the contact to \a str.
+*/
+
+/*! \fn void Contact::setHomePhone( const QString &str )
+  Sets the home phone number of the contact to \a str.
+*/
+
+/*! \fn void Contact::setHomeFax( const QString &str )
+  Sets the home fax number of the contact to \a str.
+*/
+
+/*! \fn void Contact::setHomeMobile( const QString &str )
+  Sets the home mobile phone number of the contact to \a str.
+*/
+
+/*! \fn void Contact::setHomeWebpage( const QString &str )
+  Sets the home webpage of the contact to \a str.
+*/
+
+/*! \fn void Contact::setCompany( const QString &str )
+  Sets the company for contact to \a str.
+*/
+
+/*! \fn void Contact::setJobTitle( const QString &str )
+  Sets the job title of the contact to \a str.
+*/
+
+/*! \fn void Contact::setDepartment( const QString &str )
+  Sets the department for contact to \a str.
+*/
+
+/*! \fn void Contact::setOffice( const QString &str )
+  Sets the office for contact to \a str.
+*/
+
+/*! \fn void Contact::setBusinessStreet( const QString &str )
+  Sets the business street address of the contact to \a str.
+*/
+
+/*! \fn void Contact::setBusinessCity( const QString &str )
+  Sets the business city of the contact to \a str.
+*/
+
+/*! \fn void Contact::setBusinessState( const QString &str )
+  Sets the business state of the contact to \a str.
+*/
+
+/*! \fn void Contact::setBusinessZip( const QString &str )
+  Sets the business zip code of the contact to \a str.
+*/
+
+/*! \fn void Contact::setBusinessCountry( const QString &str )
+  Sets the business country of the contact to \a str.
+*/
+
+/*! \fn void Contact::setBusinessPhone( const QString &str )
+  Sets the business phone number of the contact to \a str.
+*/
+
+/*! \fn void Contact::setBusinessFax( const QString &str )
+  Sets the business fax number of the contact to \a str.
+*/
+
+/*! \fn void Contact::setBusinessMobile( const QString &str )
+  Sets the business mobile phone number of the contact to \a str.
+*/
+
+/*! \fn void Contact::setBusinessPager( const QString &str )
+  Sets the business pager number of the contact to \a str.
+*/
+
+/*! \fn void Contact::setBusinessWebpage( const QString &str )
+  Sets the business webpage of the contact to \a str.
+*/
+
+/*! \fn void Contact::setProfession( const QString &str )
+  Sets the profession of the contact to \a str.
+*/
+
+/*! \fn void Contact::setAssistant( const QString &str )
+  Sets the assistant of the contact to \a str.
+*/
+
+/*! \fn void Contact::setManager( const QString &str )
+  Sets the manager of the contact to \a str.
+*/
+
+/*! \fn void Contact::setSpouse( const QString &str )
+  Sets the spouse of the contact to \a str.
+*/
+
+/*! \fn void Contact::setGender( const QString &str )
+  Sets the gender of the contact to \a str.
+*/
+
+/*! \fn void Contact::setBirthday( const QString &str )
+  Sets the birthday for the contact to \a str.
+*/
+
+/*! \fn void Contact::setAnniversary( const QString &str )
+  Sets the anniversary of the contact to \a str.
+*/
+
+/*! \fn void Contact::setNickname( const QString &str )
+  Sets the nickname of the contact to \a str.
+*/
+
+/*! \fn void Contact::setNotes( const QString &str )
+  Sets the notes about the contact to \a str.
+*/
+
+/*! \fn QString Contact::title() const
+  Returns the title of the contact.
+*/
+
+/*! \fn QString Contact::firstName() const
+  Returns the first name of the contact.
+*/
+
+/*! \fn QString Contact::middleName() const
+  Returns the middle name of the contact.
+*/
+
+/*! \fn QString Contact::lastName() const
+  Returns the last name of the contact.
+*/
+
+/*! \fn QString Contact::suffix() const
+  Returns the suffix of the contact.
+*/
+
+/*! \fn QString Contact::fileAs() const
+  Returns the string the contact is filed as.
+*/
+
+/*! \fn QString Contact::defaultEmail() const
+  Returns the default email address of the contact.
+*/
+
+/*! \fn QString Contact::emails() const
+  Returns the list of email address for a contact separated by ';'s in a single
+  string.
+*/
+
+/*! \fn QString Contact::homeStreet() const
+  Returns the home street address of the contact.
+*/
+
+/*! \fn QString Contact::homeCity() const
+  Returns the home city of the contact.
+*/
+
+/*! \fn QString Contact::homeState() const
+  Returns the home state of the contact.
+*/
+
+/*! \fn QString Contact::homeZip() const
+  Returns the home zip of the contact.
+*/
+
+/*! \fn QString Contact::homeCountry() const
+  Returns the home country of the contact.
+*/
+
+/*! \fn QString Contact::homePhone() const
+  Returns the home phone number of the contact.
+*/
+
+/*! \fn QString Contact::homeFax() const
+  Returns the home fax number of the contact.
+*/
+
+/*! \fn QString Contact::homeMobile() const
+  Returns the home mobile number of the contact.
+*/
+
+/*! \fn QString Contact::homeWebpage() const
+  Returns the home webpage of the contact.
+*/
+
+/*! \fn QString Contact::company() const
+  Returns the company for the contact.
+*/
+
+/*! \fn QString Contact::department() const
+  Returns the department for the contact.
+*/
+
+/*! \fn QString Contact::office() const
+  Returns the office for the contact.
+*/
+
+/*! \fn QString Contact::jobTitle() const
+  Returns the job title of the contact.
+*/
+
+/*! \fn QString Contact::profession() const
+  Returns the profession of the contact.
+*/
+
+/*! \fn QString Contact::assistant() const
+  Returns the assistant of the contact.
+*/
+
+/*! \fn QString Contact::manager() const
+  Returns the manager of the contact.
+*/
+
+/*! \fn QString Contact::businessStreet() const
+  Returns the business street address of the contact.
+*/
+
+/*! \fn QString Contact::businessCity() const
+  Returns the business city of the contact.
+*/
+
+/*! \fn QString Contact::businessState() const
+  Returns the business state of the contact.
+*/
+
+/*! \fn QString Contact::businessZip() const
+  Returns the business zip of the contact.
+*/
+
+/*! \fn QString Contact::businessCountry() const
+  Returns the business country of the contact.
+*/
+
+/*! \fn QString Contact::businessPhone() const
+  Returns the business phone number of the contact.
+*/
+
+/*! \fn QString Contact::businessFax() const
+  Returns the business fax number of the contact.
+*/
+
+/*! \fn QString Contact::businessMobile() const
+  Returns the business mobile number of the contact.
+*/
+
+/*! \fn QString Contact::businessPager() const
+  Returns the business pager number of the contact.
+*/
+
+/*! \fn QString Contact::businessWebpage() const
+  Returns the business webpage of the contact.
+*/
+
+/*! \fn QString Contact::spouse() const
+  Returns the spouse of the contact.
+*/
+
+/*! \fn QString Contact::gender() const
+  Returns the gender of the contact.
+*/
+
+/*! \fn QString Contact::birthday() const
+  Returns the birthday of the contact.
+*/
+
+/*! \fn QString Contact::anniversary() const
+  Returns the anniversary of the contact.
+*/
+
+/*! \fn QString Contact::nickname() const
+  Returns the nickname of the contact.
+*/
+
+/*! \fn QString Contact::children() const
+  Returns the children of the contact.
+*/
+
+/*! \fn QString Contact::notes() const
+  Returns the notes relating to the the contact.
+*/
+
+/*! \fn QString Contact::groups() const
+  \internal
+  Returns the groups for the contact.
+*/
+
+/*! \fn QStringList Contact::groupList() const
+  \internal
+*/
+
+/*! \fn QString Contact::field(int) const
+  \internal
+*/
+
+/*! \fn void Contact::saveJournal( journal_action, const QString & = QString::null )
+  \internal
+*/
+
+/*! \fn void Contact::setUid( int id )
+  \internal
+  Sets the uid for this record to \a id.
+*/
+
+/*! \enum Contact::journal_action
+  \internal
+*/
+
+/*!
+  \internal
+*/
 QMap<int, QString> Contact::toMap() const
 {
     QMap<int, QString> map = mMap;
-    map.insert( Qtopia::AddressCategory, idsToString( categories() ));
+    QString cats = idsToString( categories() );
+    if ( !cats.isEmpty() )
+        map.insert( Qtopia::AddressCategory, cats );
     return map;
 }
 
 /*!
-  Returns a rich text formatted QString of the Contact.
+  Returns a rich text formatted QString representing the contents the contact.
 */
 QString Contact::toRichText() const
 {
     QString text;
     QString value, comp, state;
 
     // name, jobtitle and company
     if ( !(value = fullName()).isEmpty() )
@@ -226,39 +604,51 @@ QString Contact::toRichText() const
         //QString tmp = Qtopia::escapeString(value);
         QString tmp = QStyleSheet::convertFromPlainText(value);
         //tmp.replace( reg, "<br>" );
         text += "<br>" + tmp + "<br>";
     }
     return text;
 }
 
+/*!
+  \internal
+*/
 void Contact::insert( int key, const QString &v )
 {
     QString value = v.stripWhiteSpace();
     if ( value.isEmpty() )
         mMap.remove( key );
     else
         mMap.insert( key, value );
 }
 
+/*!
+  \internal
+*/
 void Contact::replace( int key, const QString & v )
 {
     QString value = v.stripWhiteSpace();
     if ( value.isEmpty() )
         mMap.remove( key );
     else
         mMap.replace( key, value );
 }
 
+/*!
+  \internal
+*/
 QString Contact::find( int key ) const
 {
     return mMap[key];
 }
 
+/*!
+  \internal
+*/
 QString Contact::displayAddress( const QString &street,
                                  const QString &city,
                                  const QString &state,
                                  const QString &zip,
                                  const QString &country ) const
 {
     QString s = street;
     if ( !street.isEmpty() )
@@ -271,30 +661,39 @@ QString Contact::displayAddress( const QString &street,
         s += "  ";
     s += zip;
     if ( !country.isEmpty() && !s.isEmpty() )
         s += "\n";
     s += country;
     return s;
 }
 
+/*!
+  \internal
+*/
 QString Contact::displayBusinessAddress() const
 {
     return displayAddress( businessStreet(), businessCity(),
                            businessState(), businessZip(),
                            businessCountry() );
 }
 
+/*!
+  \internal
+*/
 QString Contact::displayHomeAddress() const
 {
     return displayAddress( homeStreet(), homeCity(),
                            homeState(), homeZip(),
                            homeCountry() );
 }
 
+/*!
+  Returns the full name of the contact
+*/
 QString Contact::fullName() const
 {
     QString title = find( Qtopia::Title );
     QString firstName = find( Qtopia::FirstName );
     QString middleName = find( Qtopia::MiddleName );
     QString lastName = find( Qtopia::LastName );
     QString suffix = find( Qtopia::Suffix );
 
@@ -317,26 +716,72 @@ QString Contact::fullName() const
     if ( !suffix.isEmpty() ) {
         if ( !name.isEmpty() )
             name += " ";
         name += suffix;
     }
     return name.simplifyWhiteSpace();
 }
 
+/*!
+  Returns a list of the names of the children of the contact.
+*/
 QStringList Contact::childrenList() const
 {
     return QStringList::split( " ", find( Qtopia::Children ) );
 }
 
+/*! \fn void Contact::insertEmail( const QString &email )
+
+  Insert \a email into the email list. Ensures \a email can only be added
+  once. If there is no default email address set, it sets it to the \a email.
+*/
+
+/*! \fn void Contact::removeEmail( const QString &email )
+
+  Removes the \a email from the email list. If the default email was \a email,
+  then the default email address is assigned to the first email in the
+  email list
+*/
+
+/*! \fn void Contact::clearEmails()
+
+  Clears the email list.
+ */
+
+/*! \fn void Contact::insertEmails( const QStringList &emailList )
+
+  Appends the \a emailList to the exiting email list
+ */
+
+/*!
+  Returns a list of email addresses belonging to the contact, including
+  the default email address.
+*/
 QStringList Contact::emailList() const
 {
-    return QStringList::split( ";", find( Qtopia::Emails ) );
+    QString emailStr = emails();
+
+    QStringList r;
+    if ( !emailStr.isEmpty() ) {
+        qDebug(" emailstr ");
+        QStringList l = QStringList::split( emailSeparator(), emailStr );
+        for ( QStringList::ConstIterator it = l.begin();it != l.end();++it )
+            r += (*it).simplifyWhiteSpace();
+    }
+
+    return r;
 }
 
+/*!
+  \overload
+
+  Generates the string for the contact to be filed as from the first,
+  middle and last name of the contact.
+*/
 void Contact::setFileAs()
 {
     QString lastName, firstName, middleName, fileas;
 
     lastName = find( Qtopia::LastName );
     firstName = find( Qtopia::FirstName );
     middleName = find( Qtopia::MiddleName );
     if ( !lastName.isEmpty() && !firstName.isEmpty()
@@ -348,16 +793,20 @@ void Contact::setFileAs()
               !middleName.isEmpty() )
         fileas = firstName + ( firstName.isEmpty() ? "" : " " )
                  + middleName + ( middleName.isEmpty() ? "" : " " )
                  + lastName;
 
     replace( Qtopia::FileAs, fileas );
 }
 
+/*!
+  \internal
+  Appends the contact information to \a buf.
+*/
 void Contact::save( QString &buf ) const
 {
     static const QStringList SLFIELDS = fields();
     // I'm expecting "<Contact " in front of this...
     for ( QMap<int, QString>::ConstIterator it = mMap.begin();
           it != mMap.end(); ++it ) {
         const QString &value = it.data();
         int key = it.key();
@@ -372,16 +821,20 @@ void Contact::save( QString &buf ) const
     }
     buf += customToXml();
     if ( categories().count() > 0 )
         buf += "Categories=\"" + idsToString( categories() ) + "\" ";
     buf += "Uid=\"" + QString::number( uid() ) + "\" ";
     // You need to close this yourself
 }
 
+/*!
+  \internal
+  Returns the list of fields belonging to a contact
+*/
 QStringList Contact::fields()
 {
     QStringList list;
 
     list.append( "Title" );  // Not Used!
     list.append( "FirstName" );
     list.append( "MiddleName" );
     list.append( "LastName" );
@@ -430,16 +883,20 @@ QStringList Contact::fields()
     list.append( "Children" );
 
     list.append( "Notes" );
     list.append( "Groups" );
 
     return list;
 }
 
+/*!
+  \internal
+  Returns a translated list of field names for a contact.
+*/
 QStringList Contact::trfields()
 {
     QStringList list;
 
     list.append( QObject::tr( "Name Title") );
     list.append( QObject::tr( "First Name" ) );
     list.append( QObject::tr( "Middle Name" ) );
     list.append( QObject::tr( "Last Name" ) );
@@ -488,45 +945,61 @@ QStringList Contact::trfields()
     list.append( QObject::tr( "Children" ) );
 
     list.append( QObject::tr( "Notes" ) );
     list.append( QObject::tr( "Groups" ) );
 
     return list;
 }
 
-void Contact::setEmails( const QString &v )
+/*!
+  Sets the list of email address for contact to those contained in \a str.
+  Email address should be separated by ';'s.
+*/
+void Contact::setEmails( const QString &str )
 {
-    replace( Qtopia::Emails, v );
-    if ( v.isEmpty() )
+    replace( Qtopia::Emails, str );
+    if ( str.isEmpty() )
         setDefaultEmail( QString::null );
 }
 
-void Contact::setChildren( const QString &v )
+/*!
+  Sets the list of children for the contact to those contained in \a str.
+*/
+void Contact::setChildren( const QString &str )
 {
-    replace( Qtopia::Children, v );
+    replace( Qtopia::Children, str );
 }
 
 // vcard conversion code
+/*!
+  \internal
+*/
 static inline VObject *safeAddPropValue( VObject *o, const char *prop, const QString &value )
 {
     VObject *ret = 0;
     if ( o && !value.isEmpty() )
         ret = addPropValue( o, prop, value.latin1() );
     return ret;
 }
 
+/*!
+  \internal
+*/
 static inline VObject *safeAddProp( VObject *o, const char *prop)
 {
     VObject *ret = 0;
     if ( o )
         ret = addProp( o, prop );
     return ret;
 }
 
+/*!
+  \internal
+*/
 static VObject *createVObject( const Contact &c )
 {
     VObject *vcard = newVObject( VCCardProp );
     safeAddPropValue( vcard, VCVersionProp, "2.1" );
     safeAddPropValue( vcard, VCLastRevisedProp, TimeConversion::toISO8601( QDateTime::currentDateTime() ) );
     safeAddPropValue( vcard, VCUniqueStringProp, QString::number(c.uid()) );
 
     // full name
@@ -617,22 +1090,23 @@ static VObject *createVObject( const Contact &c )
     safeAddPropValue( vcard, "X-Qtopia-Anniversary", c.anniversary() );
     safeAddPropValue( vcard, "X-Qtopia-Nickname", c.nickname() );
     safeAddPropValue( vcard, "X-Qtopia-Children", c.children() );
 
     return vcard;
 }
 
 
+/*!
+  \internal
+*/
 static Contact parseVObject( VObject *obj )
 {
     Contact c;
 
-    bool haveDefaultEmail = FALSE;
-
     VObjectIterator it;
     initPropIterator( &it, obj );
     while( moreIteration( &it ) ) {
         VObject *o = nextVObject( &it );
         QCString name = vObjectName( o );
         QCString value = vObjectStringZValue( o );
         if ( name == VCNameProp ) {
             VObjectIterator nit;
@@ -762,24 +1236,17 @@ static Contact parseVObject( VObject *obj )
                 QCString name = vObjectTypeInfo( o );
                 if ( name != VCInternetProp && name != VCHomeProp &&
                      name != VCWorkProp &&
                      name != VCPreferredProp )
                     // ### preffered should map to default email
                     valid = FALSE;
             }
             if ( valid ) {
-                if ( haveDefaultEmail ) {
-                    QString str = c.emails();
-                    if ( !str.isEmpty() )
-                        str += ","+email;
-                    c.setEmails( str );
-                } else {
-                    c.setDefaultEmail( email );
-                }
+                c.insertEmail( email );
             }
         }
         else if ( name == VCURLProp ) {
             VObjectIterator nit;
             initPropIterator( &nit, o );
             while( moreIteration( &nit ) ) {
                 VObject *o = nextVObject( &nit );
                 QCString name = vObjectTypeInfo( o );
@@ -846,16 +1313,19 @@ static Contact parseVObject( VObject *obj )
             }
         }
 #endif
     }
     c.setFileAs();
     return c;
 }
 
+/*!
+  Writes the list of \a contacts as a set of VCards to the file \a filename.
+*/
 void Contact::writeVCard( const QString &filename, const QValueList<Contact> &contacts)
 {
         QFileDirect f( filename.utf8().data() );
         if ( !f.open( IO_WriteOnly ) ) {
                 qWarning("Unable to open vcard write");
                 return;
         }
 
@@ -863,32 +1333,37 @@ void Contact::writeVCard( const QString &filename, const QValueList<Contact> &co
     for( it = contacts.begin(); it != contacts.end(); ++it ) {
         VObject *obj = createVObject( *it );
         writeVObject(f.directHandle() , obj );
         cleanVObject( obj );
     }
     cleanStrTbl();
 }
 
+/*!
+  writes \a contact as a VCard to the file \a filename.
+*/
 void Contact::writeVCard( const QString &filename, const Contact &contact)
 {
         QFileDirect f( filename.utf8().data() );
         if ( !f.open( IO_WriteOnly ) ) {
                 qWarning("Unable to open vcard write");
                 return;
         }
 
     VObject *obj = createVObject( contact );
         writeVObject( f.directHandle() , obj );
         cleanVObject( obj );
 
         cleanStrTbl();
 }
 
-
+/*!
+  Returns the set of contacts read as VCards from the file \a filename.
+*/
 QValueList<Contact> Contact::readVCard( const QString &filename )
 {
     qDebug("trying to open %s, exists=%d", filename.utf8().data(), QFileInfo( filename.utf8().data() ).size() );
     VObject *obj = Parse_MIME_FromFileName( (char *)filename.utf8().data() );
 
     qDebug("vobject = %p", obj );
 
     QValueList<Contact> contacts;
@@ -899,21 +1374,30 @@ QValueList<Contact> Contact::readVCard( const QString &filename )
         VObject *t = obj;
         obj = nextVObjectInList(obj);
         cleanVObject( t );
     }
 
     return contacts;
 }
 
+/*!
+  Returns TRUE if the contact matches the regular expression \a regexp.
+  Otherwise returns FALSE.
+*/
 bool Contact::match( const QString &regexp ) const
 {
     return match(QRegExp(regexp));
 }
 
+/*!
+  \overload
+  Returns TRUE if the contact matches the regular expression \a regexp.
+  Otherwise returns FALSE.
+*/
 bool Contact::match( const QRegExp &r ) const
 {
     bool match;
     match = false;
     QMap<int, QString>::ConstIterator it;
     for ( it = mMap.begin(); it != mMap.end(); ++it ) {
         if ( (*it).find( r ) > -1 ) {
             match = true;
diff --git a/library/backend/contact.h b/library/backend/contact.h
index a74cbbe..4999430 100644
--- a/library/backend/contact.h
+++ b/library/backend/contact.h
@@ -1,12 +1,12 @@
 /**********************************************************************
-** Copyright (C) 2001 Trolltech AS.  All rights reserved.
+** Copyright (C) 2000-2002 Trolltech AS.  All rights reserved.
 **
-** This file is part of Qtopia Environment.
+** This file is part of the Qtopia Environment.
 **
 ** This file may be distributed and/or modified under the terms of the
 ** GNU General Public License version 2 as published by the Free Software
 ** Foundation and appearing in the file LICENSE.GPL included in the
 ** packaging of this file.
 **
 ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
 ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
@@ -16,24 +16,24 @@
 ** Contact info@trolltech.com if any conditions of this licensing are
 ** not clear to you.
 **
 **********************************************************************/
 
 #ifndef __CONTACT_H__
 #define __CONTACT_H__
 
-#include <qpe/palmtoprecord.h>
-#include <qpe/recordfields.h>
+#include <qtopia/private/palmtoprecord.h>
+#include <qtopia/private/recordfields.h>
 
 #include <qstringlist.h>
 
 #if defined(QPC_TEMPLATEDLL)
 // MOC_SKIP_BEGIN
-template class QPC_EXPORT QMap<int, QString>;
+QPC_TEMPLATEEXTERN template class QPC_EXPORT QMap<int, QString>;
 // MOC_SKIP_END
 #endif
 
 class ContactPrivate;
 class QPC_EXPORT Contact : public Qtopia::Record
 {
     friend class DataSet;
 public:
@@ -51,19 +51,22 @@ public:
     void setFirstName( const QString &v ) { replace( Qtopia::FirstName, v ); }
     void setMiddleName( const QString &v ) { replace( Qtopia::MiddleName, v ); }
     void setLastName( const QString &v ) { replace( Qtopia::LastName, v ); }
     void setSuffix( const QString &v ) { replace( Qtopia::Suffix, v ); }
     void setFileAs( const QString &v ) { replace( Qtopia::FileAs, v ); }
     void setFileAs();
 
     // default email address
-    void setDefaultEmail( const QString &v ) { replace( Qtopia::DefaultEmail, v ); }
-    // the emails should be seperated by a semicolon
-    void setEmails( const QString &v );
+    void setDefaultEmail( const QString &v );
+    // inserts email to list and ensure's doesn't already exist
+    void insertEmail( const QString &v );
+    void removeEmail( const QString &v );
+    void clearEmails();
+    void insertEmails( const QStringList &v );
 
     // home
     void setHomeStreet( const QString &v ) { replace( Qtopia::HomeStreet, v ); }
     void setHomeCity( const QString &v ) { replace( Qtopia::HomeCity, v ); }
     void setHomeState( const QString &v ) { replace( Qtopia::HomeState, v ); }
     void setHomeZip( const QString &v ) { replace( Qtopia::HomeZip, v ); }
     void setHomeCountry( const QString &v ) { replace( Qtopia::HomeCountry, v ); }
     void setHomePhone( const QString &v ) { replace( Qtopia::HomePhone, v ); }
@@ -118,17 +121,16 @@ public:
     QString firstName() const { return find( Qtopia::FirstName ); }
     QString middleName() const { return find( Qtopia::MiddleName ); }
     QString lastName() const { return find( Qtopia::LastName ); }
     QString suffix() const { return find( Qtopia::Suffix ); }
     QString fileAs() const { return find( Qtopia::FileAs ); }
 
     // email
     QString defaultEmail() const { return find( Qtopia::DefaultEmail ); }
-    QString emails() const { return find( Qtopia::Emails ); }
     QStringList emailList() const;
 
     // home
     QString homeStreet() const { return find( Qtopia::HomeStreet ); }
     QString homeCity() const { return find( Qtopia::HomeCity ); }
     QString homeState() const { return find( Qtopia::HomeState ); }
     QString homeZip() const { return find( Qtopia::HomeZip ); }
     QString homeCountry() const { return find( Qtopia::HomeCountry ); }
@@ -197,26 +199,108 @@ public:
     // journaling...
     void saveJournal( journal_action action, const QString &key = QString::null );
     void save( QString &buf ) const;
 
     void setUid( int i )
 { Record::setUid(i); replace( Qtopia::AddressUid , QString::number(i)); }
 
 private:
+    friend class AbEditor;
     friend class AbTable;
+    friend class AddressBookAccessPrivate;
+    friend class XMLIO;
+
+    QString emailSeparator() const { return " "; }
+     // the emails should be seperated by a comma
+    void setEmails( const QString &v );
+    QString emails() const { return find( Qtopia::Emails ); }
+
     void insert( int key, const QString &value );
     void replace( int key, const QString &value );
     QString find( int key ) const;
 
     QString displayAddress( const QString &street,
                             const QString &city,
                             const QString &state,
                             const QString &zip,
                             const QString &country ) const;
 
     Qtopia::UidGen &uidGen() { return sUidGen; }
     static Qtopia::UidGen sUidGen;
     QMap<int, QString> mMap;
     ContactPrivate *d;
 };
 
+// these methods are inlined to keep binary compatability with Qtopia 1.5
+inline void Contact::insertEmail( const QString &v )
+{
+    //qDebug("insertEmail %s", v.latin1());
+    QString e = v.simplifyWhiteSpace();
+    QString def = defaultEmail();
+
+    // if no default, set it as the default email and don't insert
+    if ( def.isEmpty() ) {
+        setDefaultEmail( e ); // will insert into the list for us
+        return;
+    }
+
+    // otherwise, insert assuming doesn't already exist
+    QString emailsStr = find( Qtopia::Emails );
+    if ( emailsStr.contains( e ))
+        return;
+    if ( !emailsStr.isEmpty() )
+        emailsStr += emailSeparator();
+    emailsStr += e;
+    replace( Qtopia::Emails, emailsStr );
+}
+
+inline void Contact::removeEmail( const QString &v )
+{
+    QString e = v.simplifyWhiteSpace();
+    QString def = defaultEmail();
+    QString emailsStr = find( Qtopia::Emails );
+    QStringList emails = emailList();
+        
+    // otherwise, must first contain it
+    if ( !emailsStr.contains( e ) )
+        return;
+
+    // remove it
+    //qDebug(" removing email from list %s", e.latin1());
+    emails.remove( e );
+    // reset the string
+    emailsStr = emails.join(emailSeparator()); // Sharp's brain dead separator
+    replace( Qtopia::Emails, emailsStr );
+
+    // if default, then replace the default email with the first one
+    if ( def == e ) {
+        //qDebug("removeEmail is default; setting new default");
+        if ( !emails.count() )
+            clearEmails();
+        else // setDefaultEmail will remove e from the list
+            setDefaultEmail( emails.first() );
+    }
+}
+inline void Contact::clearEmails()
+{
+    mMap.remove( Qtopia::DefaultEmail );
+    mMap.remove( Qtopia::Emails );
+}
+inline void Contact::setDefaultEmail( const QString &v )
+{
+    QString e = v.simplifyWhiteSpace();
+
+    //qDebug("Contact::setDefaultEmail %s", e.latin1());
+    replace( Qtopia::DefaultEmail, e );
+
+            if ( !e.isEmpty() )
+        insertEmail( e );
+        
+}
+
+inline void Contact::insertEmails( const QStringList &v )
+{
+    for ( QStringList::ConstIterator it = v.begin(); it != v.end(); ++it )
+        insertEmail( *it );
+}
+
 #endif
diff --git a/library/backend/event.cpp b/library/backend/event.cpp
index 50a663d..7110717 100644
--- a/library/backend/event.cpp
+++ b/library/backend/event.cpp
@@ -1,33 +1,33 @@
 /**********************************************************************
-** Copyright (C) 2001 Trolltech AS.  All rights reserved.
+** Copyright (C) 2000-2002 Trolltech AS.  All rights reserved.
 **
-** This file is part of Qtopia Environment.
+** This file is part of the Qtopia Environment.
 **
 ** This file may be distributed and/or modified under the terms of the
 ** GNU General Public License version 2 as published by the Free Software
 ** Foundation and appearing in the file LICENSE.GPL included in the
 ** packaging of this file.
 **
 ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
 ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 **
 ** See http://www.trolltech.com/gpl/ for GPL licensing information.
 **
 ** Contact info@trolltech.com if any conditions of this licensing are
 ** not clear to you.
 **
 **********************************************************************/
 
-#include "event.h"

+#include "event.h"
 #include "qfiledirect_p.h"
-#include <qpe/timeconversion.h>
-#include <qpe/stringutil.h>
-#include <qpe/recordfields.h>
+#include <qtopia/timeconversion.h>
+#include <qtopia/stringutil.h>
+#include <qtopia/private/recordfields.h>
 #include <qbuffer.h>
 #include <time.h>
 #include "vobject_p.h"
 
 #include <stdio.h>
 
 using namespace Qtopia;
 
@@ -66,28 +66,280 @@ static void write( QString& buf, const Event::RepeatPattern &r )
         buf += " enddt=\""
                + QString::number( r.endDateUTC ? r.endDateUTC : time( 0 ) )
                + "\"";
     buf += " created=\"" + QString::number( r.createTime ) + "\"";
 }
 
 Qtopia::UidGen Event::sUidGen( Qtopia::UidGen::Qtopia );
 
+/*!
+  \class Event event.h
+  \brief The Event class holds the data of a calendar event.
+
+  This data includes descriptive data of the event and schedualing information.
+
+  \ingroup qtopiaemb
+  \ingroup qtopiadesktop
+*/
+
+/*!
+  \class Event::RepeatPattern
+  \class The Event::RepeatPattern class is internal.
+  \internal
+*/
+
+/*!
+  \enum Event::Days
+  \internal
+*/
+
+/*!
+  \enum Event::Type
+  \internal
+*/
+
+/*!
+  \enum Event::SoundTypeChoice
+
+  This enum type defines what kind of sound is made when an alarm occurs
+  for an event.  The currently defined types are:
+
+  <ul>
+  <li>\c Silent - No sound is produced.
+  <li>\c Loud - A loud sound is produced.
+  </ul>
+*/
+
+/*!
+  \fn bool Event::operator<( const Event & ) const
+  \internal
+*/
+
+/*!
+  \fn bool Event::operator<=( const Event & ) const
+  \internal
+*/
+
+/*!
+  \fn bool Event::operator!=( const Event & ) const
+  \internal
+*/
+
+/*!
+  \fn bool Event::operator>( const Event & ) const
+  \internal
+*/
+
+/*!
+  \fn bool Event::operator>=( const Event & ) const
+  \internal
+*/
+
+/*!
+  \enum Event::RepeatType
+
+  This enum defines how a event will repeat, if at all.
+
+  <ul>
+  <li>\c NoRepeat - Event does not repeat.
+  <li>\c Daily - Event occurs every n days.
+  <li>\c Weekly - Event occurs every n weeks.
+  <li>\c MonthlyDay - Event occurs every n months.  Event will always occur in
+  the same week and same day of week as the first event.
+  <li>\c MonthlyDate - Event occurs every n months.  Event will always occur
+  on the same day of the month as the first event.
+  <li>\c Yearly - Event occurs every n years.
+  </ul>
+*/
+
+/*!
+  \fn bool Event::isAllDay() const
+
+  Returns TRUE if the event is an all day event.  Otherwise returns FALSE.
+*/
+
+/*!
+  \fn void Event::setAllDay(bool allday)
+
+  If \a allday is TRUE, will set the event to be an all day event.
+  Otherwise sets the event to not be an all day event.
+
+  \warning This function may affect the start and end times of the event.
+*/
+
+/*!
+  \fn QDateTime Event::start() const
+
+  Returns the start date and time of the first occurance of the event.
+*/
+
+/*!
+  \fn QDateTime Event::end() const
+
+  Returns the end date and time of the first occurance of the event.
+*/
+
+/*!
+  \fn time_t Event::startTime() const
+  \internal
+*/
+
+/*!
+  \fn time_t Event::endTime() const
+  \internal
+*/
+
+/*!
+  \fn void Event::setAlarm(int delay, SoundTypeChoice s)
+
+  Sets the alarm delay of the event to \a delay and the sound type of the
+  alarm to \a s.
+*/
+
+/*!
+  \fn void Event::clearAlarm()
+
+  Clears the alarm for the event.
+*/
+
+/*!
+  \fn int Event::alarmDelay() const
+
+  Returns the delay in minutes between the alarm for an event and the
+  start of the event.
+*/
+
+/*!
+  \fn Event::RepeatType Event::repeatType() const
+
+  Returns the repeat pattern type for the event.
+
+  \sa frequency()
+*/
+
+/*!
+  \fn int Event::weekOffset() const
+
+  Returns the number of weeks from the start of the month that this event
+  occurs.
+*/
+
+/*!
+  \fn QDate Event::repeatTill() const
+
+  Returns the date that the event will continue to repeat until.  If the event
+  repeats forever the value returned is undefined.
+
+  \sa repeatForever()
+*/
+
+/*!
+  \fn bool Event::repeatForever() const
+
+  Returns FALSE if there is a date set for the event to continue until.
+  Otherwise returns TRUE.
+*/
+
+/*!
+  \fn bool Event::doRepeat() const
+  \internal
+*/
+
+/*!
+  \fn bool Event::repeatOnWeekDay(int day) const
+
+  Returns TRUE if the event has a RepeatType of Weekly and is set to occur on
+  \a day each week.  Otherwise returns FALSE.
+
+  \sa QDate::dayName()
+*/
+
+/*!
+  \fn void Event::setRepeatOnWeekDay(int day, bool enable)
+
+  If \a enable is TRUE then sets the event to occur on \a day each week.
+  Otherwise sets the event not to occur on \a day.
+
+  \warning this function is only relavent for a event with RepeatType of
+  Weekly.
+
+  \sa QDate::dayName()
+*/
+
+/*!
+  \fn int Event::frequency() const
+
+  Returns how often the event repeats.
+
+  \sa repeatType()
+*/
+
+/*!
+  \fn void Event::setRepeatType(RepeatType t)
+
+  Sets the repeat pattern type of the event to \a t.
+
+  \sa setFrequency()
+*/
+
+/*!
+  \fn void Event::setFrequency(int n)
+
+  Sets how often the event occurs with in its repeat pattern.
+
+  \sa setRepeatType()
+*/
+
+/*!
+  \fn void Event::setRepeatTill(const QDate &d)
+
+  Sets the event to repeat until \a d.
+*/
+
+/*!
+  \fn void Event::setRepeatForever(bool enable)
+
+  If \a enable is TRUE, sets the event to repeat forever.  Otherwise
+  sets the event to stop repeating at some date.
+
+  \warning This function may affect the specific date the event will repeat
+  till.
+*/
+
+/*!
+  \fn bool Event::match(const QRegExp &r) const
+
+  Returns TRUE if the event matches the regular expression \a r.
+  Otherwise returns FALSE.
+*/
+
+/*!
+  \fn char Event::day(int)
+  \internal
+*/
+
+/*!
+  Creates a new, empty event.
+*/
 Event::Event() : Record()
 {
     startUTC = endUTC = time( 0 );
     typ = Normal;
     hAlarm = FALSE;
     hRepeat = FALSE;
     aMinutes = 0;
     aSound = Silent;
     pattern.type = NoRepeat;
     pattern.frequency = -1;
 }
 
+/*!
+  \internal
+*/
 Event::Event( const QMap<int, QString> &map )
 {
     setDescription( map[DatebookDescription] );
     setLocation( map[Location] );
     setCategories( idsFromString( map[DatebookCategory] ) );
     setTimeZone( map[TimeZone] );
     setNotes( map[Note] );
     setStart( TimeConversion::fromUTC( map[StartDateTime].toUInt() ) );
@@ -101,66 +353,91 @@ Event::Event( const QMap<int, QString> &map )
     p.days = map[ RepeatPatternDays ].toInt();
     p.hasEndDate = map[ RepeatPatternHasEndDate ].toInt();
     p.endDateUTC = map[ RepeatPatternEndDate ].toUInt();
     setRepeat( p );
 
     setUid( map[ DatebookUid ].toInt() );
 }
 
+/*!
+  Destroys an event.
+*/
 Event::~Event()
 {
 }
 
+/*!
+  \internal
+*/
 int Event::week( const QDate& date )
 {
     // Calculates the week this date is in within that
     // month. Equals the "row" is is in in the month view
     int week = 1;
     QDate tmp( date.year(), date.month(), 1 );
 
     if ( date.dayOfWeek() < tmp.dayOfWeek() )
         ++week;
 
     week += ( date.day() - 1 ) / 7;
     return week;
 }
 
+/*!
+  \internal
+*/
 int Event::occurrence( const QDate& date )
 {
     // calculates the number of occurrances of this day of the
     // week till the given date (e.g 3rd Wednesday of the month)
     return ( date.day() - 1 ) / 7 + 1;
 }
 
+/*!
+  \internal
+*/
 int Event::dayOfWeek( char day )
 {
     int dayOfWeek = 1;
     char i = Event::MON;
     while ( !( i & day ) && i <= Event::SUN ) {
         i <<= 1;
         ++dayOfWeek;
     }
     return dayOfWeek;
 }
 
+/*!
+  \internal
+*/
 int Event::monthDiff( const QDate& first, const QDate& second )
 {
     return ( second.year() - first.year() ) * 12 +
         second.month() - first.month();
 }
 
+/*!
+  \internal
+*/
 QMap<int, QString> Event::toMap() const
 {
     QMap<int, QString> m;
-    m.insert( DatebookDescription, description() );
-    m.insert ( Location, location() );
-    m.insert ( DatebookCategory, idsToString( categories() ) );
-    m.insert ( TimeZone, timeZone() );
-    m.insert ( Note, notes() );
+
+    if ( !description().isEmpty() )
+        m.insert( DatebookDescription, description() );
+            if ( !location().isEmpty() )
+        m.insert ( Location, location() );
+    if ( categories().count() )
+        m.insert ( DatebookCategory, idsToString( categories() ) );
+    if ( !timeZone().isEmpty() )
+        m.insert ( TimeZone, timeZone() );
+    if ( !notes().isEmpty() )
+        m.insert ( Note, notes() );
+
     m.insert ( StartDateTime, QString::number( TimeConversion::toUTC( start() ) ) );
     m.insert ( EndDateTime, QString::number( TimeConversion::toUTC( end() ) ) );
     m.insert ( DatebookType, QString::number( (int)type() ) );
     m.insert ( HasAlarm, ( hasAlarm() ? "1" : "0" ) );
     m.insert ( SoundType, QString::number( (int)alarmSound() ) );
     m.insert ( AlarmTime, QString::number( alarmTime() ) );
     m.insert ( RepeatPatternType, QString::number( static_cast<int>( repeatPattern().type ) ) );
     m.insert ( RepeatPatternFrequency, QString::number( repeatPattern().frequency ) );
@@ -169,185 +446,271 @@ QMap<int, QString> Event::toMap() const
     m.insert ( RepeatPatternHasEndDate, QString::number( static_cast<int>( repeatPattern().hasEndDate ) ) );
     m.insert ( RepeatPatternEndDate, QString::number( repeatPattern().endDateUTC ) );
 
     m.insert( DatebookUid, QString::number( uid()) );
 
     return m;
 }
 
+/*!
+  \internal
+*/
 void Event::setRepeat( const RepeatPattern &p )
 {
     setRepeat( p.type != NoRepeat, p );
 }
 
+/*!
+  Sets the description of the event to \a s.
+*/
 void Event::setDescription( const QString &s )
 {
     descript = s;
 }
 
+/*!
+  Sets the location of the event to \a s.
+*/
 void Event::setLocation( const QString &s )
 {
     locat = s;
 }
 
 // void Event::setCategory( const QString &s )
 // {
 //     categ = s;
 // }
 
+/*!
+  \internal
+*/
 void Event::setType( Type t )
 {
     typ = t;
 }
 
+/*!
+  Sets the start date and time of the first or only occurance of this event
+  to the date and time \a d. \a d should be in local time.
+*/
 void Event::setStart( const QDateTime &d )
 {
     startUTC = TimeConversion::toUTC( d );
 }
 
+/*!
+  \internal
+*/
 void Event::setStart( time_t time )
 {
     startUTC = time;
 }
 
+/*!
+  Sets the end date and time of the first or only occurance of this event
+  to the date and time \a d.  \a d should be in local time.
+*/
 void Event::setEnd( const QDateTime &d )
 {
     endUTC = TimeConversion::toUTC( d );
 }
 
+/*!
+  \internal
+*/
 void Event::setEnd( time_t time )
 {
     endUTC = time;
 }
 
+/*!
+  \internal
+*/
 void Event::setTimeZone( const QString &z )
 {
     tz = z;
 }
 
+/*!
+  \internal
+*/
 void Event::setAlarm( bool b, int minutes, SoundTypeChoice s )
 {
     hAlarm = b;
     aMinutes = minutes;
     aSound = s;
 }
 
+/*!
+  \internal
+*/
 void Event::setRepeat( bool b, const RepeatPattern &p )
 {
     hRepeat = b;
     pattern = p;
 }
 
+/*!
+  Sets the notes for the event to \a n.
+*/
 void Event::setNotes( const QString &n )
 {
     note = n;
 }
 
+/*!
+  Returns the description of the event.
+*/
 const QString &Event::description() const
 {
     return descript;
 }
 
+/*!
+  Returns the location of the event.
+*/
 const QString &Event::location() const
 {
     return locat;
 }
 
 // QString Event::category() const
 // {
 //     return categ;
 // }
 
+/*!
+  \internal
+*/
 Event::Type Event::type() const
 {
     return typ;
 }
 
+/*!
+  \internal
+*/
 QDateTime Event::start( bool actual ) const
 {
     QDateTime dt = (startUTC > 0) ? TimeConversion::fromUTC( startUTC ) : QDateTime::currentDateTime();
 
     if ( actual && typ == AllDay ) {
         QTime t = dt.time();
         t.setHMS( 0, 0, 0 );
         dt.setTime( t );
     }
     return dt;
 }
 
+/*!
+  \internal
+*/
 QDateTime Event::end( bool actual ) const
 {
     QDateTime dt = (endUTC > 0) ? TimeConversion::fromUTC( endUTC ) : QDateTime::currentDateTime();
 
     if ( actual && typ == AllDay ) {
         QTime t = dt.time();
         t.setHMS( 23, 59, 59 );
         dt.setTime( t );
     }
     return dt;
 }
 
+/*!
+  \internal
+*/
 const QString &Event::timeZone() const
 {
     return tz;
 }
 
+/*!
+  \internal
+*/
 bool Event::hasAlarm() const
 {
     return hAlarm;
 }
 
+/*!
+  \internal
+*/
 int Event::alarmTime() const
 {
     return aMinutes;
 }
 
+/*!
+  Returns the sound type for the alarm of this event.
+*/
 Event::SoundTypeChoice Event::alarmSound() const
 {
     return aSound;
 }
 
+/*!
+  \internal
+*/
 bool Event::hasRepeat() const
 {
     return doRepeat();
 }
 
+/*!
+  \internal
+*/
 const Event::RepeatPattern &Event::repeatPattern() const
 {
     return pattern;
 }
 
+/*!
+  \internal
+*/
 Event::RepeatPattern &Event::repeatPattern()
 {
     return pattern;
 }
 
+/*!
+  Returns the notes for the event.
+*/
 const QString &Event::notes() const
 {
     return note;
 }
 
+/*!
+  \internal
+*/
 bool Event::operator==( const Event &e ) const
 {
+    if ( uid() && e.uid() == uid() )
+        return TRUE;
     return ( e.descript == descript &&
              e.locat == locat &&
              e.categ == categ &&
              e.typ == typ &&
              e.startUTC == startUTC &&
              e.endUTC == endUTC &&
              e.tz == tz &&
              e.hAlarm == hAlarm &&
              e.aMinutes == aMinutes &&
              e.aSound == aSound &&
              e.hRepeat == hRepeat &&
              e.pattern == pattern &&
              e.note == note );
 }
 
+/*!
+  \internal
+  Appends the contact information to \a buf.
+*/
 void Event::save( QString& buf )
 {
     buf += " description=\"" + Qtopia::escapeString(descript) + "\"";
     if ( !locat.isEmpty() )
         buf += " location=\"" + Qtopia::escapeString(locat) + "\"";
     // save the categoies differently....
     QString strCats = idsToString( categories() );
     buf += " categories=\"" + Qtopia::escapeString(strCats) + "\"";
@@ -373,67 +736,103 @@ void Event::save( QString& buf )
            + QString::number( endUTC )
            + "\"";
 
     if ( !note.isEmpty() )
         buf += " note=\"" + Qtopia::escapeString( note ) + "\"";
     buf += customToXml();
 }
 
+/*!
+  \internal
+*/
 bool Event::RepeatPattern::operator==( const Event::RepeatPattern &right ) const
 {
     // *sigh*
     return ( type == right.type
              && frequency == right.frequency
              && position == right.position
              && days == right.days
              && hasEndDate == right.hasEndDate
              && endDateUTC == right.endDateUTC
              && createTime == right.createTime );
 }
 
+/*!
+  \class EffectiveEvent
+  \brief The EffectiveEvent class the data for a single occurance of an event.
+
+  This class describes the event for a single occurance of it.  For example if
+  an Event occurs every week, the effective event might represent the third
+  occurance of this Event.
+
+  \ingroup qtopiaemb
+  \ingroup qtopiadesktop
+  \warning This class will be phased out in Qtopia 3.x
+*/
+
+/*!
+  \enum EffectiveEvent::Position
+  \internal
+*/
+
+/*!
+  \fn EffectiveEvent &EffectiveEvent::operator=(const EffectiveEvent &)
+  \internal
+*/
 
 class EffectiveEventPrivate
 {
 public:
     //currently the existence of the d pointer means multi-day repeating,
     //msut be changed if we use the d pointer for anything else.
     QDate startDate;
     QDate endDate;
 };
 
-
+/*!
+  \internal
+*/
 EffectiveEvent::EffectiveEvent()
 {
     mDate = QDate::currentDate();
     mStart = mEnd = QTime::currentTime();
     d = 0;
 }
 
+/*!
+  \internal
+*/
 EffectiveEvent::EffectiveEvent( const Event &e, const QDate &date, Position pos )
 {
     mEvent = e;
     mDate = date;
     if ( pos & Start )
         mStart = e.start( TRUE ).time();
     else
         mStart = QTime( 0, 0, 0 );
 
     if ( pos & End )
         mEnd = e.end( TRUE ).time();
     else
         mEnd = QTime( 23, 59, 59 );
     d = 0;
 }
 
+/*!
+  \internal
+*/
 EffectiveEvent::~EffectiveEvent()
 {
     delete d;
 }
 
+/*!
+  \internal
+*/
 EffectiveEvent::EffectiveEvent( const EffectiveEvent &e )
 {
     d = 0;
     *this = e;
 }
 
 EffectiveEvent& EffectiveEvent::operator=( const EffectiveEvent & e )
 {
@@ -456,148 +855,214 @@ EffectiveEvent& EffectiveEvent::operator=( const EffectiveEvent & e )
 
 }
 
 // QString EffectiveEvent::category() const
 // {
 //     return mEvent.category();
 // }
 
+/*!
+  Returns the description of the event for this effective event.
+*/
 const QString &EffectiveEvent::description( ) const
 {
     return mEvent.description();
 }
 
+/*!
+\internal
+*/
 const QString &EffectiveEvent::location( ) const
 {
     return mEvent.location();
 }
 
+/*!
+\internal
+*/
 const QString &EffectiveEvent::notes() const
 {
     return mEvent.notes();
 }
 
+/*!
+  Returns the event associated with this effective event.
+*/
 const Event &EffectiveEvent::event() const
 {
     return mEvent;
 }
 
+/*!
+  \internal
+*/
 const QTime &EffectiveEvent::end() const
 {
     return mEnd;
 }
 
+/*!
+  \internal
+*/
 const QTime &EffectiveEvent::start() const
 {
     return mStart;
 }
 
+/*!
+  Returns the date the effective event occurs on.
+*/
 const QDate &EffectiveEvent::date() const
 {
     return mDate;
 }
 
+/*!
+  \internal
+*/
 int EffectiveEvent::length() const
 {
     return (mEnd.hour() * 60 - mStart.hour() * 60)
            + QABS(mStart.minute() - mEnd.minute() );
 }
 
+/*!
+  \internal
+*/
 void EffectiveEvent::setDate( const QDate &dt )
 {
     mDate = dt;
 }
 
+/*!
+  \internal
+*/
 void EffectiveEvent::setStart( const QTime &start )
 {
     mStart = start;
 }
 
+/*!
+  \internal
+*/
 void EffectiveEvent::setEnd( const QTime &end )
 {
     mEnd = end;
 }
 
+/*!
+  \internal
+*/
 void EffectiveEvent::setEvent( Event e )
 {
     mEvent = e;
 }
 
+/*!
+  \internal
+*/
 bool EffectiveEvent::operator<( const EffectiveEvent &e ) const
 {
     if ( mDate < e.date() )
         return TRUE;
     if ( mDate == e.date() )
         return ( mStart < e.start() );
     else
         return FALSE;
 }
 
+/*!
+  \internal
+*/
 bool EffectiveEvent::operator<=( const EffectiveEvent &e ) const
 {
     return (mDate <= e.date() );
 }
 
+/*!
+  \internal
+*/
 bool EffectiveEvent::operator==( const EffectiveEvent &e ) const
 {
     return ( mDate == e.date()
              && mStart == e.start()
              && mEnd == e.end()
              && mEvent == e.event() );
 }
 
+/*!
+  \internal
+*/
 bool EffectiveEvent::operator!=( const EffectiveEvent &e ) const
 {
     return !(*this == e);
 }
 
+/*!
+  \internal
+*/
 bool EffectiveEvent::operator>( const EffectiveEvent &e ) const
 {
     return !(*this <= e );
 }
 
+/*!
+  \internal
+*/
 bool EffectiveEvent::operator>=(const EffectiveEvent &e) const
 {
     return !(*this < e);
 }
 
+/*!
+  \internal
+*/
 void EffectiveEvent::setEffectiveDates( const QDate &from, const QDate &to )
 {
     if ( !from.isValid() ) {
         delete d;
         d = 0;
         return;
     }
     if ( !d )
         d = new EffectiveEventPrivate;
     d->startDate = from;
     d->endDate = to;
 }
 
+/*!
+  \internal
+*/
 QDate EffectiveEvent::startDate() const
 {
     if ( d )
         return d->startDate;
     else if ( mEvent.hasRepeat() )
         return mDate; // single day, since multi-day should have a d pointer
     else
         return mEvent.start().date();
 }
 
+/*!
+  \internal
+*/
 QDate EffectiveEvent::endDate() const
 {
     if ( d )
         return d->endDate;
     else if ( mEvent.hasRepeat() )
         return mDate; // single day, since multi-day should have a d pointer
     else
         return mEvent.end().date();
 }
 
+/*!
+  \internal
+*/
 int EffectiveEvent::size() const
 {
     return ( mEnd.hour() - mStart.hour() ) * 3600
              + (mEnd.minute() - mStart.minute() * 60
              + mEnd.second() - mStart.second() );
 }
 
 
@@ -735,51 +1200,71 @@ static Event parseVObject( VObject *obj )
     if ( haveAlarm ) {
         int minutes = alarmTime.secsTo( e.start() ) / 60;
         e.setAlarm( TRUE, minutes, soundType );
     }
     return e;
 }
 
 
-
+/*!
+    Writes the list of \a events as a set of VCards to the file \a filename.
+*/
 void Event::writeVCalendar( const QString &filename, const QValueList<Event> &events)
-{

-        QFileDirect f( filename.utf8().data() );

-        if ( !f.open( IO_WriteOnly ) ) {

-                qWarning("Unable to open vcard write");

-                return;

-        }

+{
+
+        QFileDirect f( filename.utf8().data() );
+
+        if ( !f.open( IO_WriteOnly ) ) {
+
+                qWarning("Unable to open vcard write");
+
+                return;
+
+        }
+
 
     QValueList<Event>::ConstIterator it;
     for( it = events.begin(); it != events.end(); ++it ) {
         VObject *obj = createVObject( *it );
         writeVObject( f.directHandle() , obj );
         cleanVObject( obj );
-    }

+    }
+
 
     cleanStrTbl();
 }
 
+/*!
+    Writes \a event as a VCard to the file \a filename.
+*/
 void Event::writeVCalendar( const QString &filename, const Event &event)
-{

-        QFileDirect f( filename.utf8().data() );

-        if ( !f.open( IO_WriteOnly ) ) {

-                qWarning("Unable to open vcard write");

-                return;

-        }

+{
+
+        QFileDirect f( filename.utf8().data() );
+
+        if ( !f.open( IO_WriteOnly ) ) {
+
+                qWarning("Unable to open vcard write");
+
+                return;
+
+        }
+
 
     VObject *obj = createVObject( event );
         writeVObject( f.directHandle() , obj );
         cleanVObject( obj );
 
         cleanStrTbl();
 }
 
-
+/*!
+    Returns the set of events read as VCards from the file \a filename.
+*/
 QValueList<Event> Event::readVCalendar( const QString &filename )
 {
     VObject *obj = Parse_MIME_FromFileName( (char *)filename.utf8().data() );
 
     QValueList<Event> events;
 
     while ( obj ) {
         QCString name = vObjectName( obj );
diff --git a/library/backend/event.h b/library/backend/event.h
index 277aadd..7fe41a5 100644
--- a/library/backend/event.h
+++ b/library/backend/event.h
@@ -1,12 +1,12 @@
 /**********************************************************************
-** Copyright (C) 2001 Trolltech AS.  All rights reserved.
+** Copyright (C) 2000-2002 Trolltech AS.  All rights reserved.
 **
-** This file is part of Qtopia Environment.
+** This file is part of the Qtopia Environment.
 **
 ** This file may be distributed and/or modified under the terms of the
 ** GNU General Public License version 2 as published by the Free Software
 ** Foundation and appearing in the file LICENSE.GPL included in the
 ** packaging of this file.
 **
 ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
 ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
@@ -18,32 +18,41 @@
 **
 **********************************************************************/
 
 #ifndef __EVENT_H__
 #define __EVENT_H__
 
 #include <qdatetime.h>
 #include <qvaluelist.h>
+#include <qcolor.h>
 
 #ifdef PALMTOPCENTER
 #include <qpc/qsorter.h>
 #endif
-#include <qpe/palmtoprecord.h>
+#include <qtopia/private/palmtoprecord.h>
 
 #include <qpe/timeconversion.h>
 
+static const QColor colorNormal      = QColor(255, 0  , 0  );
+static const QColor colorRepeat      = QColor(0  , 0  , 255);
+static const QColor colorNormalLight = QColor(255, 220, 220);
+static const QColor colorRepeatLight = QColor(200, 200, 255);
+
 class EventPrivate;
 class QPC_EXPORT Event : public Qtopia::Record
 {
 public:
     enum RepeatType { NoRepeat = -1, Daily, Weekly, MonthlyDay,
                       MonthlyDate, Yearly };
+
+    // Don't use this.
     enum Days { MON = 0x01, TUE = 0x02, WED = 0x04, THU = 0x08,
                 FRI = 0x10, SAT = 0x20, SUN = 0x40 };
+    // Don't use this.
     struct QPC_EXPORT RepeatPattern
     {
         RepeatPattern() {
             type = NoRepeat; frequency = -1; days = 0;  position = 0; createTime = -1;
             hasEndDate = FALSE; endDateUTC = 0; }
         bool operator ==( const RepeatPattern &right ) const;
 
         RepeatType type;
@@ -65,70 +74,99 @@ public:
 
     static void writeVCalendar( const QString &filename, const QValueList<Event> &events);
     static void writeVCalendar( const QString &filename, const Event &event);
     static QValueList<Event> readVCalendar( const QString &filename );
 
     enum Type { Normal, AllDay };
     enum SoundTypeChoice { Silent, Loud };
 
+    // Don't use these, there are essentially meaningless.
     bool operator<( const Event &e1) const { return start() < e1.start(); };
     bool operator<=( const Event &e1 ) const { return start() <= e1.start(); };
     bool operator!=( const Event &e1 ) const { return !( *this == e1 ); };
     bool operator>( const Event &e1 ) const { return start() > e1.start(); };
     bool operator>=(const Event &e1 ) const { return start() >= e1.start(); };
     bool operator==( const Event &e ) const;
 
     void setDescription( const QString &s );
     const QString &description() const;
 
     void setLocation( const QString &s );
     const QString &location() const;
 
-    void setType( Type t );
-    Type type() const;
+    void setNotes( const QString &n );
+    const QString &notes() const;
+
+    void setType( Type t ); // Don't use me.
+    Type type() const; // Don't use me.
+
+    void setAllDay(bool);
+    bool isAllDay() const;
+
     void setStart( const QDateTime &d );
-    void setStart( time_t time );
-    QDateTime start( bool actual = FALSE ) const;
-    time_t startTime() const { return startUTC; }
+    void setStart( time_t time ); // don't use me.
+    QDateTime start( ) const;
+    QDateTime start( bool actual ) const; // don't use me.
+    time_t startTime() const { return startUTC; } // don't use me.
     void setEnd( const QDateTime &e );
-    void setEnd( time_t time );
-    QDateTime end( bool actual = FALSE ) const;
-    time_t endTime() const { return endUTC; }
+    void setEnd( time_t time ); // don't use me
+    QDateTime end( ) const;
+    QDateTime end( bool actual ) const; // don't use me.
+    time_t endTime() const { return endUTC; } // don't use me.
     void setTimeZone( const QString & );
     const QString &timeZone() const;
-    void setAlarm( bool b, int minutes, SoundTypeChoice );
+    void setAlarm( int minutes, SoundTypeChoice );
+    void clearAlarm();
+    void setAlarm( bool b, int minutes, SoundTypeChoice ); // Don't use me.
     bool hasAlarm() const;
-    int alarmTime() const;
+    int alarmDelay() const;
+    int alarmTime() const; // Don't use me.
     SoundTypeChoice alarmSound() const;
+
+    RepeatType repeatType() const;
+    int frequency() const;
+    int weekOffset() const;
+    QDate repeatTill() const;
+    bool repeatForever() const;
+    bool repeatOnWeekDay(int day) const;
+
+    void setRepeatType(RepeatType);
+    void setFrequency(int);
+    void setRepeatTill(const QDate &);
+    void setRepeatForever(bool);
+    void setRepeatOnWeekDay(int day, bool enable);
+
+    // Don't use any of these.
     void setRepeat( bool b, const RepeatPattern &p );
     void setRepeat( const RepeatPattern &p );
     bool hasRepeat() const;
     const RepeatPattern &repeatPattern() const;
     RepeatPattern &repeatPattern();
-    void setNotes( const QString &n );
-    const QString &notes() const;
     bool doRepeat() const { return pattern.type != NoRepeat; }
 
     void save( QString& buf );
     //void load( Node *n );
 
+    bool match( const QRegExp &r ) const;
+
+    // Don't use these either.  Functionality will be moved elsewhere.
+
     // helper function to calculate the week of the given date
     static int week( const QDate& date );
     // calculates the number of occurrences of the week day of
     // the given date from the start of the month
     static int occurrence( const QDate& date );
     // returns a proper days-char for a given dayOfWeek()
     static char day( int dayOfWeek ) { return 1 << ( dayOfWeek - 1 ); }
     // returns the dayOfWeek for the *first* day it finds (ignores
     // any further days!). Returns 1 (Monday) if there isn't any day found
     static int dayOfWeek( char day );
     // returns the difference of months from first to second.
     static int monthDiff( const QDate& first, const QDate& second );
-    bool match( const QRegExp &r ) const;
 
 private:
     Qtopia::UidGen &uidGen() { return sUidGen; }
     static Qtopia::UidGen sUidGen;
 
     QString descript, locat, categ;
     Type typ : 4;
     bool startTimeDirty : 1;
@@ -206,16 +244,119 @@ private:
     class EffectiveEventPrivate *d;
     Event mEvent;
     QDate mDate;
     QTime mStart,
           mEnd;
 
 };
 
+inline void Event::setAlarm( int minutes, SoundTypeChoice s )
+{
+    setAlarm(TRUE, minutes, s);
+}
+
+inline void Event::clearAlarm()
+{
+    setAlarm(FALSE, 0, Silent);
+}
+
+inline int Event::alarmDelay() const
+{
+    return alarmTime();
+}
+
+inline void Event::setAllDay(bool enable)
+{
+    if (enable)
+        setType(AllDay);
+    else 
+        setType(Normal);
+}; 
+
+inline bool Event::isAllDay() const
+{
+    return type() == AllDay;
+}
+
+inline Event::RepeatType Event::repeatType() const
+{
+    return repeatPattern().type;
+}
+
+inline int Event::frequency() const
+{
+    return repeatPattern().frequency;
+}
+
+inline int Event::weekOffset() const
+{
+    if (start().date().day() == 1)
+        return 1;
+    return (start().date().day() - 1) / 7 + 1;
+}
+
+inline QDate Event::repeatTill() const
+{
+    return repeatPattern().endDate();
+}
+
+inline bool Event::repeatForever() const
+{
+    return !repeatPattern().hasEndDate;
+}
+
+inline void Event::setRepeatType(RepeatType t)
+{
+    pattern.type = t;
+}
+
+inline void Event::setFrequency(int f)
+{
+    pattern.frequency = f;
+}
+
+inline void Event::setRepeatTill(const QDate &d)
+{
+    pattern.setEndDate(d);
+    pattern.hasEndDate = TRUE;
+}
+
+inline void Event::setRepeatForever(bool b)
+{
+    if (!b == pattern.hasEndDate)
+        return;
+    if (!b && !pattern.hasEndDate)
+        pattern.setEndDate(end().date());
+    pattern.hasEndDate = !b;
+}
+
+inline bool Event::repeatOnWeekDay(int day) const
+{
+    if (pattern.type != Weekly)
+        return FALSE;
+    return ( (1 << (day - 1)) & pattern.days ) != 0;
+}
+
+inline void Event::setRepeatOnWeekDay(int day, bool enable)
+{
+    if ( repeatOnWeekDay( day ) != enable )
+        pattern.days ^= 1 << (day - 1);
+}
+
+inline QDateTime Event::start( ) const
+{
+    return start(FALSE);
+}
+
+inline QDateTime Event::end( ) const
+{
+    return end(FALSE);
+}
+
 #ifdef PALMTOPCENTER
 class QPC_EXPORT EffectiveEventSizeSorter : public QSorter<EffectiveEvent>
 {
 public:
     int compare( const EffectiveEvent& a, const EffectiveEvent& b ) const
     {
         return a.size() - b.size();
     }
diff --git a/library/backend/palmtoprecord.cpp b/library/backend/palmtoprecord.cpp
index 0d57699..3cfa874 100644
--- a/library/backend/palmtoprecord.cpp
+++ b/library/backend/palmtoprecord.cpp
@@ -1,34 +1,45 @@
 /**********************************************************************
-** Copyright (C) 2000 Trolltech AS.  All rights reserved.
+** Copyright (C) 2000-2002 Trolltech AS.  All rights reserved.
 **
-** This file is part of Qtopia Environment.
+** This file is part of the Qtopia Environment.
 **
 ** This file may be distributed and/or modified under the terms of the
-** GNU General Public License version 2 as published by the Free
-** Software Foundation and appearing in the file LICENSE.GPL included
-** in the packaging of this file.
+** GNU General Public License version 2 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file.
 **
-** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING
-** THE WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A
-** PARTICULAR PURPOSE.
+** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
+** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 **
 ** See http://www.trolltech.com/gpl/ for GPL licensing information.
 **
 ** Contact info@trolltech.com if any conditions of this licensing are
 ** not clear to you.
 **
 **********************************************************************/
-#include "palmtoprecord.h"
-#include "stringutil.h"
+#include <qtopia/private/palmtoprecord.h>
+#include <qtopia/stringutil.h>
 #include <qstringlist.h>
 
+/*! \class Qtopia::PalmtopRecord palmtoprecord.h
+  \brief The Qtopia::PalmtopRecord class is the base class for all PIM records.
+
+  Provides unique id and category support for all PIM records.
+
+  \ingroup qtopiaemb
+  \ingroup qtopiadesktop
+*/
+
+
 namespace Qtopia {
 
+
+
 Record &Record::operator=( const Record &c )
 {
     mUid = c.mUid;
     mCats = c.mCats;
     customMap = c.customMap;
     return *this;
 }
 
@@ -36,18 +47,21 @@ void Record::setCategories( int single )
 {
     if ( single == 0 )
         return;
     mCats.resize(1);
     mCats[0] = single;
 }
 
 // convenience methods provided for loading and saving to xml
-QString Record::idsToString( const QArray<int> &cats )
+QString Record::idsToString( const QArray<int> &catsUnsorted )
 {
+    QArray<int> cats = catsUnsorted;
+    cats.sort();
+
     QString str;
     for ( uint i = 0; i < cats.size(); i++ )
         if ( i == 0 )
             str = QString::number( cats[int(i)] );
         else
             str += ";" + QString::number( cats[int(i)] );
 
     return str;
@@ -79,40 +93,40 @@ QString Record::customField( const QString &key) const
     return QString::null;
 }
 
 /*!
   Sets the string stored for the custom field \a key to \a value.
  */
 void Record::setCustomField( const QString &key, const QString &value)
 {
-    qWarning("setting custom " + key + " to " + value);
+//     qWarning("setting custom " + key + " to " + value);
     if (customMap.contains(key))
         customMap.replace(key, value);
     else
         customMap.insert(key, value);
 
-    qWarning(QString("custom size %1").arg(customMap.count()));
+//     qWarning(QString("custom size %1").arg(customMap.count()));
 }
 
 /*!
   Removes the custom field \a key.
  */
 void Record::removeCustomField(const QString &key)
 {
     customMap.remove(key);
 }
 
 QString Record::customToXml() const
 {
     //qWarning(QString("writing custom %1").arg(customMap.count()));
     QString buf(" ");
     for ( QMap<QString, QString>::ConstIterator cit = customMap.begin();
             cit != customMap.end(); ++cit) {
-        qWarning(".ITEM.");
+        // qWarning(".ITEM.");
         buf += cit.key();
         buf += "=\"";
         buf += escapeString(cit.data());
         buf += "\" ";
     }
     return buf;
 }
 
diff --git a/library/backend/palmtoprecord.h b/library/backend/palmtoprecord.h
index 0372011..72f7d1c 100644
--- a/library/backend/palmtoprecord.h
+++ b/library/backend/palmtoprecord.h
@@ -1,41 +1,38 @@
 /**********************************************************************
-** Copyright (C) 2000 Trolltech AS.  All rights reserved.
+** Copyright (C) 2000-2002 Trolltech AS.  All rights reserved.
 **
-** This file is part of Qtopia Environment.
+** This file is part of the Qtopia Environment.
 **
 ** This file may be distributed and/or modified under the terms of the
-** GNU General Public License version 2 as published by the Free
-** Software Foundation and appearing in the file LICENSE.GPL included
-** in the packaging of this file.
+** GNU General Public License version 2 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file.
 **
-** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING
-** THE WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A
-** PARTICULAR PURPOSE.
+** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
+** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 **
 ** See http://www.trolltech.com/gpl/ for GPL licensing information.
 **
 ** Contact info@trolltech.com if any conditions of this licensing are
 ** not clear to you.
 **
 **********************************************************************/
-
 #ifndef QTPALMTOP_RECORD_H
 #define QTPALMTOP_RECORD_H
-
 #include <qglobal.h>
 #include "qpcglobal.h"
 #include "palmtopuidgen.h"
 #include <qarray.h>
 #include <qmap.h>
 
 #if defined(QPC_TEMPLATEDLL)
 // MOC_SKIP_BEGIN
-template class QPC_EXPORT QMap<QString, QString>;
+QPC_TEMPLATEEXTERN template class QPC_EXPORT QMap<QString, QString>;
 // MOC_SKIP_END
 #endif
 
 class QRegExp;
 namespace Qtopia {
 
 class RecordPrivate;
 class QPC_EXPORT Record
@@ -44,20 +41,27 @@ public:
     Record() : mUid(0), mCats() { }
             Record( const Record &c ) :mUid( c.mUid ), mCats ( c.mCats ), customMap(c.customMap) { }
     virtual ~Record() { }
 
     Record &operator=( const Record &c );
 
     virtual bool match( const QRegExp & ) const { return FALSE; }
 
-    void setCategories( const QArray<int> &v ) { mCats = v; }
+    void setCategories( const QArray<int> &v ) { mCats = v; mCats.sort(); }
     void setCategories( int single );
     const QArray<int> &categories() const { return mCats; }
 
+    void reassignCategoryId( int oldId, int newId )
+    {
+        int index = mCats.find( oldId );
+        if ( index >= 0 )
+            mCats[index] = newId;
+    }
+
     int uid() const { return mUid; };
     virtual void setUid( int i ) { mUid = i; uidGen().store( mUid ); }
     bool isValidUid() const { return mUid != 0; }
     void assignUid() { setUid( uidGen().generate() ); }
 
     virtual QString customField(const QString &) const;
     virtual void setCustomField(const QString &, const QString &);
     virtual void removeCustomField(const QString &);
@@ -72,23 +76,20 @@ public:
     // convenience methods provided for loading and saving to xml
     static QArray<int> idsFromString( const QString &str );
 
     // for debugging
     static void dump( const QMap<int, QString> &map );
 
 protected:
     virtual UidGen &uidGen() = 0;
-
     virtual QString customToXml() const;
-
 private:
     int mUid;
     QArray<int> mCats;
-
     QMap<QString, QString> customMap;
-
     RecordPrivate *d;
 };
 
 }
 
 #endif
+
diff --git a/library/backend/palmtopuidgen.h b/library/backend/palmtopuidgen.h
index 1a16681..c3fbcb9 100644
--- a/library/backend/palmtopuidgen.h
+++ b/library/backend/palmtopuidgen.h
@@ -1,38 +1,38 @@
-#ifndef QTPALMTOP_UIDGEN_H
-#define QTPALMTOP_UIDGEN_H
 /**********************************************************************
-** Copyright (C) 2000 Trolltech AS.  All rights reserved.
+** Copyright (C) 2000-2002 Trolltech AS.  All rights reserved.
 **
-** This file is part of Qtopia Environment.
+** This file is part of the Qtopia Environment.
 **
-** Licensees holding valid Qtopia Developer license may use this
-** file in accordance with the Qtopia Developer License Agreement
-** provided with the Software.
+** This file may be distributed and/or modified under the terms of the
+** GNU General Public License version 2 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file.
 **
-** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING
-** THE WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-** PURPOSE.
+** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
+** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 **
-** email sales@trolltech.com for information about Qtopia License
-** Agreements.
+** See http://www.trolltech.com/gpl/ for GPL licensing information.
 **
 ** Contact info@trolltech.com if any conditions of this licensing are
 ** not clear to you.
 **
 **********************************************************************/
 
+#ifndef QTPALMTOP_UIDGEN_H
+#define QTPALMTOP_UIDGEN_H
+
 #include <time.h>
 #include <qmap.h>
 #include "qpcglobal.h"
 
 #if defined(QPC_TEMPLATEDLL)
 // MOC_SKIP_BEGIN
-template class QPC_EXPORT QMap< int, bool >;
+QPC_TEMPLATEEXTERN template class QPC_EXPORT QMap< int, bool >;
 // MOC_SKIP_END
 #endif
 
 namespace Qtopia {
 
 
 class QPC_EXPORT UidGen
 {
diff --git a/library/backend/qfiledirect_p.h b/library/backend/qfiledirect_p.h
index 3ade622..976c69f 100644
--- a/library/backend/qfiledirect_p.h
+++ b/library/backend/qfiledirect_p.h
@@ -1,37 +1,35 @@
-/**********************************************************************

-** Copyright (C) 2001 Trolltech AS.  All rights reserved.

-**

-** This file is part of the Qtopia Environment.

-**

-** Licensees holding valid Qtopia Developer license may use this

-** file in accordance with the Qtopia Developer License Agreement

-** provided with the Software.

-**

-** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING

-** THE WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR

-** PURPOSE.

-**

-** email sales@trolltech.com for information about Qtopia License

-** Agreements.

-**

-** Contact info@trolltech.com if any conditions of this licensing are

-** not clear to you.

-**

-**********************************************************************/

-

-#ifndef QFILE_DIRECT_H

-#define QFILE_DIRECT_H

-#include <qfile.h>

-#include <qpe/qpcglobal.h>

-

-class QPC_EXPORT QFileDirect : public QFile

-{

-public:

-        QFileDirect() : QFile() { }

-    QFileDirect( const QString &name ) : QFile(name) { }

-

-        FILE *directHandle() { return fh; }

-};

-

-#endif

-

+/**********************************************************************
+** Copyright (C) 2000-2002 Trolltech AS.  All rights reserved.
+**
+** This file is part of the Qtopia Environment.
+**
+** This file may be distributed and/or modified under the terms of the
+** GNU General Public License version 2 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file.
+**
+** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
+** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+**
+** See http://www.trolltech.com/gpl/ for GPL licensing information.
+**
+** Contact info@trolltech.com if any conditions of this licensing are
+** not clear to you.
+**
+**********************************************************************/
+
+#ifndef QFILE_DIRECT_H
+#define QFILE_DIRECT_H
+#include <qfile.h>
+#include <qtopia/private/qpcglobal.h>
+
+class QPC_EXPORT QFileDirect : public QFile
+{
+public:
+        QFileDirect() : QFile() { }
+    QFileDirect( const QString &name ) : QFile(name) { }
+
+        FILE *directHandle() { return fh; }
+};
+
+#endif
diff --git a/library/backend/qpcglobal.h b/library/backend/qpcglobal.h
index 0d60272..7b71f06 100644
--- a/library/backend/qpcglobal.h
+++ b/library/backend/qpcglobal.h
@@ -1,12 +1,12 @@
 /**********************************************************************
-** Copyright (C) 2000 Trolltech AS.  All rights reserved.
+** Copyright (C) 2000-2002 Trolltech AS.  All rights reserved.
 **
-** This file is part of Qtopia Environment.
+** This file is part of the Qtopia Environment.
 **
 ** Licensees holding valid Qtopia Developer license may use this
 ** file in accordance with the Qtopia Developer License Agreement
 ** provided with the Software.
 **
 ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING
 ** THE WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 ** PURPOSE.
@@ -17,30 +17,33 @@
 ** Contact info@trolltech.com if any conditions of this licensing are
 ** not clear to you.
 **
 **********************************************************************/
 
 #ifndef QPC_GLOBAL_H
 #define QPC_GLOBAL_H
 
-#if ( defined(Q_OS_WIN32) || defined(Q_OS_WIN64) ) && defined(PALMTOPCENTER)
 #include <qglobal.h>
+
+#if ( defined(Q_OS_WIN32) || defined(Q_OS_WIN64) ) && defined(PALMTOPCENTER)
 // #  if defined(QT_NODLL)
 //#    undef QPC_MAKEDLL
 //#    undef QPC_DLL
         #  if defined(QPC_MAKEDLL)/* create a Qt DLL library */
 #    if defined(QPC_DLL)
 #      undef QPC_DLL
 #    endif
 #    define QPC_EXPORT  __declspec(dllexport)
+#    define QPC_TEMPLATEEXTERN
 #    define QPC_TEMPLATEDLL
         #    undef  QPC_DISABLE_COPY/* avoid unresolved externals */
         #  elif defined(QPC_DLL)        /* use a Qt DLL library */
 #    define QPC_EXPORT  __declspec(dllimport)
+#    define QPC_TEMPLATEEXTERN extern
 #    define QPC_TEMPLATEDLL
         #    undef  QPC_DISABLE_COPY/* avoid unresolved externals */
 #  endif
 #else
         #  undef QPC_MAKEDLL    /* ignore these for other platforms */
 #  undef QPC_DLL
 #endif
 #endif
diff --git a/library/backend/recordfields.h b/library/backend/recordfields.h
index 4196c8b..1167ed3 100644
--- a/library/backend/recordfields.h
+++ b/library/backend/recordfields.h
@@ -1,23 +1,22 @@
 /**********************************************************************
-** Copyright (C) 2000 Trolltech AS.  All rights reserved.
+** Copyright (C) 2000-2002 Trolltech AS.  All rights reserved.
 **
-** This file is part of Qtopia Environment.
+** This file is part of the Qtopia Environment.
 **
-** Licensees holding valid Qtopia Developer license may use this
-** file in accordance with the Qtopia Developer License Agreement
-** provided with the Software.
+** This file may be distributed and/or modified under the terms of the
+** GNU General Public License version 2 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file.
 **
-** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING
-** THE WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-** PURPOSE.
+** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
+** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 **
-** email sales@trolltech.com for information about Qtopia License
-** Agreements.
+** See http://www.trolltech.com/gpl/ for GPL licensing information.
 **
 ** Contact info@trolltech.com if any conditions of this licensing are
 ** not clear to you.
 **
 **********************************************************************/
 #ifndef QPC_RECORD_FIELDS_H
 #define QPC_RECORD_FIELDS_H
 #include "qpcglobal.h"
@@ -83,19 +82,20 @@ namespace Qtopia
         Gender,
         Birthday,
         Anniversary,
         Nickname,
         Children,
 
         // other
         Notes,
-        Groups
 
-        ,rid,
+        // used for internal record keeping, not for end user.
+        Groups,
+        rid,
         rinfo
     };
 
     // dataset = "todolist"
     enum TaskFields {
         TaskUid = UID_ID,
         TaskCategory = CATEGORY_ID,
         
diff --git a/library/backend/stringutil.cpp b/library/backend/stringutil.cpp
deleted file mode 100644
index df58f54..0000000
--- a/library/backend/stringutil.cpp
+++ b/dev/null
@@ -1,415 +0,0 @@
-/**********************************************************************
-** Copyright (C) 2000 Trolltech AS.  All rights reserved.
-**
-** This file is part of Qtopia Environment.
-**
-** This file may be distributed and/or modified under the terms of the
-** GNU General Public License version 2 as published by the Free
-** Software Foundation and appearing in the file LICENSE.GPL included
-** in the packaging of this file.
-**
-** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING
-** THE WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A
-** PARTICULAR PURPOSE.
-**
-** See http://www.trolltech.com/gpl/ for GPL licensing information.
-**
-** Contact info@trolltech.com if any conditions of this licensing are
-** not clear to you.
-**
-**********************************************************************/
-
-#include "stringutil.h"
-#include <qregexp.h>
-#include <qstringlist.h>
-
-namespace Qtopia
-{
-
-
-
-/*
-  Very, very simple Latin-1 only collation guaranteed to displease anyone
-  who actually uses the non-ASCII characters.
- */
-
-static const char  collationHack[] = {
-0x00, //C-@
-0x01, //C-A
-0x02, //C-B
-0x03, //C-C
-0x04, //C-D
-0x05, //C-E
-0x06, //C-F
-0x07, //C-G
-0x08, //C-H
-0x09, //C-I
-0x0a, //C-J
-0x0b, //C-K
-0x0c, //C-L
-0x0d, //C-M
-0x0e, //C-N
-0x0f, //C-O
-0x10, //C-P
-0x11, //C-Q
-0x12, //C-R
-0x13, //C-S
-0x14, //C-T
-0x15, //C-U
-0x16, //C-V
-0x17, //C-W
-0x18, //C-X
-0x19, //C-Y
-0x1a, //C-Z
-0x1b, //C-[
-0x1c, //C-\ 
-0x1d, //C-]
-0x1e, //C-^
-0x1f, //C-_
-' ', // 
-'!', //!
-'"', //"
-'#', //#
-'$', //$
-'%', //%
-'&', //&
-'\'', //'
-'(', //(
-')', //)
-'*', //*
-'+', //+
-',', //,
-'-', //-
-'.', //.
-'/', ///
-0x80, //0
-0x81, //1
-0x82, //2
-0x83, //3
-0x84, //4
-0x85, //5
-0x86, //6
-0x87, //7
-0x88, //8
-0x89, //9
-':', //:
-';', //;
-'<', //<
-'=', //=
-'>', //>
-'?', //?
-'@', //@
-'A', //A
-'B', //B
-'C', //C
-'D', //D
-'E', //E
-'F', //F
-'G', //G
-'H', //H
-'I', //I
-'J', //J
-'K', //K
-'L', //L
-'M', //M
-'N', //N
-'O', //O
-'P', //P
-'Q', //Q
-'R', //R
-'S', //S
-'T', //T
-'U', //U
-'V', //V
-'W', //W
-'X', //X
-'Y', //Y
-'Z', //Z
-'[', //[
-'\\', //\ 
-']', //]
-'^', //^
-'_', //_
-'`', //`
-'A', //a
-'B', //b
-'C', //c
-'D', //d
-'E', //e
-'F', //f
-'G', //g
-'H', //h
-'I', //i
-'J', //j
-'K', //k
-'L', //l
-'M', //m
-'N', //n
-'O', //o
-'P', //p
-'Q', //q
-'R', //r
-'S', //s
-'T', //t
-'U', //u
-'V', //v
-'W', //w
-'X', //x
-'Y', //y
-'Z', //z
-'{', //{
-'|', //|
-'}', //}
-'~', //~
-'', //
-0x80, //C-M-@
-0x81, //C-M-A
-0x82, //C-M-B
-0x83, //C-M-C
-0x84, //C-M-D
-0x85, //C-M-E
-0x86, //C-M-F
-0x87, //C-M-G
-0x88, //C-M-H
-0x89, //C-M-I
-0x8a, //C-M-J
-0x8b, //C-M-K
-0x8c, //C-M-L
-0x8d, //C-M-M
-0x8e, //C-M-N
-0x8f, //C-M-O
-0x90, //C-M-P
-0x91, //C-M-Q
-0x92, //C-M-R
-0x93, //C-M-S
-0x94, //C-M-T
-0x95, //C-M-U
-0x96, //C-M-V
-0x97, //C-M-W
-0x98, //C-M-X
-0x99, //C-M-Y
-0x9a, //C-M-Z
-0x9b, //C-M-[
-0x9c, //C-M-\ 
-0x9d, //C-M-]
-0x9e, //C-M-^
-0x9f, //C-M-_
-' ', // 
-'¡', //¡
-'¢', //¢
-'£', //£
-'¤', //¤
-'¥', //¥
-'¦', //¦
-'§', //§
-'¨', //¨
-'©', //©
-'A', //ª
-'«', //«
-'¬', //¬
-'­', //­
-'®', //®
-'¯', //¯
-'O', //°
-'±', //±
-'²', //²
-'³', //³
-'´', //´
-'µ', //µ
-'P', //¶
-'·', //·
-'¸', //¸
-'¹', //¹
-'O', //º
-'»', //»
-'¼', //¼
-'½', //½
-'¾', //¾
-'¿', //¿
-'A', //À
-'A', //Á
-'A', //Â
-'A', //Ã
-'A', //Ä
-'A', //Å
-'A', //Æ
-'C', //Ç
-'E', //È
-'E', //É
-'E', //Ê
-'E', //Ë
-'I', //Ì
-'I', //Í
-'I', //Î
-'I', //Ï
-'D', //Ð
-'N', //Ñ
-'O', //Ò
-'O', //Ó
-'O', //Ô
-'O', //Õ
-'O', //Ö
-'×', //×
-'O', //Ø
-'U', //Ù
-'U', //Ú
-'U', //Û
-'U', //Ü
-'Y', //Ý
-'T', //Þ
-'S', //ß
-'A', //à
-'A', //á
-'A', //â
-'A', //ã
-'A', //ä
-'A', //å
-'A', //æ
-'C', //ç
-'E', //è
-'E', //é
-'E', //ê
-'E', //ë
-'I', //ì
-'I', //í
-'I', //î
-'I', //ï
-'D', //ð
-'N', //ñ
-'O', //ò
-'O', //ó
-'O', //ô
-'O', //õ
-'O', //ö
-'÷', //÷
-'O', //ø
-'U', //ù
-'U', //ú
-'U', //û
-'U', //ü
-'Y', //ý
-'T', //þ
-'Y', //ÿ
-};
-
-
-
-
-
-static void hackString ( QString &s )
-{
-    int len = s.length();
-    const QChar* uc = s.unicode();
-    for ( int i = 0; i < len; i++ ) {
-        if ( !uc++->row() )
-            s[i] = collationHack[s[i].cell()];
-    }
-}
-
-QString buildSortKey( const QString & s )
-{
-    QString res = s;
-    hackString( res );
-    return res;
-}
-
-QString buildSortKey( const QString & s1, const QString & s2 )
-{
-    QString res = s1 + QChar( '\0' ) + s2;
-    hackString( res );
-    return res;
-}
-
-QString buildSortKey( const QString & s1, const QString & s2, 
-                      const QString & s3 )
-{
-    QString res = s1 + QChar( '\0' ) +  s2 + QChar( '\0' ) + s3;
-    hackString( res );
-    return res;
-}
-
-static inline QChar coll( QChar u )
-{
-    return u.row() ? u : QChar(collationHack[ u.cell() ]);
-}
-
-
-int compare( const QString & s1, const QString & s2 )
-{
-    const QChar* u1 = s1.unicode();
-    const QChar* u2 = s2.unicode();
-    
-    if ( u1 == u2 )
-        return 0;
-    if ( u1 == 0 )
-        return 1;
-    if ( u2 == 0 )
-        return -1;
-    int l=QMIN(s1.length(),s2.length());
-    while ( l-- && coll(*u1) == coll(*u2) )
-        u1++,u2++;
-    if ( l==-1 )
-        return ( s1.length()-s2.length() );
-    return u1->unicode() - u2->unicode();
-}
-
-QString simplifyMultiLineSpace( const QString &multiLine )
-{
-    QString result;
-    QStringList lines =  QStringList::split("\n", multiLine);
-    for ( QStringList::Iterator it = lines.begin(); it != lines.end(); ++it ) {
-        if ( it != lines.begin() )
-            result += "\n";
-        result += (*it).simplifyWhiteSpace();
-    }
-    return result;
-}
-
-QString escapeString( const QString& plain )
-{
-    QString tmp(plain);
-    int pos = tmp.length();
-    const QChar *uc = plain.unicode();
-    while ( pos-- ) {
-        unsigned char ch = uc[pos].latin1();
-        if ( ch == '&' )
-            tmp.replace( pos, 1, "&amp;" );
-        else if ( ch == '<' )
-            tmp.replace( pos, 1, "&lt;" );
-        else if ( ch == '>' )
-            tmp.replace( pos, 1, "&gt;" );
-        else if ( ch == '\"' )
-            tmp.replace( pos, 1, "&quot;" );
-    }
-    return tmp;
-}
-
-QString plainString( const char* escaped, unsigned int length )
-{
-    return plainString( QString::fromUtf8( escaped, length ) );
-}
-
-QString plainString( const QCString& string )
-{
-    // We first have to pass it through a ::fromUtf8()
-    return plainString( string.data(), string.length() );
-}
-
-QString plainString( const QString& string )
-{
-    QString tmp( string );
-    int pos = -1;
-    while ( (pos = tmp.find( "&", pos +1 ) ) != -1 ) {
-        if ( tmp.find( "&amp;", pos ) == pos )
-            tmp.replace( pos, 5, "&" );
-        else if ( tmp.find( "&lt;", pos ) == pos )
-            tmp.replace( pos, 4, "<" );
-        else if( tmp.find( "&gt;", pos ) == pos )
-            tmp.replace( pos, 4, ">" );
-        else if ( tmp.find( "&quot;", pos ) == pos )
-            tmp.replace( pos, 6, "\"" );
-    }
-    return tmp;
-}
-
-} // namespace QPC
diff --git a/library/backend/stringutil.h b/library/backend/stringutil.h
deleted file mode 100644
index e9daf70..0000000
--- a/library/backend/stringutil.h
+++ b/dev/null
@@ -1,57 +0,0 @@
-/**********************************************************************
-** Copyright (C) 2000 Trolltech AS.  All rights reserved.
-**
-** This file is part of Qtopia Environment.
-**
-** This file may be distributed and/or modified under the terms of the
-** GNU General Public License version 2 as published by the Free
-** Software Foundation and appearing in the file LICENSE.GPL included
-** in the packaging of this file.
-**
-** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING
-** THE WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A
-** PARTICULAR PURPOSE.
-**
-** See http://www.trolltech.com/gpl/ for GPL licensing information.
-**
-** Contact info@trolltech.com if any conditions of this licensing are
-** not clear to you.
-**
-**********************************************************************/
-
-
-#ifndef QTPALMTOP_stringutil_h__
-#define QTPALMTOP_stringutil_h__
-
-#include <qstring.h>
-#include "qpcglobal.h"
-
-namespace Qtopia
-{
-
-// Simplifies white space within each line but keeps the new line characters
-QString QPC_EXPORT simplifyMultiLineSpace( const QString &multiLine );
-
-// Creates a QString which doesn't contain any "dangerous"
-// characters (i.e. <, >, &, ")
-QString QPC_EXPORT escapeString( const QString& plain );
-
-// Takes a UTF-8!! string and removes all the XML thingies (entities?)
-// from the string and also calls fromUtf8() on it... so make sure
-// to pass a QCString/const char* with UTF-8 data only
-QString QPC_EXPORT plainString( const char* escaped, unsigned int length );
-QString QPC_EXPORT plainString( const QCString& string );
-
-QString QPC_EXPORT plainString( const QString& string );
-
-
-// collation functions
-int compare( const QString & s1, const QString & s2 );
-QString buildSortKey( const QString & s );
-QString buildSortKey( const QString & s1, const QString & s2 );
-QString buildSortKey( const QString & s1, const QString & s2, 
-                      const QString & s3 );
-
-}
-
-#endif
diff --git a/library/backend/task.cpp b/library/backend/task.cpp
index f0a38f1..a00adb3 100644
--- a/library/backend/task.cpp
+++ b/library/backend/task.cpp
@@ -1,85 +1,200 @@
 /**********************************************************************
-** Copyright (C) 2001 Trolltech AS.  All rights reserved.
+** Copyright (C) 2000-2002 Trolltech AS.  All rights reserved.
 **
-** This file is part of Qtopia Environment.
+** This file is part of the Qtopia Environment.
 **
 ** This file may be distributed and/or modified under the terms of the
 ** GNU General Public License version 2 as published by the Free Software
 ** Foundation and appearing in the file LICENSE.GPL included in the
 ** packaging of this file.
 **
 ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
 ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 **
 ** See http://www.trolltech.com/gpl/ for GPL licensing information.
 **
 ** Contact info@trolltech.com if any conditions of this licensing are
 ** not clear to you.
 **
 **********************************************************************/
 
-#include <qpe/task.h>
-#include <qregexp.h>
-#include <qstring.h>
-#include <qpe/recordfields.h>
+#include "task.h"
+#include "recordfields.h"
 #include "vobject_p.h"
-#include "timeconversion.h"
 #include "qfiledirect_p.h"
 
+#include <qtopia/timeconversion.h>
+
+#include <qregexp.h>
+#include <qstring.h>
+
 #include <stdio.h>
 
 using namespace Qtopia;
 UidGen Task::sUidGen( UidGen::Qtopia );
 
+/*!
+  \class Task
+  \brief The Task class holds the data of a todo entry.
+
+  This data includes the priority of the task, a description, an optional due
+  date, and whether the task is completed or not.
+
+  \ingroup qtopiaemb
+  \ingroup qtopiadesktop
+*/
+
+/*!
+  Creates a new, empty task.
+*/
 Task::Task() : Record(), mDue( FALSE ),
 mDueDate( QDate::currentDate() ),
 mCompleted( FALSE ), mPriority( 3 ), mDesc()
 {
 }
 
+/*!
+  \fn void Task::setPriority( int priority )
+
+  Sets the priority of the task to \a priority.
+*/
+
+/*!
+  \fn int Task::priority() const
+
+  Returns the priority of the task.
+*/
+
+/*!
+  \fn void Task::setDescription( const QString &description )
+
+  Sets the description of the task to \a description.
+ */
+
+/*!
+  \fn const QString &Task::description() const
+
+  Returns the description of the task.
+ */
+
+/*!
+  \fn void Task::setDueDate( const QDate &date, bool hasDue )
+
+  \internal
+  If \a hasDue is TRUE sets the due date of the task to \a date.
+  Otherwise clears the due date of the task.
+*/
+
+/*!
+  \fn void Task::setDueDate( const QDate &date )
+
+  Sets the due date of the task to \a date.
+*/
+
+/*!
+  \fn void Task::clearDueDate( )
+
+  Clears the due date of the task.
+*/
+
+/*!
+  \fn void Task::setCompleted( bool b )
+
+  If \a b is TRUE marks the task as completed.  Otherwise marks the task as
+  uncompleted.
+*/
+
+/*!
+  \fn bool Task::isCompleted() const
+
+  Returns TRUE if the task is completed.  Otherwise returns FALSE.
+*/
+
+/*!
+  \fn const QDate &Task::dueDate() const
+
+  Returns the due date of the task.
+ */
+
+/*!
+  \fn bool Task::hasDueDate() const
+
+  Returns TRUE if there is a due date set for the task.  Otherwise returns
+  FALSE.
+*/
+
+/*!
+  \fn void Task::setHasDueDate( bool b )
+
+  \internal
+  Just don't ask.  I really can't justify the function.
+*/
+
+
+/*!
+  \internal
+  Creates a new task.  The properties of the task are set from \a m.
+*/
+
 Task::Task( const QMap<int, QString> &m ) : Record(), mDue( FALSE ),
 mDueDate( QDate::currentDate() ), mCompleted( FALSE ), mPriority( 3 ), mDesc()
 {
     //qDebug("Task::Task fromMap");
     //dump( m );
     for ( QMap<int,QString>::ConstIterator it = m.begin(); it != m.end();++it )
         switch ( (TaskFields) it.key() ) {
         case HasDate: if ( *it == "1" ) mDue = TRUE; break;
         case Completed: setCompleted( *it == "1" ); break;
         case TaskCategory: setCategories( idsFromString( *it ) ); break;
         case TaskDescription: setDescription( *it ); break;
         case Priority: setPriority( (*it).toInt() ); break;
         case Date: mDueDate = TimeConversion::fromString( (*it) ); break;
         case TaskUid: setUid( (*it).toInt() ); break;
-        default: break;
+        case TaskRid:
+        case TaskRinfo:
+                        break;
         }
 }
 
+/*!
+  Destroys a task.
+*/
 Task::~Task()
 {
 }
 
+/*!
+  \internal
+  Returns the task as a map of field ids to property values.
+*/
 QMap<int, QString> Task::toMap() const
 {
     QMap<int, QString> m;
     m.insert( HasDate, hasDueDate() ? "1" : "0" );
     m.insert( Completed, isCompleted() ? "1" : "0" );
-    m.insert( TaskCategory, idsToString( categories() ) );
-    m.insert( TaskDescription, description() );
+    if ( categories().count() )
+        m.insert( TaskCategory, idsToString( categories() ) );
+    if ( !description().isEmpty() )
+        m.insert( TaskDescription, description() );
     m.insert( Priority, QString::number( priority() ) );
-    m.insert( Date, TimeConversion::toString( dueDate() ) );
+    if ( hasDueDate() )
+        m.insert( Date, TimeConversion::toString( dueDate() ) );
     m.insert( TaskUid, QString::number(uid()) );
 
     //qDebug("Task::toMap");
     //dump( m );
     return m;
 }
 
+/*!
+  \internal
+  Appends the task information to \a buf.
+*/
 void Task::save( QString& buf ) const
 {
     buf += " Completed=\"";
     //    qDebug( "writing %d", complete );
     buf += QString::number( (int)mCompleted );
     buf += "\"";
     buf += " HasDate=\"";
     //    qDebug( "writing %d",  );
@@ -112,64 +227,79 @@ void Task::save( QString& buf ) const
     buf += customToXml();
     //    qDebug ("writing uid %d", uid() );
     buf += " Uid=\"";
     buf += QString::number( uid() );
     // terminate it in the application...
     buf += "\"";
 }
 
-bool Task::match ( const QRegExp &r ) const
+/*!
+  Returns TRUE if the task matches the regular expressions \a regexp.
+  Otherwise returns FALSE.
+*/
+bool Task::match ( const QRegExp &regexp ) const
 {
     // match on priority, description on due date...
     bool match;
     match = false;
-    if ( QString::number( mPriority ).find( r ) > -1 )
+    if ( QString::number( mPriority ).find( regexp ) > -1 )
         match = true;
-    else if ( mDue && mDueDate.toString().find( r ) > -1 )
+    else if ( mDue && mDueDate.toString().find( regexp ) > -1 )
         match = true;
-    else if ( mDesc.find( r ) > -1 )
+    else if ( mDesc.find( regexp ) > -1 )
         match = true;
     return match;
 }
 
+/*!
+  \internal
+*/
 static inline VObject *safeAddPropValue( VObject *o, const char *prop, const QString &value )
 {
     VObject *ret = 0;
     if ( o && !value.isEmpty() )
         ret = addPropValue( o, prop, value.latin1() );
     return ret;
 }
 
+/*!
+  \internal
+*/
 static inline VObject *safeAddProp( VObject *o, const char *prop)
 {
     VObject *ret = 0;
     if ( o )
         ret = addProp( o, prop );
     return ret;
 }
 
 
+/*!
+  \internal
+*/
 static VObject *createVObject( const Task &t )
 {
     VObject *vcal = newVObject( VCCalProp );
     safeAddPropValue( vcal, VCVersionProp, "1.0" );
     VObject *task = safeAddProp( vcal, VCTodoProp );
 
     if ( t.hasDueDate() )
         safeAddPropValue( task, VCDueProp, TimeConversion::toISO8601( t.dueDate() ) );
     safeAddPropValue( task, VCDescriptionProp, t.description() );
     if ( t.isCompleted() )
         safeAddPropValue( task, VCStatusProp, "COMPLETED" );
     safeAddPropValue( task, VCPriorityProp, QString::number( t.priority() ) );
 
     return vcal;
 }
 
-
+/*!
+  \internal
+*/
 static Task parseVObject( VObject *obj )
 {
     Task t;
 
     VObjectIterator it;
     initPropIterator( &it, obj );
     while( moreIteration( &it ) ) {
         VObject *o = nextVObject( &it );
@@ -202,17 +332,19 @@ static Task parseVObject( VObject *obj )
         }
 #endif
     }
 
     return t;
 }
 
 
-
+/*!
+  Writes the list of \a tasks as a set of VCards to the file \a filename.
+*/
 void Task::writeVCalendar( const QString &filename, const QValueList<Task> &tasks)
 {
   QFileDirect f( filename.utf8().data() );
   if ( !f.open( IO_WriteOnly ) ) {
     qWarning("Unable to open vcard write");
     return;
   }
 
@@ -221,32 +353,37 @@ void Task::writeVCalendar( const QString &filename, const QValueList<Task> &task
         VObject *obj = createVObject( *it );
         writeVObject(f.directHandle() , obj );
         cleanVObject( obj );
     }
 
     cleanStrTbl();
 }
 
+/*!
+  Writes \a task as a VCard to the file \a filename.
+*/
 void Task::writeVCalendar( const QString &filename, const Task &task)
 {
   QFileDirect f( filename.utf8().data() );
   if ( !f.open( IO_WriteOnly ) ) {
     qWarning("Unable to open vcard write");
     return;
   }
 
   VObject *obj = createVObject( task );
   writeVObject(f.directHandle() , obj );
   cleanVObject( obj );
 
   cleanStrTbl();
 }
 
-
+/*!
+  Returns the set of tasks read as VCards from the file \a filename.
+*/
 QValueList<Task> Task::readVCalendar( const QString &filename )
 {
     VObject *obj = Parse_MIME_FromFileName( (char *)filename.utf8().data() );
 
     QValueList<Task> tasks;
 
     while ( obj ) {
         QCString name = vObjectName( obj );
diff --git a/library/backend/task.h b/library/backend/task.h
index 6f383b8..091f2e9 100644
--- a/library/backend/task.h
+++ b/library/backend/task.h
@@ -1,12 +1,12 @@
 /**********************************************************************
-** Copyright (C) 2001 Trolltech AS.  All rights reserved.
+** Copyright (C) 2000-2002 Trolltech AS.  All rights reserved.
 **
-** This file is part of Qtopia Environment.
+** This file is part of the Qtopia Environment.
 **
 ** This file may be distributed and/or modified under the terms of the
 ** GNU General Public License version 2 as published by the Free Software
 ** Foundation and appearing in the file LICENSE.GPL included in the
 ** packaging of this file.
 **
 ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
 ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
@@ -15,18 +15,18 @@
 **
 ** Contact info@trolltech.com if any conditions of this licensing are
 ** not clear to you.
 **
 **********************************************************************/
 #ifndef __TASK_H__
 #define __TASK_H__
 
-#include <qpe/palmtoprecord.h>
-#include <qpe/stringutil.h>
+#include <qtopia/private/palmtoprecord.h>
+#include <qtopia/stringutil.h>
 
 #include <qvaluelist.h>
 #include <qdatetime.h>
 
 class TaskPrivate;
 class QPC_EXPORT Task : public Qtopia::Record
 {
 public:
@@ -35,31 +35,39 @@ public:
     ~Task();
 
     QMap<int, QString> toMap() const;
 
     static void writeVCalendar( const QString &filename, const QValueList<Task> &tasks);
     static void writeVCalendar( const QString &filename, const Task &task);
     static QValueList<Task> readVCalendar( const QString &filename );
 
+    enum PriorityValue { VeryHigh=1, High, Normal, Low, VeryLow };
+
     void setPriority( int priority ) { mPriority = priority; }
     int priority() const { return mPriority; }
 
 //     void setCategory( const QString& category )
 //     { mCategory = category.stripWhiteSpace(); }
 //     const QString &category() const { return mCategory; }
 
     void setDescription( const QString& description )
     { mDesc = Qtopia::simplifyMultiLineSpace(description); }
     const QString &description() const { return mDesc; }
 
+    // Use THESE functions
+    void setDueDate( const QDate &date);
+    void clearDueDate();
+   
+    // Instead of these functions.
     void setDueDate( const QDate& date, bool hasDue ) { mDueDate = date; mDue = hasDue; }
+    void setHasDueDate( bool b ) { mDue = b; }
+
     const QDate &dueDate() const { return mDueDate; }
     bool hasDueDate() const { return mDue; }
-    void setHasDueDate( bool b ) { mDue = b; }
     
     void setCompleted( bool b ) { mCompleted = b; }
     bool isCompleted() const { return mCompleted; }
 
     void save( QString& buf ) const;
     bool match( const QRegExp &r ) const;
 
 private:
@@ -73,9 +81,12 @@ private:
     QString mDesc;
     TaskPrivate *d;
     // ADDITION
     int recordId;
     int recordInfo;
     //
 };
 
+// MUST be inline.  (forwards compatability).
+inline void Task::setDueDate( const QDate &date) { setDueDate(date, date.isValid()); }
+inline void Task::clearDueDate() { setHasDueDate( FALSE ); }
 #endif
diff --git a/library/backend/timeconversion.cpp b/library/backend/timeconversion.cpp
deleted file mode 100644
index a4a2547..0000000
--- a/library/backend/timeconversion.cpp
+++ b/dev/null
@@ -1,237 +0,0 @@
-/**********************************************************************
-** Copyright (C) 2000 Trolltech AS.  All rights reserved.
-**
-** This file is part of Qtopia Environment.
-**
-** This file may be distributed and/or modified under the terms of the
-** GNU General Public License version 2 as published by the Free Software
-** Foundation and appearing in the file LICENSE.GPL included in the
-** packaging of this file.
-**
-** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
-** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
-**
-** See http://www.trolltech.com/gpl/ for GPL licensing information.
-**
-** Contact info@trolltech.com if any conditions of this licensing are
-** not clear to you.
-**
-**********************************************************************/
-
-#include <qglobal.h>
-#include "timeconversion.h"
-#include <qregexp.h>
-#include <stdlib.h>
-
-QString TimeConversion::toString( const QDate &d )
-{
-    QString r = QString::number( d.day() ) + "." +
-                QString::number( d.month() ) + "." +
-                QString::number( d.year() );
-    //qDebug("TimeConversion::toString %s", r.latin1());
-    return r;
-}
-
-QDate TimeConversion::fromString( const QString &datestr )
-{
-    int monthPos = datestr.find('.');
-    int yearPos = datestr.find('.', monthPos+1 );
-    if ( monthPos == -1 || yearPos == -1 ) {
-        qDebug("fromString didn't find . in str = %s; mpos = %d ypos = %d", datestr.latin1(), monthPos, yearPos );
-        return QDate();
-    }
-    int d = datestr.left( monthPos ).toInt();
-    int m = datestr.mid( monthPos+1, yearPos - monthPos - 1 ).toInt();
-    int y = datestr.mid( yearPos+1 ).toInt();
-    QDate date ( y,m,d );
-    //qDebug("TimeConversion::fromString ymd = %s => %d %d %d; mpos = %d ypos = %d", datestr.latin1(), y, m, d, monthPos, yearPos);
-    return date;
-}
-
-time_t TimeConversion::toUTC( const QDateTime& dt )
-{
-    time_t tmp;
-    struct tm *lt;
-
-#if defined(_OS_WIN32) || defined (Q_OS_WIN32) || defined (Q_OS_WIN64)
-    _tzset();
-#else
-    tzset();
-#endif
-
-    // get a tm structure from the system to get the correct tz_name
-    tmp = time( 0 );
-    lt = localtime( &tmp );
-
-    lt->tm_sec = dt.time().second();
-    lt->tm_min = dt.time().minute();
-    lt->tm_hour = dt.time().hour();
-    lt->tm_mday = dt.date().day();
-    lt->tm_mon = dt.date().month() - 1; // 0-11 instead of 1-12
-    lt->tm_year = dt.date().year() - 1900; // year - 1900
-    //lt->tm_wday = dt.date().dayOfWeek(); ignored anyway
-    //lt->tm_yday = dt.date().dayOfYear(); ignored anyway
-    lt->tm_wday = -1;
-    lt->tm_yday = -1;
-    // tm_isdst negative -> mktime will find out about DST
-    lt->tm_isdst = -1;
-    // keep tm_zone and tm_gmtoff
-    tmp = mktime( lt );
-    return tmp;
-}
-
-QDateTime TimeConversion::fromUTC( time_t time )
-{
-    struct tm *lt;
-
-#if defined(_OS_WIN32) || defined (Q_OS_WIN32) || defined (Q_OS_WIN64)
-    _tzset();
-#else
-    tzset();
-#endif
-    lt = localtime( &time );
-    QDateTime dt;
-    dt.setDate( QDate( lt->tm_year + 1900, lt->tm_mon + 1, lt->tm_mday ) );
-    dt.setTime( QTime( lt->tm_hour, lt->tm_min, lt->tm_sec ) );
-    return dt;
-}
-
-
-int TimeConversion::secsTo( const QDateTime &from, const QDateTime &to )
-{
-    return toUTC( to ) - toUTC( from );
-}
-
-QCString TimeConversion::toISO8601( const QDate &d )
-{
-    time_t tmp = toUTC( d );
-    struct tm *utc = gmtime( &tmp );
-
-    QCString str;
-    str.sprintf("%04d%02d%02d", (utc->tm_year + 1900), utc->tm_mon+1, utc->tm_mday );
-    return str;
-}
-
-QCString TimeConversion::toISO8601( const QDateTime &dt )
-{
-    time_t tmp = toUTC( dt );
-    struct tm *utc = gmtime( &tmp );
-
-    QCString str;
-    str.sprintf("%04d%02d%02dT%02d%02d%02dZ",
-                (utc->tm_year + 1900), utc->tm_mon+1, utc->tm_mday,
-                utc->tm_hour, utc->tm_min, utc->tm_sec );
-    return str;
-}
-
-QDateTime TimeConversion::fromISO8601( const QCString &s )
-{
-
-#if defined(_OS_WIN32) || defined (Q_OS_WIN32) || defined (Q_OS_WIN64)
-    _tzset();
-#else
-    tzset();
-#endif
-
-    struct tm *thetime = new tm;
-
-    QCString str = s.copy();
-    str.replace(QRegExp("-"), "" );
-    str.replace(QRegExp(":"), "" );
-    str.stripWhiteSpace();
-    str = str.lower();
-
-    int i = str.find( "t" );
-    QCString date;
-    QCString timestr;
-    if ( i != -1 ) {
-        date = str.left( i );
-        timestr = str.mid( i+1 );
-    } else {
-        date = str;
-    }
-
-//     qDebug("--- parsing ISO time---");
-    thetime->tm_year = 100;
-    thetime->tm_mon = 0;
-    thetime->tm_mday = 0;
-    thetime->tm_hour = 0;
-    thetime->tm_min = 0;
-    thetime->tm_sec = 0;
-
-//     qDebug("date = %s", date.data() );
-
-    switch( date.length() ) {
-        case 8:
-            thetime->tm_mday = date.right( 2 ).toInt();
-        case 6:
-            thetime->tm_mon = date.mid( 4, 2 ).toInt() - 1;
-        case 4:
-            thetime->tm_year = date.left( 4 ).toInt();
-            thetime->tm_year -= 1900;
-            break;
-        default:
-            break;
-    }
-
-    int tzoff = 0;
-    bool inLocalTime = FALSE;
-    if ( timestr.find( 'z' ) == (int)timestr.length() - 1 )
-        // UTC
-        timestr = timestr.left( timestr.length() -1 );
-    else {
-        int plus = timestr.find( "+" );
-        int minus = timestr.find( "-" );
-        if ( plus != -1 || minus != -1 ) {
-            // have a timezone offset
-            plus = (plus != -1) ? plus : minus;
-            QCString off = timestr.mid( plus );
-            timestr = timestr.left( plus );
-
-            int tzoffhour = 0;
-            int tzoffmin = 0;
-            switch( off.length() ) {
-                case 5:
-                    tzoffmin = off.mid(3).toInt();
-                case 3:
-                    tzoffhour = off.left(3).toInt();
-                default:
-                    break;
-            }
-            tzoff = 60*tzoffhour + tzoffmin;
-        } else
-            inLocalTime = TRUE;
-    }
-
-    // get the time:
-    switch( timestr.length() ) {
-        case 6:
-            thetime->tm_sec = timestr.mid( 4 ).toInt();
-        case 4:
-            thetime->tm_min = timestr.mid( 2, 2 ).toInt();
-        case 2:
-            thetime->tm_hour = timestr.left( 2 ).toInt();
-        default:
-            break;
-    }
-
-    int tzloc = 0;
-    time_t tmp = time( 0 );
-    if ( !inLocalTime ) {
-        // have to get the offset between gmt and local time
-        struct tm *lt = localtime( &tmp );
-        tzloc = mktime( lt );
-        struct tm *ut = gmtime( &tmp );
-        tzloc -= mktime( ut );
-    }
-//     qDebug("time: %d %d %d, tzloc=%d, tzoff=%d", thetime->tm_hour, thetime->tm_min, thetime->tm_sec,
-        //     tzloc, tzoff );
-
-    tmp = mktime( thetime );
-    tmp += 60*(-tzloc + tzoff);
-
-    delete thetime;
-
-    return fromUTC( tmp );
-}
-
diff --git a/library/backend/timeconversion.h b/library/backend/timeconversion.h
deleted file mode 100644
index 1724812..0000000
--- a/library/backend/timeconversion.h
+++ b/dev/null
@@ -1,45 +0,0 @@
-/**********************************************************************
-** Copyright (C) 2000 Trolltech AS.  All rights reserved.
-**
-** This file is part of Qtopia Environment.
-**
-** This file may be distributed and/or modified under the terms of the
-** GNU General Public License version 2 as published by the Free Software
-** Foundation and appearing in the file LICENSE.GPL included in the
-** packaging of this file.
-**
-** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
-** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
-**
-** See http://www.trolltech.com/gpl/ for GPL licensing information.
-**
-** Contact info@trolltech.com if any conditions of this licensing are
-** not clear to you.
-**
-**********************************************************************/
-
-#ifndef __timeconversion_h__
-#define __timeconversion_h__
-
-#include <time.h>
-#include <sys/types.h>
-#include <qdatetime.h>
-
-#include <qpe/qpcglobal.h>
-
-class QPC_EXPORT TimeConversion
-{
-public:
-    static QString toString( const QDate &d );
-    static QDate fromString( const QString &datestr );
-
-    static time_t toUTC( const QDateTime& dt );
-    static QDateTime fromUTC( time_t time );
-    static int secsTo( const QDateTime &from, const QDateTime &to );
-
-    static QCString toISO8601( const QDate & );
-    static QCString toISO8601( const QDateTime & );
-    static QDateTime fromISO8601( const QCString & );
-};
-
-#endif // __timeconversion_h__
diff --git a/library/backend/vcc.y b/library/backend/vcc.y
index e326a64..5bcf0cb 100644
--- a/library/backend/vcc.y
+++ b/library/backend/vcc.y
@@ -1,1199 +1,1208 @@
-%{
-
-/***************************************************************************
-(C) Copyright 1996 Apple Computer, Inc., AT&T Corp., International
-Business Machines Corporation and Siemens Rolm Communications Inc.
-
-For purposes of this license notice, the term Licensors shall mean,
-collectively, Apple Computer, Inc., AT&T Corp., International
-Business Machines Corporation and Siemens Rolm Communications Inc.
-The term Licensor shall mean any of the Licensors.
-
-Subject to acceptance of the following conditions, permission is hereby
-granted by Licensors without the need for written agreement and without
-license or royalty fees, to use, copy, modify and distribute this
-software for any purpose.
-
-The above copyright notice and the following four paragraphs must be
-reproduced in all copies of this software and any software including
-this software.
-
-THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS AND NO LICENSOR SHALL HAVE
-ANY OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS OR
-MODIFICATIONS.
-
-IN NO EVENT SHALL ANY LICENSOR BE LIABLE TO ANY PARTY FOR DIRECT,
-INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES OR LOST PROFITS ARISING OUT
-OF THE USE OF THIS SOFTWARE EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
-DAMAGE.
-
-EACH LICENSOR SPECIFICALLY DISCLAIMS ANY WARRANTIES, EXPRESS OR IMPLIED,
-INCLUDING BUT NOT LIMITED TO ANY WARRANTY OF NONINFRINGEMENT OR THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-PURPOSE.
-
-The software is provided with RESTRICTED RIGHTS.  Use, duplication, or
-disclosure by the government are subject to restrictions set forth in
-DFARS 252.227-7013 or 48 CFR 52.227-19, as applicable.
-
-***************************************************************************/
-
-/*
- * src: vcc.c
- * doc: Parser for vCard and vCalendar. Note that this code is
- * generated by a yacc parser generator. Generally it should not
- * be edited by hand. The real source is vcc.y. The #line directives
- * can be commented out here to make it easier to trace through
- * in a debugger. However, if a bug is found it should
- * be fixed in vcc.y and this file regenerated.
- */
-
-
-/* debugging utilities */
-#if __DEBUG
-#define DBG_(x) printf x
-#else
-#define DBG_(x)
-#endif
-
-/****  External Functions  ****/
-
-/* assign local name to parser variables and functions so that
-   we can use more than one yacc based parser.
-*/
-
-#if 0
-#define yyparse mime_parse
-#define yylex mime_lex
-#define yyerror mime_error
-#define yychar mime_char
-/* #define p_yyval p_mime_val */
-#undef yyval
-#define yyval mime_yyval
-/* #define p_yylval p_mime_lval */
-#undef yylval
-#define yylval mime_yylval
-#define yydebug mime_debug
-#define yynerrs mime_nerrs
-#define yyerrflag mime_errflag
-#define yyss mime_ss
-#define yyssp mime_ssp
-#define yyvs mime_vs
-#define yyvsp mime_vsp
-#define yylhs mime_lhs
-#define yylen mime_len
-#define yydefred mime_defred
-#define yydgoto mime_dgoto
-#define yysindex mime_sindex
-#define yyrindex mime_rindex
-#define yygindex mime_gindex
-#define yytable mime_table
-#define yycheck mime_check
-#define yyname mime_name
-#define yyrule mime_rule
-#ifdef YYPREFIX
-#undef YYPREFIX
-#endif
-#define YYPREFIX "mime_"
-#endif
-
-
-#ifndef _NO_LINE_FOLDING
-#define _SUPPORT_LINE_FOLDING 1
-#endif
-
-/* undef below if compile with MFC */
-/* #define INCLUDEMFC 1 */
-
-#if defined(WIN32) || defined(_WIN32)
-#ifdef INCLUDEMFC
-#include <afx.h>
-#endif
-#endif
-
-#include <string.h>
-#ifndef __MWERKS__
-#include <stdlib.h>
-#endif
-#include <stdio.h>
-#include <stdlib.h>
-#include <ctype.h>
-
-//#ifdef PALMTOPCENTER
-//#include <qpe/vobject_p.h>
-//#else
-#include "vobject_p.h"
-//#endif
-
-/****  Types, Constants  ****/
-
-        #define YYDEBUG                 0/* 1 to compile in some debugging code */
-        #define MAXTOKEN        256/* maximum token (line) length */
-        #define YYSTACKSIZE     100// ~unref ?
-        #define MAXLEVEL        10/* max # of nested objects parseable */
-                                /* (includes outermost) */
-
-
-/****  Global Variables  ****/
-int mime_lineNum, mime_numErrors; /* yyerror() can use these */
-static VObject* vObjList;
-static VObject *curProp;
-static VObject *curObj;
-static VObject* ObjStack[MAXLEVEL];
-static int ObjStackTop;
-
-
-/* A helpful utility for the rest of the app. */
-#if __CPLUSPLUS__
-extern "C" {
-#endif
-
-    extern void yyerror(char *s);
-
-#if __CPLUSPLUS__
-    };
-#endif
-
-int yyparse();
-
-enum LexMode {
-        L_NORMAL,
-        L_VCARD,
-        L_VCAL,
-        L_VEVENT,
-        L_VTODO,
-        L_VALUES,
-        L_BASE64,
-        L_QUOTED_PRINTABLE
-        };
-
-/****  Private Forward Declarations  ****/
-static int pushVObject(const char *prop);
-static VObject* popVObject();
-static void lexPopMode(int top);
-static int lexWithinMode(enum LexMode mode);
-static void lexPushMode(enum LexMode mode);
-static void enterProps(const char *s);
-static void enterAttr(const char *s1, const char *s2);
-static void enterValues(const char *value);
-#define mime_error yyerror
-void mime_error(char *s);
-void mime_error_(char *s);
-
-%}
-
-/***************************************************************************/
-/***                           The grammar                              ****/
-/***************************************************************************/
-
-%union {
-    char *str;
-    VObject *vobj;
-    }
-
-%token
-        EQ COLON DOT SEMICOLON SPACE HTAB LINESEP NEWLINE
-        BEGIN_VCARD END_VCARD BEGIN_VCAL END_VCAL
-        BEGIN_VEVENT END_VEVENT BEGIN_VTODO END_VTODO
-        ID
-
-/*
- * NEWLINE is the token that would occur outside a vCard,
- * while LINESEP is the token that would occur inside a vCard.
- */
-
-%token <str>
-        STRING ID
-
-%type <str> name value
-
-%type <vobj> vcard vcal vobject
-
-%start mime
-
-%%
-
-
-mime: vobjects
-        ;
-
-vobjects: vobjects vobject
-        { addList(&vObjList, $2); curObj = 0; }
-        | vobject
-                { addList(&vObjList, $1); curObj = 0; }
-        ;
-
-vobject: vcard
-        | vcal
-        ;
-
-vcard:
-        BEGIN_VCARD
-        {
-        lexPushMode(L_VCARD);
-        if (!pushVObject(VCCardProp)) YYERROR;
-        }
-        items END_VCARD
-        {
-        lexPopMode(0);
-        $$ = popVObject();
-        }
-        | BEGIN_VCARD
-        {
-        lexPushMode(L_VCARD);
-        if (!pushVObject(VCCardProp)) YYERROR;
-        }
-        END_VCARD
-        {
-        lexPopMode(0);
-        $$ = popVObject();
-        }
-        ;
-
-items: items item
-        | item
-        ;
-
-item: prop COLON
-        {
-        lexPushMode(L_VALUES);
-        }
-        values LINESEP
-        {
-        if (lexWithinMode(L_BASE64) || lexWithinMode(L_QUOTED_PRINTABLE))
-           lexPopMode(0);
-        lexPopMode(0);
-        }
-        | error
-        ;
-
-prop: name
-        {
-        enterProps($1);
-        }
-        attr_params
-        | name
-        {
-        enterProps($1);
-        }
-        ;
-
-attr_params: attr_params attr_param
-        | attr_param
-        ;
-
-attr_param: SEMICOLON attr
-        ;
-
-attr: name
-        {
-        enterAttr($1,0);
-        }
-        | name EQ name
-        {
-        enterAttr($1,$3);
-
-        }
-        ;
-        
-name: ID
-        ;
-
-values: value SEMICOLON { enterValues($1); } values
-        | value
-        { enterValues($1); }
-        ;
-
-value: STRING
-        |
-        { $$ = 0; }
-        ;
-
-vcal:
-        BEGIN_VCAL
-        { if (!pushVObject(VCCalProp)) YYERROR; }
-        calitems
-        END_VCAL
-        { $$ = popVObject(); }
-        | BEGIN_VCAL
-        { if (!pushVObject(VCCalProp)) YYERROR; }
-        END_VCAL
-        { $$ = popVObject(); }
-        ;
-
-calitems: calitems calitem
-        | calitem
-        ;
-
-calitem:
-        eventitem
-        | todoitem
-        | items
-        ;
-
-eventitem:
-        BEGIN_VEVENT
-        {
-        lexPushMode(L_VEVENT);
-        if (!pushVObject(VCEventProp)) YYERROR;
-        }
-        items
-        END_VEVENT
-        {
-        lexPopMode(0);
-        popVObject();
-        }
-        | BEGIN_VEVENT
-        {
-        lexPushMode(L_VEVENT);
-        if (!pushVObject(VCEventProp)) YYERROR;
-        }
-        END_VEVENT
-        {
-        lexPopMode(0);
-        popVObject();
-        }
-        ;
-
-todoitem:
-        BEGIN_VTODO
-        {
-        lexPushMode(L_VTODO);
-        if (!pushVObject(VCTodoProp)) YYERROR;
-        }
-        items
-        END_VTODO
-        {
-        lexPopMode(0);
-        popVObject();
-        }
-        | BEGIN_VTODO
-        {
-        lexPushMode(L_VTODO);
-        if (!pushVObject(VCTodoProp)) YYERROR;
-        }
-        END_VTODO
-        {
-        lexPopMode(0);
-        popVObject();
-        }
-        ;
-
-%%
-/*------------------------------------*/
-static int pushVObject(const char *prop)
-    {
-    VObject *newObj;
-    if (ObjStackTop == MAXLEVEL)
-        return FALSE;
-
-    ObjStack[++ObjStackTop] = curObj;
-
-    if (curObj) {
-        newObj = addProp(curObj,prop);
-        curObj = newObj;
-        }
-    else
-        curObj = newVObject(prop);
-
-    return TRUE;
-    }
-
-
-/*---------------------------------------*/
-/* This pops the recently built vCard off the stack and returns it. */
-static VObject* popVObject()
-    {
-    VObject *oldObj;
-    if (ObjStackTop < 0) {
-        yyerror("pop on empty Object Stack\n");
-        return 0;
-        }
-    oldObj = curObj;
-    curObj = ObjStack[ObjStackTop--];
-
-    return oldObj;
-    }
-
-
-static void enterValues(const char *value)
-    {
-    if (fieldedProp && *fieldedProp) {
-        if (value) {
-            addPropValue(curProp,*fieldedProp,value);
-            }
-        /* else this field is empty, advance to next field */
-        fieldedProp++;
-        }
-    else {
-        if (value) {
-            setVObjectStringZValue_(curProp,strdup( value ));
-            }
-        }
-    deleteStr(value);
-    }
-
-static void enterProps(const char *s)
-    {
-    curProp = addGroup(curObj,s);
-    deleteStr(s);
-    }
-
-static void enterAttr(const char *s1, const char *s2)
-    {
-    const char *p1, *p2;
-    p1 = lookupProp_(s1);
-    if (s2) {
-        VObject *a;
-        p2 = lookupProp_(s2);
-        a = addProp(curProp,p1);
-        setVObjectStringZValue(a,p2);
-        }
-    else
-        addProp(curProp,p1);
-    if (qstricmp(p1,VCBase64Prop) == 0 || (s2 && qstricmp(p2,VCBase64Prop)==0))
-        lexPushMode(L_BASE64);
-    else if (qstricmp(p1,VCQuotedPrintableProp) == 0
-            || (s2 && qstricmp(p2,VCQuotedPrintableProp)==0))
-        lexPushMode(L_QUOTED_PRINTABLE);
-    deleteStr(s1); deleteStr(s2);
-    }
-
-
-#define MAX_LEX_LOOKAHEAD_0 32
-#define MAX_LEX_LOOKAHEAD 64
-#define MAX_LEX_MODE_STACK_SIZE 10
-#define LEXMODE() (lexBuf.lexModeStack[lexBuf.lexModeStackTop])
-
-struct LexBuf {
-        /* input */
-#ifdef INCLUDEMFC
-    CFile *inputFile;
-#else
-    FILE *inputFile;
-#endif
-    char *inputString;
-    unsigned long curPos;
-    unsigned long inputLen;
-        /* lookahead buffer */
-        /*   -- lookahead buffer is short instead of char so that EOF
-         /      can be represented correctly.
-        */
-    unsigned long len;
-    short buf[MAX_LEX_LOOKAHEAD];
-    unsigned long getPtr;
-        /* context stack */
-    unsigned long lexModeStackTop;
-    enum LexMode lexModeStack[MAX_LEX_MODE_STACK_SIZE];
-        /* token buffer */
-    unsigned long maxToken;
-    char *strs;
-    unsigned long strsLen;
-    } lexBuf;
-
-static void lexPushMode(enum LexMode mode)
-    {
-    if (lexBuf.lexModeStackTop == (MAX_LEX_MODE_STACK_SIZE-1))
-        yyerror("lexical context stack overflow");
-    else {
-        lexBuf.lexModeStack[++lexBuf.lexModeStackTop] = mode;
-        }
-    }
-
-static void lexPopMode(int top)
-    {
-    /* special case of pop for ease of error recovery -- this
-        version will never underflow */
-    if (top)
-        lexBuf.lexModeStackTop = 0;
-    else
-        if (lexBuf.lexModeStackTop > 0) lexBuf.lexModeStackTop--;
-    }
-
-static int lexWithinMode(enum LexMode mode) {
-    unsigned long i;
-    for (i=0;i<lexBuf.lexModeStackTop;i++)
-        if (mode == lexBuf.lexModeStack[i]) return 1;
-    return 0;
-    }
-
-static char lexGetc_()
-    {
-    /* get next char from input, no buffering. */
-    if (lexBuf.curPos == lexBuf.inputLen)
-        return EOF;
-    else if (lexBuf.inputString)
-        return *(lexBuf.inputString + lexBuf.curPos++);
-    else {
-#ifdef INCLUDEMFC
-        char result;
-        return lexBuf.inputFile->Read(&result, 1) == 1 ? result : EOF;
-#else
-        return fgetc(lexBuf.inputFile);
-#endif
-        }
-    }
-
-static int lexGeta()
-    {
-    ++lexBuf.len;
-    return (lexBuf.buf[lexBuf.getPtr] = lexGetc_());
-    }
-
-static int lexGeta_(int i)
-    {
-    ++lexBuf.len;
-    return (lexBuf.buf[(lexBuf.getPtr+i)%MAX_LEX_LOOKAHEAD] = lexGetc_());
-    }
-
-static void lexSkipLookahead() {
-    if (lexBuf.len > 0 && lexBuf.buf[lexBuf.getPtr]!=EOF) {
-        /* don't skip EOF. */
-        lexBuf.getPtr = (lexBuf.getPtr + 1) % MAX_LEX_LOOKAHEAD;
-        lexBuf.len--;
-        }
-    }
-
-static int lexLookahead() {
-    int c = (lexBuf.len)?
-        lexBuf.buf[lexBuf.getPtr]:
-        lexGeta();
-    /* do the \r\n -> \n or \r -> \n translation here */
-    if (c == '\r') {
-        int a = (lexBuf.len>1)?
-            lexBuf.buf[(lexBuf.getPtr+1)%MAX_LEX_LOOKAHEAD]:
-            lexGeta_(1);
-        if (a == '\n') {
-            lexSkipLookahead();
-            }
-        lexBuf.buf[lexBuf.getPtr] = c = '\n';
-        }
-    else if (c == '\n') {
-        int a = (lexBuf.len>1)?
-            lexBuf.buf[lexBuf.getPtr+1]:
-            lexGeta_(1);
-        if (a == '\r') {
-            lexSkipLookahead();
-            }
-        lexBuf.buf[lexBuf.getPtr] = '\n';
-        }
-    return c;
-    }
-
-static int lexGetc() {
-    int c = lexLookahead();
-    if (lexBuf.len > 0 && lexBuf.buf[lexBuf.getPtr]!=EOF) {
-        /* EOF will remain in lookahead buffer */
-        lexBuf.getPtr = (lexBuf.getPtr + 1) % MAX_LEX_LOOKAHEAD;
-        lexBuf.len--;
-        }
-    return c;
-    }
-
-static void lexSkipLookaheadWord() {
-    if (lexBuf.strsLen <= lexBuf.len) {
-        lexBuf.len -= lexBuf.strsLen;
-        lexBuf.getPtr = (lexBuf.getPtr + lexBuf.strsLen) % MAX_LEX_LOOKAHEAD;
-        }
-    }
-
-static void lexClearToken()
-    {
-    lexBuf.strsLen = 0;
-    }
-
-static void lexAppendc(int c)
-    {
-    lexBuf.strs[lexBuf.strsLen] = c;
-    /* append up to zero termination */
-    if (c == 0) return;
-    lexBuf.strsLen++;
-    if (lexBuf.strsLen > lexBuf.maxToken) {
-        /* double the token string size */
-        lexBuf.maxToken <<= 1;
-        lexBuf.strs = (char*) realloc(lexBuf.strs,(size_t)lexBuf.maxToken);
-        }
-    }
-
-static char* lexStr() {
-    return dupStr(lexBuf.strs,(size_t)lexBuf.strsLen+1);
-    }
-
-static void lexSkipWhite() {
-    int c = lexLookahead();
-    while (c == ' ' || c == '\t') {
-        lexSkipLookahead();
-        c = lexLookahead();
-        }
-    }
-
-static char* lexGetWord() {
-    int c;
-    lexSkipWhite();
-    lexClearToken();
-    c = lexLookahead();
-    while (c != EOF && !strchr("\t\n ;:=",c)) {
-        lexAppendc(c);
-        lexSkipLookahead();
-        c = lexLookahead();
-        }
-    lexAppendc(0);
-    return lexStr();
-    }
-
-static void lexPushLookaheadc(int c) {
-    int putptr;
-    /* can't putback EOF, because it never leaves lookahead buffer */
-    if (c == EOF) return;
-    putptr = (int)lexBuf.getPtr - 1;
-    if (putptr < 0) putptr += MAX_LEX_LOOKAHEAD;
-    lexBuf.getPtr = putptr;
-    lexBuf.buf[putptr] = c;
-    lexBuf.len += 1;
-    }
-
-static char* lexLookaheadWord() {
-    /* this function can lookahead word with max size of MAX_LEX_LOOKAHEAD_0
-     /  and thing bigger than that will stop the lookahead and return 0;
-     / leading white spaces are not recoverable.
-     */
-    int c;
-    int len = 0;
-    int curgetptr = 0;
-    lexSkipWhite();
-    lexClearToken();
-            curgetptr = (int)lexBuf.getPtr;// remember!
-    while (len < (MAX_LEX_LOOKAHEAD_0)) {
-        c = lexGetc();
-        len++;
-        if (c == EOF || strchr("\t\n ;:=", c)) {
-            lexAppendc(0);
-            /* restore lookahead buf. */
-            lexBuf.len += len;
-            lexBuf.getPtr = curgetptr;
-            return lexStr();
-            }
-        else
-            lexAppendc(c);
-        }
-            lexBuf.len += len;/* char that has been moved to lookahead buffer */
-    lexBuf.getPtr = curgetptr;
-    return 0;
-    }
-
-#ifdef _SUPPORT_LINE_FOLDING
-static void handleMoreRFC822LineBreak(int c) {
-    /* suport RFC 822 line break in cases like
-             *ADR: foo;
-     *    morefoo;
-     *    more foo;
-     */
-    if (c == ';') {
-        int a;
-        lexSkipLookahead();
-        /* skip white spaces */
-        a = lexLookahead();
-        while (a == ' ' || a == '\t') {
-            lexSkipLookahead();
-            a = lexLookahead();
-            }
-        if (a == '\n') {
-            lexSkipLookahead();
-            a = lexLookahead();
-            if (a == ' ' || a == '\t') {
-                /* continuation, throw away all the \n and spaces read so
-                 * far
-                 */
-                lexSkipWhite();
-                lexPushLookaheadc(';');
-                }
-            else {
-                lexPushLookaheadc('\n');
-                lexPushLookaheadc(';');
-                }
-            }
-        else {
-            lexPushLookaheadc(';');
-            }
-        }
-    }
-
-static char* lexGet1Value() {
-    int c;
-    lexSkipWhite();
-    c = lexLookahead();
-    lexClearToken();
-    while (c != EOF && c != ';') {
-        if (c == '\\' ) {
-            int a;
-            lexSkipLookahead();
-            a = lexLookahead();
-            if ( a != ';' ) {
-                lexAppendc('\\');
-            } else {
-                lexAppendc( ';' );
-                lexSkipLookahead();
-            }
-        } else if (c == '\n') {
-            int a;
-            lexSkipLookahead();
-            a  = lexLookahead();
-            if (a == ' ' || a == '\t') {
-                lexAppendc(' ');
-                lexSkipLookahead();
-                }
-            else {
-                lexPushLookaheadc('\n');
-                break;
-                }
-            }
-        else {
-            lexAppendc(c);
-            lexSkipLookahead();
-            }
-        c = lexLookahead();
-        }
-    lexAppendc(0);
-    handleMoreRFC822LineBreak(c);
-    return c==EOF?0:lexStr();
-    }
-#endif
-
-static int match_begin_name(int end) {
-    char *n = lexLookaheadWord();
-    int token = ID;
-    if (n) {
-        if (!qstricmp(n,"vcard")) token = end?END_VCARD:BEGIN_VCARD;
-        else if (!qstricmp(n,"vcalendar")) token = end?END_VCAL:BEGIN_VCAL;
-        else if (!qstricmp(n,"vevent")) token = end?END_VEVENT:BEGIN_VEVENT;
-        else if (!qstricmp(n,"vtodo")) token = end?END_VTODO:BEGIN_VTODO;
-        deleteStr(n);
-        return token;
-        }
-    return 0;
-    }
-
-
-#ifdef INCLUDEMFC
-void initLex(const char *inputstring, unsigned long inputlen, CFile *inputfile)
-#else
-void initLex(const char *inputstring, unsigned long inputlen, FILE *inputfile)
-#endif
-    {
-    // initialize lex mode stack
-    lexBuf.lexModeStack[lexBuf.lexModeStackTop=0] = L_NORMAL;
-
-    // iniatialize lex buffer.
-    lexBuf.inputString = (char*) inputstring;
-    lexBuf.inputLen = inputlen;
-    lexBuf.curPos = 0;
-    lexBuf.inputFile = inputfile;
-
-    lexBuf.len = 0;
-    lexBuf.getPtr = 0;
-
-    lexBuf.maxToken = MAXTOKEN;
-    lexBuf.strs = (char*)malloc(MAXTOKEN);
-    lexBuf.strsLen = 0;
-
-    }
-
-static void finiLex() {
-    free(lexBuf.strs);
-    }
-
-
-/*-----------------------------------*/
-/* This parses and converts the base64 format for binary encoding into
- * a decoded buffer (allocated with new).  See RFC 1521.
- */
-static char * lexGetDataFromBase64()
-    {
-    unsigned long bytesLen = 0, bytesMax = 0;
-    int quadIx = 0, pad = 0;
-    unsigned long trip = 0;
-    unsigned char b;
-    int c;
-    unsigned char *bytes = NULL;
-    unsigned char *oldBytes = NULL;
-
-    DBG_(("db: lexGetDataFromBase64\n"));
-    while (1) {
-        c = lexGetc();
-        if (c == '\n') {
-            ++mime_lineNum;
-            if (lexLookahead() == '\n') {
-                /* a '\n' character by itself means end of data */
-                break;
-                }
-            else continue; /* ignore '\n' */
-            }
-        else {
-            if ((c >= 'A') && (c <= 'Z'))
-                b = (unsigned char)(c - 'A');
-            else if ((c >= 'a') && (c <= 'z'))
-                b = (unsigned char)(c - 'a') + 26;
-            else if ((c >= '0') && (c <= '9'))
-                b = (unsigned char)(c - '0') + 52;
-            else if (c == '+')
-                b = 62;
-            else if (c == '/')
-                b = 63;
-            else if (c == '=') {
-                b = 0;
-                pad++;
-            } else if ((c == ' ') || (c == '\t')) {
-                continue;
-            } else { /* error condition */
-                if (bytes) free(bytes);
-                else if (oldBytes) free(oldBytes);
-                // error recovery: skip until 2 adjacent newlines.
-                DBG_(("db: invalid character 0x%x '%c'\n", c,c));
-                if (c != EOF)  {
-                    c = lexGetc();
-                    while (c != EOF) {
-                        if (c == '\n' && lexLookahead() == '\n') {
-                            ++mime_lineNum;
-                            break;
-                            }
-                        c = lexGetc();
-                        }
-                    }
-                return NULL;
-                }
-            trip = (trip << 6) | b;
-            if (++quadIx == 4) {
-                unsigned char outBytes[3];
-                int numOut;
-                int i;
-                for (i = 0; i < 3; i++) {
-                    outBytes[2-i] = (unsigned char)(trip & 0xFF);
-                    trip >>= 8;
-                    }
-                numOut = 3 - pad;
-                if (bytesLen + numOut > bytesMax) {
-                    if (!bytes) {
-                        bytesMax = 1024;
-                        bytes = (unsigned char*)malloc((size_t)bytesMax);
-                        }
-                    else {
-                        bytesMax <<= 2;
-                        oldBytes = bytes;
-                        bytes = (unsigned char*)realloc(bytes,(size_t)bytesMax);
-                        }
-                    if (bytes == 0) {
-                        mime_error("out of memory while processing BASE64 data\n");
-                        }
-                    }
-                if (bytes) {
-                    memcpy(bytes + bytesLen, outBytes, numOut);
-                    bytesLen += numOut;
-                    }
-                trip = 0;
-                quadIx = 0;
-                }
-            }
-        } /* while */
-    DBG_(("db: bytesLen = %d\n",  bytesLen));
-    /* kludge: all this won't be necessary if we have tree form
-        representation */
-    if (bytes) {
-        setValueWithSize(curProp,bytes,(unsigned int)bytesLen);
-        free(bytes);
-        }
-    else if (oldBytes) {
-        setValueWithSize(curProp,oldBytes,(unsigned int)bytesLen);
-        free(oldBytes);
-        }
-    return 0;
-    }
-
-static int match_begin_end_name(int end) {
-    int token;
-    lexSkipWhite();
-    if (lexLookahead() != ':') return ID;
-    lexSkipLookahead();
-    lexSkipWhite();
-    token = match_begin_name(end);
-    if (token == ID) {
-        lexPushLookaheadc(':');
-        DBG_(("db: ID '%s'\n", yylval.str));
-        return ID;
-        }
-    else if (token != 0) {
-        lexSkipLookaheadWord();
-        deleteStr(yylval.str);
-        DBG_(("db: begin/end %d\n", token));
-        return token;
-        }
-    return 0;
-    }
-
-static char* lexGetQuotedPrintable()
-    {
-    char cur;
-
-    lexClearToken();
-    do {
-        cur = lexGetc();
-        switch (cur) {
-            case '=': {
-                int c = 0;
-                int next[2];
-                int i;
-                for (i = 0; i < 2; i++) {
-                    next[i] = lexGetc();
-                    if (next[i] >= '0' && next[i] <= '9')
-                        c = c * 16 + next[i] - '0';
-                    else if (next[i] >= 'A' && next[i] <= 'F')
-                        c = c * 16 + next[i] - 'A' + 10;
-                    else
-                        break;
-                    }
-                if (i == 0) {
-                    /* single '=' follow by LINESEP is continuation sign? */
-                    if (next[0] == '\n') {
-                        ++mime_lineNum;
-                        }
-                    else {
-                        lexPushLookaheadc('=');
-                        goto EndString;
-                        }
-                    }
-                else if (i == 1) {
-                    lexPushLookaheadc(next[1]);
-                    lexPushLookaheadc(next[0]);
-                    lexAppendc('=');
-                } else {
-                    lexAppendc(c);
-                    }
-                break;
-                } /* '=' */
-            case '\n': {
-                lexPushLookaheadc('\n');
-                goto EndString;
-                }
-            case (char)EOF:
-                break;
-            default:
-                lexAppendc(cur);
-                break;
-            } /* switch */
-        } while (cur != (char)EOF);
-
-EndString:
-    lexAppendc(0);
-    return lexStr();
-    } /* LexQuotedPrintable */
-
-static int yylex() {
-
-    int lexmode = LEXMODE();
-    if (lexmode == L_VALUES) {
-        int c = lexGetc();
-        if (c == ';') {
-            DBG_(("db: SEMICOLON\n"));
-            lexPushLookaheadc(c);
-            handleMoreRFC822LineBreak(c);
-            lexSkipLookahead();
-            return SEMICOLON;
-            }
-        else if (strchr("\n",c)) {
-            ++mime_lineNum;
-            /* consume all line separator(s) adjacent to each other */
-            c = lexLookahead();
-            while (strchr("\n",c)) {
-                lexSkipLookahead();
-                c = lexLookahead();
-                ++mime_lineNum;
-                }
-            DBG_(("db: LINESEP\n"));
-            return LINESEP;
-            }
-        else {
-            char *p = 0;
-            lexPushLookaheadc(c);
-            if (lexWithinMode(L_BASE64)) {
-                /* get each char and convert to bin on the fly... */
-                p = lexGetDataFromBase64();
-                yylval.str = p;
-                return STRING;
-                }
-            else if (lexWithinMode(L_QUOTED_PRINTABLE)) {
-                p = lexGetQuotedPrintable();
-                }
-            else {
-#ifdef _SUPPORT_LINE_FOLDING
-                p = lexGet1Value();
-#else
-                p = lexGetStrUntil(";\n");
-#endif
-                }
-            if (p) {
-                DBG_(("db: STRING: '%s'\n", p));
-                yylval.str = p;
-                return STRING;
-                }
-            else return 0;
-            }
-        }
-    else {
-        /* normal mode */
-        while (1) {
-            int c = lexGetc();
-            switch(c) {
-                case ':': {
-                    /* consume all line separator(s) adjacent to each other */
-                    /* ignoring linesep immediately after colon. */
-                    c = lexLookahead();
-                    while (strchr("\n",c)) {
-                        lexSkipLookahead();
-                        c = lexLookahead();
-                        ++mime_lineNum;
-                        }
-                    DBG_(("db: COLON\n"));
-                    return COLON;
-                    }
-                case ';':
-                    DBG_(("db: SEMICOLON\n"));
-                    return SEMICOLON;
-                case '=':
-                    DBG_(("db: EQ\n"));
-                    return EQ;
-                /* ignore whitespace in this mode */
-                case '\t':
-                case ' ': continue;
-                case '\n': {
-                    ++mime_lineNum;
-                    continue;
-                    }
-                case EOF: return 0;
-                    break;
-                default: {
-                    lexPushLookaheadc(c);
-                    if (isalnum(c)) {
-                        char *t = lexGetWord();
-                        yylval.str = t;
-                        if (!qstricmp(t, "begin")) {
-                            return match_begin_end_name(0);
-                            }
-                        else if (!qstricmp(t,"end")) {
-                            return match_begin_end_name(1);
-                            }
-                        else {
-                            DBG_(("db: ID '%s'\n", t));
-                            return ID;
-                            }
-                        }
-                    else {
-                        /* unknow token */
-                        return 0;
-                        }
-                    break;
-                    }
-                }
-            }
-        }
-    return 0;
-    }
-
-
-/***************************************************************************/
-        /***                                                    Public Functions                                        ****/
-/***************************************************************************/
-
-static VObject* Parse_MIMEHelper()
-    {
-    ObjStackTop = -1;
-    mime_numErrors = 0;
-    mime_lineNum = 1;
-    vObjList = 0;
-    curObj = 0;
-
-    if (yyparse() != 0)
-        return 0;
-
-    finiLex();
-    return vObjList;
-    }
-
-/*--------------------------------------------*/
-DLLEXPORT(VObject*) Parse_MIME(const char *input, unsigned long len)
-    {
-    initLex(input, len, 0);
-    return Parse_MIMEHelper();
-    }
-
-
-#if INCLUDEMFC
-
-DLLEXPORT(VObject*) Parse_MIME_FromFile(CFile *file)
-    {
-    unsigned long startPos;
-            VObject *result;
-
-    initLex(0,-1,file);
-    startPos = file->GetPosition();
-    if (!(result = Parse_MIMEHelper()))
-        file->Seek(startPos, CFile::begin);
-    return result;
-    }
-
-#else
-
-VObject* Parse_MIME_FromFile(FILE *file)
-    {
-            VObject *result;
-    long startPos;
-
-    initLex(0,(unsigned long)-1,file);
-    startPos = ftell(file);
-    if (!(result = Parse_MIMEHelper())) {
-        fseek(file,startPos,SEEK_SET);
-        }
-    return result;
-    }
-
-DLLEXPORT(VObject*) Parse_MIME_FromFileName(char *fname)
-    {
-    FILE *fp = fopen(fname,"r");
-    if (fp) {
-        VObject* o = Parse_MIME_FromFile(fp);
-        fclose(fp);
-        return o;
-        }
-    else {
-        char msg[80];
-        sprintf(msg, "can't open file '%s' for reading\n", fname);
-        mime_error_(msg);
-        return 0;
-        }
-    }
-
-#endif
-
-/*-------------------------------------*/
-
-static MimeErrorHandler mimeErrorHandler;
-
-DLLEXPORT(void) registerMimeErrorHandler(MimeErrorHandler me)
-    {
-    mimeErrorHandler = me;
-    }
-
-void mime_error(char *s)
-    {
-    char msg[256];
-    if (mimeErrorHandler) {
-        sprintf(msg,"%s at line %d", s, mime_lineNum);
-        mimeErrorHandler(msg);
-        }
-    }
-
-void mime_error_(char *s)
-    {
-    if (mimeErrorHandler) {
-        mimeErrorHandler(s);
-        }
-    }
-
+%{

+

+/***************************************************************************

+(C) Copyright 1996 Apple Computer, Inc., AT&T Corp., International

+Business Machines Corporation and Siemens Rolm Communications Inc.

+

+For purposes of this license notice, the term Licensors shall mean,

+collectively, Apple Computer, Inc., AT&T Corp., International

+Business Machines Corporation and Siemens Rolm Communications Inc.

+The term Licensor shall mean any of the Licensors.

+

+Subject to acceptance of the following conditions, permission is hereby

+granted by Licensors without the need for written agreement and without

+license or royalty fees, to use, copy, modify and distribute this

+software for any purpose.

+

+The above copyright notice and the following four paragraphs must be

+reproduced in all copies of this software and any software including

+this software.

+

+THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS AND NO LICENSOR SHALL HAVE

+ANY OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS OR

+MODIFICATIONS.

+

+IN NO EVENT SHALL ANY LICENSOR BE LIABLE TO ANY PARTY FOR DIRECT,

+INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES OR LOST PROFITS ARISING OUT

+OF THE USE OF THIS SOFTWARE EVEN IF ADVISED OF THE POSSIBILITY OF SUCH

+DAMAGE.

+

+EACH LICENSOR SPECIFICALLY DISCLAIMS ANY WARRANTIES, EXPRESS OR IMPLIED,

+INCLUDING BUT NOT LIMITED TO ANY WARRANTY OF NONINFRINGEMENT OR THE

+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR

+PURPOSE.

+

+The software is provided with RESTRICTED RIGHTS.  Use, duplication, or

+disclosure by the government are subject to restrictions set forth in

+DFARS 252.227-7013 or 48 CFR 52.227-19, as applicable.

+

+***************************************************************************/

+

+/*

+ * src: vcc.c

+ * doc: Parser for vCard and vCalendar. Note that this code is

+ * generated by a yacc parser generator. Generally it should not

+ * be edited by hand. The real source is vcc.y. The #line directives

+ * can be commented out here to make it easier to trace through

+ * in a debugger. However, if a bug is found it should

+ * be fixed in vcc.y and this file regenerated.

+ */

+

+

+/* debugging utilities */

+#if __DEBUG

+#define DBG_(x) printf x

+#else

+#define DBG_(x)

+#endif

+

+/****  External Functions  ****/

+

+/* assign local name to parser variables and functions so that

+   we can use more than one yacc based parser.

+*/

+

+#if 0

+#define yyparse mime_parse

+#define yylex mime_lex

+#define yyerror mime_error

+#define yychar mime_char

+/* #define p_yyval p_mime_val */

+#undef yyval

+#define yyval mime_yyval

+/* #define p_yylval p_mime_lval */

+#undef yylval

+#define yylval mime_yylval

+#define yydebug mime_debug

+#define yynerrs mime_nerrs

+#define yyerrflag mime_errflag

+#define yyss mime_ss

+#define yyssp mime_ssp

+#define yyvs mime_vs

+#define yyvsp mime_vsp

+#define yylhs mime_lhs

+#define yylen mime_len

+#define yydefred mime_defred

+#define yydgoto mime_dgoto

+#define yysindex mime_sindex

+#define yyrindex mime_rindex

+#define yygindex mime_gindex

+#define yytable mime_table

+#define yycheck mime_check

+#define yyname mime_name

+#define yyrule mime_rule

+#ifdef YYPREFIX

+#undef YYPREFIX

+#endif

+#define YYPREFIX "mime_"

+#endif

+

+

+#ifndef _NO_LINE_FOLDING

+#define _SUPPORT_LINE_FOLDING 1

+#endif

+

+/* undef below if compile with MFC */

+/* #define INCLUDEMFC 1 */

+

+#if defined(WIN32) || defined(_WIN32)

+#ifdef INCLUDEMFC

+#include <afx.h>

+#endif

+#endif

+

+#include <string.h>

+#ifndef __MWERKS__

+#include <stdlib.h>

+#endif

+#include <stdio.h>

+#include <stdlib.h>

+#include <ctype.h>

+

+//#ifdef PALMTOPCENTER

+//#include <qpe/vobject_p.h>

+//#else

+#include "vobject_p.h"

+//#endif

+

+/****  Types, Constants  ****/

+

+        #define YYDEBUG                 0/* 1 to compile in some debugging code */

+        #define MAXTOKEN        256/* maximum token (line) length */

+        #define YYSTACKSIZE     100// ~unref ?

+        #define MAXLEVEL        10/* max # of nested objects parseable */

+                                /* (includes outermost) */

+

+

+/****  Global Variables  ****/

+int mime_lineNum, mime_numErrors; /* yyerror() can use these */

+static VObject* vObjList;

+static VObject *curProp;

+static VObject *curObj;

+static VObject* ObjStack[MAXLEVEL];

+static int ObjStackTop;

+

+

+/* A helpful utility for the rest of the app. */

+#if __CPLUSPLUS__

+extern "C" {

+#endif

+

+    extern void yyerror(char *s);

+

+#if __CPLUSPLUS__

+    };

+#endif

+

+int yyparse();

+

+enum LexMode {

+        L_NORMAL,

+        L_VCARD,

+        L_VCAL,

+        L_VEVENT,

+        L_VTODO,

+        L_VALUES,

+        L_BASE64,

+        L_QUOTED_PRINTABLE

+        };

+

+/****  Private Forward Declarations  ****/

+static int pushVObject(const char *prop);

+static VObject* popVObject();

+static void lexPopMode(int top);

+static int lexWithinMode(enum LexMode mode);

+static void lexPushMode(enum LexMode mode);

+static void enterProps(const char *s);

+static void enterAttr(const char *s1, const char *s2);

+static void enterValues(const char *value);

+#define mime_error yyerror

+void mime_error(char *s);

+void mime_error_(char *s);

+

+%}

+

+/***************************************************************************/

+/***                           The grammar                              ****/

+/***************************************************************************/

+

+%union {

+    char *str;

+    VObject *vobj;

+    }

+

+%token

+        EQ COLON DOT SEMICOLON SPACE HTAB LINESEP NEWLINE

+        BEGIN_VCARD END_VCARD BEGIN_VCAL END_VCAL

+        BEGIN_VEVENT END_VEVENT BEGIN_VTODO END_VTODO

+        ID

+

+/*

+ * NEWLINE is the token that would occur outside a vCard,

+ * while LINESEP is the token that would occur inside a vCard.

+ */

+

+%token <str>

+        STRING ID

+

+%type <str> name value

+

+%type <vobj> vcard vcal vobject

+

+%start mime

+

+%%

+

+

+mime: vobjects

+        ;

+

+vobjects: vobjects vobject

+        { addList(&vObjList, $2); curObj = 0; }

+        | vobject

+                { addList(&vObjList, $1); curObj = 0; }

+        ;

+

+vobject: vcard

+        | vcal

+        ;

+

+vcard:

+        BEGIN_VCARD

+        {

+        lexPushMode(L_VCARD);

+        if (!pushVObject(VCCardProp)) YYERROR;

+        }

+        items END_VCARD

+        {

+        lexPopMode(0);

+        $$ = popVObject();

+        }

+        | BEGIN_VCARD

+        {

+        lexPushMode(L_VCARD);

+        if (!pushVObject(VCCardProp)) YYERROR;

+        }

+        END_VCARD

+        {

+        lexPopMode(0);

+        $$ = popVObject();

+        }

+        ;

+

+items: items item

+        | item

+        ;

+

+item: prop COLON

+        {

+        lexPushMode(L_VALUES);

+        }

+        values LINESEP

+        {

+        if (lexWithinMode(L_BASE64) || lexWithinMode(L_QUOTED_PRINTABLE))

+           lexPopMode(0);

+        lexPopMode(0);

+        }

+        | error

+        ;

+

+prop: name

+        {

+        enterProps($1);

+        }

+        attr_params

+        | name

+        {

+        enterProps($1);

+        }

+        ;

+

+attr_params: attr_params attr_param

+        | attr_param

+        ;

+

+attr_param: SEMICOLON attr

+        ;

+

+attr: name

+        {

+        enterAttr($1,0);

+        }

+        | name EQ name

+        {

+        enterAttr($1,$3);

+

+        }

+        ;

+        

+name: ID

+        ;

+

+values: value SEMICOLON { enterValues($1); } values

+        | value

+        { enterValues($1); }

+        ;

+

+value: STRING

+        |

+        { $$ = 0; }

+        ;

+

+vcal:

+        BEGIN_VCAL

+        { if (!pushVObject(VCCalProp)) YYERROR; }

+        calitems

+        END_VCAL

+        { $$ = popVObject(); }

+        | BEGIN_VCAL

+        { if (!pushVObject(VCCalProp)) YYERROR; }

+        END_VCAL

+        { $$ = popVObject(); }

+        ;

+

+calitems: calitems calitem

+        | calitem

+        ;

+

+calitem:

+        eventitem

+        | todoitem

+        | items

+        ;

+

+eventitem:

+        BEGIN_VEVENT

+        {

+        lexPushMode(L_VEVENT);

+        if (!pushVObject(VCEventProp)) YYERROR;

+        }

+        items

+        END_VEVENT

+        {

+        lexPopMode(0);

+        popVObject();

+        }

+        | BEGIN_VEVENT

+        {

+        lexPushMode(L_VEVENT);

+        if (!pushVObject(VCEventProp)) YYERROR;

+        }

+        END_VEVENT

+        {

+        lexPopMode(0);

+        popVObject();

+        }

+        ;

+

+todoitem:

+        BEGIN_VTODO

+        {

+        lexPushMode(L_VTODO);

+        if (!pushVObject(VCTodoProp)) YYERROR;

+        }

+        items

+        END_VTODO

+        {

+        lexPopMode(0);

+        popVObject();

+        }

+        | BEGIN_VTODO

+        {

+        lexPushMode(L_VTODO);

+        if (!pushVObject(VCTodoProp)) YYERROR;

+        }

+        END_VTODO

+        {

+        lexPopMode(0);

+        popVObject();

+        }

+        ;

+

+%%

+/*------------------------------------*/

+static int pushVObject(const char *prop)

+    {

+    VObject *newObj;

+    if (ObjStackTop == MAXLEVEL)

+        return FALSE;

+

+    ObjStack[++ObjStackTop] = curObj;

+

+    if (curObj) {

+        newObj = addProp(curObj,prop);

+        curObj = newObj;

+        }

+    else

+        curObj = newVObject(prop);

+

+    return TRUE;

+    }

+

+

+/*---------------------------------------*/

+/* This pops the recently built vCard off the stack and returns it. */

+static VObject* popVObject()

+    {

+    VObject *oldObj;

+    if (ObjStackTop < 0) {

+        yyerror("pop on empty Object Stack\n");

+        return 0;

+        }

+    oldObj = curObj;

+    curObj = ObjStack[ObjStackTop--];

+

+    return oldObj;

+    }

+

+

+static void enterValues(const char *value)

+    {

+    if (fieldedProp && *fieldedProp) {

+        if (value) {

+            addPropValue(curProp,*fieldedProp,value);

+            }

+        /* else this field is empty, advance to next field */

+        fieldedProp++;

+        }

+    else {

+        if (value) {

+            setVObjectStringZValue_(curProp,strdup( value ));

+            }

+        }

+    deleteStr(value);

+    }

+

+static void enterProps(const char *s)

+    {

+    curProp = addGroup(curObj,s);

+    deleteStr(s);

+    }

+

+static void enterAttr(const char *s1, const char *s2)

+    {

+    const char *p1, *p2;

+    p1 = lookupProp_(s1);

+    if (s2) {

+        VObject *a;

+        p2 = lookupProp_(s2);

+        a = addProp(curProp,p1);

+        setVObjectStringZValue(a,p2);

+        }

+    else

+        addProp(curProp,p1);

+    if (qstricmp(p1,VCBase64Prop) == 0 || (s2 && qstricmp(p2,VCBase64Prop)==0))

+        lexPushMode(L_BASE64);

+    else if (qstricmp(p1,VCQuotedPrintableProp) == 0

+            || (s2 && qstricmp(p2,VCQuotedPrintableProp)==0))

+        lexPushMode(L_QUOTED_PRINTABLE);

+    deleteStr(s1); deleteStr(s2);

+    }

+

+

+#define MAX_LEX_LOOKAHEAD_0 32

+#define MAX_LEX_LOOKAHEAD 64

+#define MAX_LEX_MODE_STACK_SIZE 10

+#define LEXMODE() (lexBuf.lexModeStack[lexBuf.lexModeStackTop])

+

+struct LexBuf {

+        /* input */

+#ifdef INCLUDEMFC

+    CFile *inputFile;

+#else

+    FILE *inputFile;

+#endif

+    char *inputString;

+    unsigned long curPos;

+    unsigned long inputLen;

+        /* lookahead buffer */

+        /*   -- lookahead buffer is short instead of char so that EOF

+         /      can be represented correctly.

+        */

+    unsigned long len;

+    short buf[MAX_LEX_LOOKAHEAD];

+    unsigned long getPtr;

+        /* context stack */

+    unsigned long lexModeStackTop;

+    enum LexMode lexModeStack[MAX_LEX_MODE_STACK_SIZE];

+        /* token buffer */

+    unsigned long maxToken;

+    char *strs;

+    unsigned long strsLen;

+    } lexBuf;

+

+static void lexPushMode(enum LexMode mode)

+    {

+    if (lexBuf.lexModeStackTop == (MAX_LEX_MODE_STACK_SIZE-1))

+        yyerror("lexical context stack overflow");

+    else {

+        lexBuf.lexModeStack[++lexBuf.lexModeStackTop] = mode;

+        }

+    }

+

+static void lexPopMode(int top)

+    {

+    /* special case of pop for ease of error recovery -- this

+        version will never underflow */

+    if (top)

+        lexBuf.lexModeStackTop = 0;

+    else

+        if (lexBuf.lexModeStackTop > 0) lexBuf.lexModeStackTop--;

+    }

+

+static int lexWithinMode(enum LexMode mode) {

+    unsigned long i;

+    for (i=0;i<lexBuf.lexModeStackTop;i++)

+        if (mode == lexBuf.lexModeStack[i]) return 1;

+    return 0;

+    }

+

+static int lexGetc_()

+    {

+    /* get next char from input, no buffering. */

+    if (lexBuf.curPos == lexBuf.inputLen)

+        return EOF;

+    else if (lexBuf.inputString)

+        return *(lexBuf.inputString + lexBuf.curPos++);

+    else {

+#ifdef INCLUDEMFC

+        char result;

+        return lexBuf.inputFile->Read(&result, 1) == 1 ? result : EOF;

+#else

+        return fgetc(lexBuf.inputFile);

+#endif

+        }

+    }

+

+static int lexGeta()

+    {

+    ++lexBuf.len;

+    return (lexBuf.buf[lexBuf.getPtr] = lexGetc_());

+    }

+

+static int lexGeta_(int i)

+    {

+    ++lexBuf.len;

+    return (lexBuf.buf[(lexBuf.getPtr+i)%MAX_LEX_LOOKAHEAD] = lexGetc_());

+    }

+

+static void lexSkipLookahead() {

+    if (lexBuf.len > 0 && lexBuf.buf[lexBuf.getPtr]!=EOF) {

+        /* don't skip EOF. */

+        lexBuf.getPtr = (lexBuf.getPtr + 1) % MAX_LEX_LOOKAHEAD;

+        lexBuf.len--;

+        }

+    }

+

+static int lexLookahead() {

+    int c = (lexBuf.len)?

+        lexBuf.buf[lexBuf.getPtr]:

+        lexGeta();

+    /* do the \r\n -> \n or \r -> \n translation here */

+    if (c == '\r') {

+        int a = (lexBuf.len>1)?

+            lexBuf.buf[(lexBuf.getPtr+1)%MAX_LEX_LOOKAHEAD]:

+            lexGeta_(1);

+        if (a == '\n') {

+            lexSkipLookahead();

+            }

+        lexBuf.buf[lexBuf.getPtr] = c = '\n';

+        }

+    else if (c == '\n') {

+        int a = (lexBuf.len>1)?

+            lexBuf.buf[lexBuf.getPtr+1]:

+            lexGeta_(1);

+        if (a == '\r') {

+            lexSkipLookahead();

+            }

+        lexBuf.buf[lexBuf.getPtr] = '\n';

+        }

+    return c;

+    }

+

+static int lexGetc() {

+    int c = lexLookahead();

+    if (lexBuf.len > 0 && lexBuf.buf[lexBuf.getPtr]!=EOF) {

+        /* EOF will remain in lookahead buffer */

+        lexBuf.getPtr = (lexBuf.getPtr + 1) % MAX_LEX_LOOKAHEAD;

+        lexBuf.len--;

+        }

+    return c;

+    }

+

+static void lexSkipLookaheadWord() {

+    if (lexBuf.strsLen <= lexBuf.len) {

+        lexBuf.len -= lexBuf.strsLen;

+        lexBuf.getPtr = (lexBuf.getPtr + lexBuf.strsLen) % MAX_LEX_LOOKAHEAD;

+        }

+    }

+

+static void lexClearToken()

+    {

+    lexBuf.strsLen = 0;

+    }

+

+static void lexAppendc(int c)

+    {

+    lexBuf.strs[lexBuf.strsLen] = c;

+    /* append up to zero termination */

+    if (c == 0) return;

+    lexBuf.strsLen++;

+    if (lexBuf.strsLen > lexBuf.maxToken) {

+        /* double the token string size */

+        lexBuf.maxToken <<= 1;

+        lexBuf.strs = (char*) realloc(lexBuf.strs,(size_t)lexBuf.maxToken);

+        }

+    }

+

+static char* lexStr() {

+    return dupStr(lexBuf.strs,(size_t)lexBuf.strsLen+1);

+    }

+

+static void lexSkipWhite() {

+    int c = lexLookahead();

+    while (c == ' ' || c == '\t') {

+        lexSkipLookahead();

+        c = lexLookahead();

+        }

+    }

+

+static char* lexGetWord() {

+    int c;

+    lexSkipWhite();

+    lexClearToken();

+    c = lexLookahead();

+    while (c != EOF && !strchr("\t\n ;:=",c)) {

+        lexAppendc(c);

+        lexSkipLookahead();

+        c = lexLookahead();

+        }

+    lexAppendc(0);

+    return lexStr();

+    }

+

+static void lexPushLookaheadc(int c) {

+    int putptr;

+    /* can't putback EOF, because it never leaves lookahead buffer */

+    if (c == EOF) return;

+    putptr = (int)lexBuf.getPtr - 1;

+    if (putptr < 0) putptr += MAX_LEX_LOOKAHEAD;

+    lexBuf.getPtr = putptr;

+    lexBuf.buf[putptr] = c;

+    lexBuf.len += 1;

+    }

+

+static char* lexLookaheadWord() {

+    /* this function can lookahead word with max size of MAX_LEX_LOOKAHEAD_0

+     /  and thing bigger than that will stop the lookahead and return 0;

+     / leading white spaces are not recoverable.

+     */

+    int c;

+    int len = 0;

+    int curgetptr = 0;

+    lexSkipWhite();

+    lexClearToken();

+            curgetptr = (int)lexBuf.getPtr;// remember!

+    while (len < (MAX_LEX_LOOKAHEAD_0)) {

+        c = lexGetc();

+        len++;

+        if (c == EOF || strchr("\t\n ;:=", c)) {

+            lexAppendc(0);

+            /* restore lookahead buf. */

+            lexBuf.len += len;

+            lexBuf.getPtr = curgetptr;

+            return lexStr();

+            }

+        else

+            lexAppendc(c);

+        }

+            lexBuf.len += len;/* char that has been moved to lookahead buffer */

+    lexBuf.getPtr = curgetptr;

+    return 0;

+    }

+

+#ifdef _SUPPORT_LINE_FOLDING

+static void handleMoreRFC822LineBreak(int c) {

+    /* suport RFC 822 line break in cases like

+             *ADR: foo;

+     *    morefoo;

+     *    more foo;

+     */

+    if (c == ';') {

+        int a;

+        lexSkipLookahead();

+        /* skip white spaces */

+        a = lexLookahead();

+        while (a == ' ' || a == '\t') {

+            lexSkipLookahead();

+            a = lexLookahead();

+            }

+        if (a == '\n') {

+            lexSkipLookahead();

+            a = lexLookahead();

+            if (a == ' ' || a == '\t') {

+                /* continuation, throw away all the \n and spaces read so

+                 * far

+                 */

+                lexSkipWhite();

+                lexPushLookaheadc(';');

+                }

+            else {

+                lexPushLookaheadc('\n');

+                lexPushLookaheadc(';');

+                }

+            }

+        else {

+            lexPushLookaheadc(';');

+            }

+        }

+    }

+

+static char* lexGet1Value() {

+    int c;

+    lexSkipWhite();

+    c = lexLookahead();

+    lexClearToken();

+    while (c != EOF && c != ';') {

+        if (c == '\\' ) {

+            int a;

+            lexSkipLookahead();

+            a = lexLookahead();

+            if ( a != ';' ) {

+                lexAppendc('\\');

+            } else {

+                lexAppendc( ';' );

+                lexSkipLookahead();

+            }

+        } else if (c == '\n') {

+            int a;

+            lexSkipLookahead();

+            a  = lexLookahead();

+            if (a == ' ' || a == '\t') {

+                lexAppendc(' ');

+                lexSkipLookahead();

+                }

+            else {

+                lexPushLookaheadc('\n');

+                break;

+                }

+            }

+        else {

+            lexAppendc(c);

+            lexSkipLookahead();

+            }

+        c = lexLookahead();

+        }

+    lexAppendc(0);

+    handleMoreRFC822LineBreak(c);

+    return c==EOF?0:lexStr();

+    }

+#endif

+

+static int match_begin_name(int end) {

+    char *n = lexLookaheadWord();

+    int token = ID;

+    if (n) {

+        if (!qstricmp(n,"vcard")) token = end?END_VCARD:BEGIN_VCARD;

+        else if (!qstricmp(n,"vcalendar")) token = end?END_VCAL:BEGIN_VCAL;

+        else if (!qstricmp(n,"vevent")) token = end?END_VEVENT:BEGIN_VEVENT;

+        else if (!qstricmp(n,"vtodo")) token = end?END_VTODO:BEGIN_VTODO;

+        deleteStr(n);

+        return token;

+        }

+    return 0;

+    }

+

+

+#ifdef INCLUDEMFC

+void initLex(const char *inputstring, unsigned long inputlen, CFile *inputfile)

+#else

+void initLex(const char *inputstring, unsigned long inputlen, FILE *inputfile)

+#endif

+    {

+    // initialize lex mode stack

+    lexBuf.lexModeStack[lexBuf.lexModeStackTop=0] = L_NORMAL;

+

+    // iniatialize lex buffer.

+    lexBuf.inputString = (char*) inputstring;

+    lexBuf.inputLen = inputlen;

+    lexBuf.curPos = 0;

+    lexBuf.inputFile = inputfile;

+

+    lexBuf.len = 0;

+    lexBuf.getPtr = 0;

+

+    lexBuf.maxToken = MAXTOKEN;

+    lexBuf.strs = (char*)malloc(MAXTOKEN);

+    lexBuf.strsLen = 0;

+

+    }

+

+static void finiLex() {

+    free(lexBuf.strs);

+    }

+

+

+/*-----------------------------------*/

+/* This parses and converts the base64 format for binary encoding into

+ * a decoded buffer (allocated with new).  See RFC 1521.

+ */

+static char * lexGetDataFromBase64()

+    {

+    unsigned long bytesLen = 0, bytesMax = 0;

+    int quadIx = 0, pad = 0;

+    unsigned long trip = 0;

+    unsigned char b;

+    int c;

+    unsigned char *bytes = NULL;

+    unsigned char *oldBytes = NULL;

+

+    DBG_(("db: lexGetDataFromBase64\n"));

+    while (1) {

+        c = lexGetc();

+        if (c == '\n') {

+            ++mime_lineNum;

+            if (lexLookahead() == '\n') {

+                /* a '\n' character by itself means end of data */

+                break;

+                }

+            else continue; /* ignore '\n' */

+            }

+        else {

+            if ((c >= 'A') && (c <= 'Z'))

+                b = (unsigned char)(c - 'A');

+            else if ((c >= 'a') && (c <= 'z'))

+                b = (unsigned char)(c - 'a') + 26;

+            else if ((c >= '0') && (c <= '9'))

+                b = (unsigned char)(c - '0') + 52;

+            else if (c == '+')

+                b = 62;

+            else if (c == '/')

+                b = 63;

+            else if (c == '=') {

+                b = 0;

+                pad++;

+            } else if ((c == ' ') || (c == '\t')) {

+                continue;

+            } else { /* error condition */

+                if (bytes) free(bytes);

+                else if (oldBytes) free(oldBytes);

+                // error recovery: skip until 2 adjacent newlines.

+                DBG_(("db: invalid character 0x%x '%c'\n", c,c));

+                if (c != EOF)  {

+                    c = lexGetc();

+                    while (c != EOF) {

+                        if (c == '\n' && lexLookahead() == '\n') {

+                            ++mime_lineNum;

+                            break;

+                            }

+                        c = lexGetc();

+                        }

+                    }

+                return NULL;

+                }

+            trip = (trip << 6) | b;

+            if (++quadIx == 4) {

+                unsigned char outBytes[3];

+                int numOut;

+                int i;

+                for (i = 0; i < 3; i++) {

+                    outBytes[2-i] = (unsigned char)(trip & 0xFF);

+                    trip >>= 8;

+                    }

+                numOut = 3 - pad;

+                if (bytesLen + numOut > bytesMax) {

+                    if (!bytes) {

+                        bytesMax = 1024;

+                        bytes = (unsigned char*)malloc((size_t)bytesMax);

+                        }

+                    else {

+                        bytesMax <<= 2;

+                        oldBytes = bytes;

+                        bytes = (unsigned char*)realloc(bytes,(size_t)bytesMax);

+                        }

+                    if (bytes == 0) {

+                        mime_error("out of memory while processing BASE64 data\n");

+                        }

+                    }

+                if (bytes) {

+                    memcpy(bytes + bytesLen, outBytes, numOut);

+                    bytesLen += numOut;

+                    }

+                trip = 0;

+                quadIx = 0;

+                }

+            }

+        } /* while */

+    DBG_(("db: bytesLen = %d\n",  bytesLen));

+    /* kludge: all this won't be necessary if we have tree form

+        representation */

+    if (bytes) {

+        setValueWithSize(curProp,bytes,(unsigned int)bytesLen);

+        free(bytes);

+        }

+    else if (oldBytes) {

+        setValueWithSize(curProp,oldBytes,(unsigned int)bytesLen);

+        free(oldBytes);

+        }

+    return 0;

+    }

+

+static int match_begin_end_name(int end) {

+    int token;

+    lexSkipWhite();

+    if (lexLookahead() != ':') return ID;

+    lexSkipLookahead();

+    lexSkipWhite();

+    token = match_begin_name(end);

+    if (token == ID) {

+        lexPushLookaheadc(':');

+        DBG_(("db: ID '%s'\n", yylval.str));

+        return ID;

+        }

+    else if (token != 0) {

+        lexSkipLookaheadWord();

+        deleteStr(yylval.str);

+        DBG_(("db: begin/end %d\n", token));

+        return token;

+        }

+    return 0;

+    }

+

+static char* lexGetQuotedPrintable()

+{

+    int c;

+    lexSkipWhite();

+    c = lexLookahead();

+    lexClearToken();

+

+    while (c != EOF && c != ';') {

+        if (c == '\n') {

+            // break, leave '\n' on remaining chars.

+            break;

+        } else if (c == '=') {

+            int cur = 0;

+            int next;

+

+            lexSkipLookahead(); // skip '='

+            next = lexLookahead();

+

+            if (next == '\n') {

+                // skip and only skip the \n

+                lexSkipLookahead(); 

+                c = lexLookahead();

+                ++mime_lineNum; // aid in error reporting

+                continue;

+            } else if (next >= '0' && next <= '9') {

+                cur = next - '0';

+            } else if (next >= 'A' && next <= 'F') {

+                cur = next - 'A' + 10;

+            } else {

+                // we have been sent buggy stuff. doesn't matter

+                // what we do so long as we keep going.

+                // should probably spit an error here

+                c = lexLookahead();

+                continue;

+            }

+

+            lexSkipLookahead(); // skip A-Z0-9

+            next = lexLookahead();

+

+            cur = cur * 16;

+            // this time really just expecting 0-9A-F

+            if (next >= '0' && next <= '9') {

+                cur += next - '0';

+            } else if (next >= 'A' && next <= 'F') {

+                cur += next - 'A' + 10;

+            } else {

+                // we have been sent buggy stuff. doesn't matter

+                // what we do so long as we keep going.

+                // should probably spit an error here

+                c = lexLookahead();

+                continue;

+            }

+

+            // got a valid escaped =.  append it.

+            lexSkipLookahead(); // skip second 0-9A-F

+            lexAppendc(cur);

+        } else {

+            lexSkipLookahead(); // skip whatever we just read.

+            lexAppendc(c); // and append it.

+        }

+        c = lexLookahead();

+    }

+    lexAppendc(0);

+    return c==EOF?0:lexStr();

+}

+

+static int yylex() {

+

+    int lexmode = LEXMODE();

+    if (lexmode == L_VALUES) {

+        int c = lexGetc();

+        if (c == ';') {

+            DBG_(("db: SEMICOLON\n"));

+            lexPushLookaheadc(c);

+            handleMoreRFC822LineBreak(c);

+            lexSkipLookahead();

+            return SEMICOLON;

+            }

+        else if (strchr("\n",c)) {

+            ++mime_lineNum;

+            /* consume all line separator(s) adjacent to each other */

+            c = lexLookahead();

+            while (strchr("\n",c)) {

+                lexSkipLookahead();

+                c = lexLookahead();

+                ++mime_lineNum;

+                }

+            DBG_(("db: LINESEP\n"));

+            return LINESEP;

+            }

+        else {

+            char *p = 0;

+            lexPushLookaheadc(c);

+            if (lexWithinMode(L_BASE64)) {

+                /* get each char and convert to bin on the fly... */

+                p = lexGetDataFromBase64();

+                yylval.str = p;

+                return STRING;

+                }

+            else if (lexWithinMode(L_QUOTED_PRINTABLE)) {

+                p = lexGetQuotedPrintable();

+                }

+            else {

+#ifdef _SUPPORT_LINE_FOLDING

+                p = lexGet1Value();

+#else

+                p = lexGetStrUntil(";\n");

+#endif

+                }

+            if (p) {

+                DBG_(("db: STRING: '%s'\n", p));

+                yylval.str = p;

+                return STRING;

+                }

+            else return 0;

+            }

+        }

+    else {

+        /* normal mode */

+        while (1) {

+            int c = lexGetc();

+            switch(c) {

+                case ':': {

+                    /* consume all line separator(s) adjacent to each other */

+                    /* ignoring linesep immediately after colon. */

+                    c = lexLookahead();

+                    while (strchr("\n",c)) {

+                        lexSkipLookahead();

+                        c = lexLookahead();

+                        ++mime_lineNum;

+                        }

+                    DBG_(("db: COLON\n"));

+                    return COLON;

+                    }

+                case ';':

+                    DBG_(("db: SEMICOLON\n"));

+                    return SEMICOLON;

+                case '=':

+                    DBG_(("db: EQ\n"));

+                    return EQ;

+                /* ignore whitespace in this mode */

+                case '\t':

+                case ' ': continue;

+                case '\n': {

+                    ++mime_lineNum;

+                    continue;

+                    }

+                case EOF: return 0;

+                    break;

+                default: {

+                    lexPushLookaheadc(c);

+                    if (isalnum(c)) {

+                        char *t = lexGetWord();

+                        yylval.str = t;

+                        if (!qstricmp(t, "begin")) {

+                            return match_begin_end_name(0);

+                            }

+                        else if (!qstricmp(t,"end")) {

+                            return match_begin_end_name(1);

+                            }

+                        else {

+                            DBG_(("db: ID '%s'\n", t));

+                            return ID;

+                            }

+                        }

+                    else {

+                        /* unknow token */

+                        return 0;

+                        }

+                    break;

+                    }

+                }

+            }

+        }

+    return 0;

+    }

+

+

+/***************************************************************************/

+        /***                                                    Public Functions                                        ****/

+/***************************************************************************/

+

+static VObject* Parse_MIMEHelper()

+    {

+    ObjStackTop = -1;

+    mime_numErrors = 0;

+    mime_lineNum = 1;

+    vObjList = 0;

+    curObj = 0;

+

+    if (yyparse() != 0)

+        return 0;

+

+    finiLex();

+    return vObjList;

+    }

+

+/*--------------------------------------------*/

+DLLEXPORT(VObject*) Parse_MIME(const char *input, unsigned long len)

+    {

+    initLex(input, len, 0);

+    return Parse_MIMEHelper();

+    }

+

+

+#if INCLUDEMFC

+

+DLLEXPORT(VObject*) Parse_MIME_FromFile(CFile *file)

+    {

+    unsigned long startPos;

+            VObject *result;

+

+    initLex(0,-1,file);

+    startPos = file->GetPosition();

+    if (!(result = Parse_MIMEHelper()))

+        file->Seek(startPos, CFile::begin);

+    return result;

+    }

+

+#else

+

+VObject* Parse_MIME_FromFile(FILE *file)

+    {

+            VObject *result;

+    long startPos;

+

+    initLex(0,(unsigned long)-1,file);

+    startPos = ftell(file);

+    if (!(result = Parse_MIMEHelper())) {

+        fseek(file,startPos,SEEK_SET);

+        }

+    return result;

+    }

+

+DLLEXPORT(VObject*) Parse_MIME_FromFileName(char *fname)

+    {

+    FILE *fp = fopen(fname,"r");

+    if (fp) {

+        VObject* o = Parse_MIME_FromFile(fp);

+        fclose(fp);

+        return o;

+        }

+    else {

+        char msg[80];

+        sprintf(msg, "can't open file '%s' for reading\n", fname);

+        mime_error_(msg);

+        return 0;

+        }

+    }

+

+#endif

+

+/*-------------------------------------*/

+

+static MimeErrorHandler mimeErrorHandler;

+

+DLLEXPORT(void) registerMimeErrorHandler(MimeErrorHandler me)

+    {

+    mimeErrorHandler = me;

+    }

+

+void mime_error(char *s)

+    {

+    char msg[256];

+    if (mimeErrorHandler) {

+        sprintf(msg,"%s at line %d", s, mime_lineNum);

+        mimeErrorHandler(msg);

+        }

+    }

+

+void mime_error_(char *s)

+    {

+    if (mimeErrorHandler) {

+        mimeErrorHandler(s);

+        }

+    }

+

diff --git a/library/backend/vcc_yacc.cpp b/library/backend/vcc_yacc.cpp
index cb24631..19a108f 100644
--- a/library/backend/vcc_yacc.cpp
+++ b/library/backend/vcc_yacc.cpp
@@ -1,19 +1,44 @@
 #ifndef lint
-        static char yysccsid[] = "@(#)yaccpar1.9 (Berkeley) 02/21/93";
+        /*static char yysccsid[] = "from: @(#)yaccpar1.9 (Berkeley) 02/21/93";*/
+static char yyrcsid[] = "$Id$";
 #endif
 #define YYBYACC 1
 #define YYMAJOR 1
 #define YYMINOR 9
 #define yyclearin (yychar=(-1))
 #define yyerrok (yyerrflag=0)
 #define YYRECOVERING (yyerrflag!=0)
-#define YYPREFIX "yy"
-#line 1 "vcc.y"
+#define yyparse vccparse
+#define yylex vcclex
+#define yyerror vccerror
+#define yychar vccchar
+#define yyval vccval
+#define yylval vcclval
+#define yydebug vccdebug
+#define yynerrs vccnerrs
+#define yyerrflag vccerrflag
+#define yyss vccss
+#define yyssp vccssp
+#define yyvs vccvs
+#define yyvsp vccvsp
+#define yylhs vcclhs
+#define yylen vcclen
+#define yydefred vccdefred
+#define yydgoto vccdgoto
+#define yysindex vccsindex
+#define yyrindex vccrindex
+#define yygindex vccgindex
+#define yytable vcctable
+#define yycheck vcccheck
+#define yyname vccname
+#define yyrule vccrule
+#define YYPREFIX "vcc"
+#line 1 "backend/vcc.y"
 

 

 /***************************************************************************

 (C) Copyright 1996 Apple Computer, Inc., AT&T Corp., International

 Business Machines Corporation and Siemens Rolm Communications Inc.

 

 For purposes of this license notice, the term Licensors shall mean,

 collectively, Apple Computer, Inc., AT&T Corp., International

@@ -68,16 +93,17 @@ DFARS 252.227-7013 or 48 CFR 52.227-19, as applicable.
 #endif

 

 /****  External Functions  ****/

 

 /* assign local name to parser variables and functions so that

    we can use more than one yacc based parser.

 */

 

+#if 0

 #define yyparse mime_parse

 #define yylex mime_lex

 #define yyerror mime_error

 #define yychar mime_char

 /* #define p_yyval p_mime_val */

 #undef yyval

 #define yyval mime_yyval

 /* #define p_yylval p_mime_lval */

@@ -100,16 +126,17 @@ DFARS 252.227-7013 or 48 CFR 52.227-19, as applicable.
 #define yytable mime_table

 #define yycheck mime_check

 #define yyname mime_name

 #define yyrule mime_rule

 #ifdef YYPREFIX

 #undef YYPREFIX

 #endif

 #define YYPREFIX "mime_"

+#endif

 

 

 #ifndef _NO_LINE_FOLDING

 #define _SUPPORT_LINE_FOLDING 1

 #endif

 

 /* undef below if compile with MFC */

 /* #define INCLUDEMFC 1 */

@@ -123,30 +150,27 @@ DFARS 252.227-7013 or 48 CFR 52.227-19, as applicable.
 #include <string.h>

 #ifndef __MWERKS__

 #include <stdlib.h>

 #endif

 #include <stdio.h>

 #include <stdlib.h>

 #include <ctype.h>

 

-#ifdef PALMTOPCENTER
-#include <qpe/vobject_p.h>

-#include <qpe/qfiledirect_p.h>
-#else
+/*#ifdef PALMTOPCENTER
*/
+/*#include <qpe/vobject_p.h>
*/
+/*#else
*/
 #include "vobject_p.h"

-#include "qfiledirect_p.h"
-#endif
+/*#endif
*/
 

 /****  Types, Constants  ****/

 

         #define YYDEBUG                 0/* 1 to compile in some debugging code */

         #define MAXTOKEN        256/* maximum token (line) length */

-        #define YYSTACKSIZE     100/* ~unref ?
-*/
+        #define YYSTACKSIZE     100/* ~unref ?
*/
         #define MAXLEVEL        10/* max # of nested objects parseable */

                                 /* (includes outermost) */

 

 

 /****  Global Variables  ****/

 int mime_lineNum, mime_numErrors; /* yyerror() can use these */

 static VObject* vObjList;

 static VObject *curProp;

@@ -183,24 +207,26 @@ enum LexMode {
 static int pushVObject(const char *prop);

 static VObject* popVObject();

 static void lexPopMode(int top);

 static int lexWithinMode(enum LexMode mode);

 static void lexPushMode(enum LexMode mode);

 static void enterProps(const char *s);

 static void enterAttr(const char *s1, const char *s2);

 static void enterValues(const char *value);

+#define mime_error yyerror

+void mime_error(char *s);

 void mime_error_(char *s);

 

-#line 185 "vcc.y"
+#line 189 "backend/vcc.y"
 typedef union {

     char *str;

     VObject *vobj;

     } YYSTYPE;
-#line 196 "y.tab.c"
+#line 225 "y.tab.c"
 #define EQ 257
 #define COLON 258
 #define DOT 259
 #define SEMICOLON 260
 #define SPACE 261
 #define HTAB 262
 #define LINESEP 263
 #define NEWLINE 264
@@ -210,103 +236,103 @@ typedef union {
 #define END_VCAL 268
 #define BEGIN_VEVENT 269
 #define END_VEVENT 270
 #define BEGIN_VTODO 271
 #define END_VTODO 272
 #define ID 273
 #define STRING 274
 #define YYERRCODE 256
-short yylhs[] = {                                        -1,
+short vcclhs[] = {                                        -1,
     0,    6,    6,    5,    5,    8,    3,    9,    3,    7,
     7,   13,   10,   10,   15,   11,   11,   14,   14,   16,
    17,   17,    1,   18,   12,   12,    2,    2,   20,    4,
    21,    4,   19,   19,   22,   22,   22,   25,   23,   26,
    23,   27,   24,   28,   24,
 };
-short yylen[] = {                                         2,
+short vcclen[] = {                                         2,
     1,    2,    1,    1,    1,    0,    4,    0,    3,    2,
     1,    0,    5,    1,    0,    3,    1,    2,    1,    2,
     1,    3,    1,    0,    4,    1,    1,    0,    0,    4,
     0,    3,    2,    1,    1,    1,    1,    0,    4,    0,
     3,    0,    4,    0,    3,
 };
-short yydefred[] = {                                      0,
+short vccdefred[] = {                                      0,
     0,    0,    0,    4,    5,    3,    0,    0,    0,    0,
     0,    2,   14,   23,    0,    0,   11,    0,    9,    0,
     0,    0,    0,   34,   35,   36,   32,    0,    7,   10,
    12,    0,    0,    0,    0,   30,   33,    0,    0,   19,
     0,    0,   41,    0,   45,    0,   20,   18,   27,    0,
     0,   39,   43,    0,   24,   13,   22,    0,   25,
 };
-short yydgoto[] = {                                       3,
+short vccdgoto[] = {                                       3,
    15,   50,    4,    5,    6,    7,   22,    8,    9,   17,
    18,   51,   41,   39,   28,   40,   47,   58,   23,   10,
    11,   24,   25,   26,   32,   33,   34,   35,
 };
-short yysindex[] = {                                   -262,
+short vccsindex[] = {                                   -262,
     0,    0,    0,    0,    0,    0, -262, -252, -219, -249,
  -256,    0,    0,    0,    0, -227,    0, -242,    0,    0,
     0, -252, -254,    0,    0,    0,    0, -208,    0,    0,
     0, -252, -228, -252, -213,    0,    0, -212, -208,    0,
  -214, -233,    0, -224,    0, -195,    0,    0,    0, -197,
  -199,    0,    0, -212,    0,    0,    0, -214,    0,
 };
-short yyrindex[] = {                                      0,
+short vccrindex[] = {                                      0,
  -222, -238,    0,    0,    0,    0,   65,    0,    0,    0,
     0,    0,    0,    0, -215,    0,    0,    0,    0, -220,
  -218, -260,    0,    0,    0,    0,    0,    0,    0,    0,
     0,    0,    0,    0,    0,    0,    0,    0, -192,    0,
  -250,    0,    0,    0,    0, -202,    0,    0,    0, -196,
     0,    0,    0,    0,    0,    0,    0, -250,    0,
 };
-short yygindex[] = {                                      0,
+short vccgindex[] = {                                      0,
     3,    0,    0,    0,   61,    0,   -7,    0,    0,  -16,
     0,   11,    0,    0,    0,   31,    0,    0,    0,    0,
     0,   48,    0,    0,    0,    0,    0,    0,
 };
 #define YYTABLESIZE 71
-short yytable[] = {                                      30,
+short vcctable[] = {                                      30,
    16,   13,    1,   13,    2,   30,   13,   37,   37,   28,
    37,   27,   28,   36,   20,   31,   21,   29,   14,   20,
    14,   21,   13,   14,   42,   30,   44,   30,   13,   31,
    29,   13,   29,    6,   29,   38,   52,   42,   29,   14,
    46,   43,   17,    8,   15,   14,   19,   53,   14,   40,
     6,   38,   38,   44,   42,   21,   57,   21,   45,   49,
    14,   54,   55,   56,    1,   16,   26,   12,   59,   48,
    37,
 };
-short yycheck[] = {                                      16,
+short vcccheck[] = {                                      16,
     8,  256,  265,  256,  267,   22,  256,  268,  269,  260,
   271,  268,  263,  268,  269,  258,  271,  256,  273,  269,
   273,  271,  256,  273,   32,   42,   34,   44,  256,  268,
   269,  256,  271,  256,  273,  256,  270,  256,  266,  273,
    38,  270,  258,  266,  260,  273,  266,  272,  273,  270,
   273,  260,  273,  272,  273,  258,   54,  260,  272,  274,
   273,  257,  260,  263,    0,  258,  263,    7,   58,   39,
    23,
 };
 #define YYFINAL 3
 #ifndef YYDEBUG
 #define YYDEBUG 0
 #endif
 #define YYMAXTOKEN 274
 #if YYDEBUG
-char *yyname[] = {
+char *vccname[] = {
 "end-of-file",0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,"EQ","COLON","DOT","SEMICOLON",
 "SPACE","HTAB","LINESEP","NEWLINE","BEGIN_VCARD","END_VCARD","BEGIN_VCAL",
 "END_VCAL","BEGIN_VEVENT","END_VEVENT","BEGIN_VTODO","END_VTODO","ID","STRING",
 };
-char *yyrule[] = {
+char *vccrule[] = {
 "$accept : mime",
 "mime : vobjects",
 "vobjects : vobjects vobject",
 "vobjects : vobject",
 "vobject : vcard",
 "vobject : vcal",
 "$$1 :",
 "vcard : BEGIN_VCARD $$1 items END_VCARD",
@@ -367,17 +393,17 @@ int yyerrflag;
 int yychar;
 short *yyssp;
 YYSTYPE *yyvsp;
 YYSTYPE yyval;
 YYSTYPE yylval;
 short yyss[YYSTACKSIZE];
 YYSTYPE yyvs[YYSTACKSIZE];
 #define yystacksize YYSTACKSIZE
-#line 378 "vcc.y"
+#line 382 "backend/vcc.y"
 

 /*------------------------------------*/

 static int pushVObject(const char *prop)

     {

     VObject *newObj;

     if (ObjStackTop == MAXLEVEL)

         return FALSE;

 

@@ -506,17 +532,17 @@ static void lexPopMode(int top)
 

 static int lexWithinMode(enum LexMode mode) {

     unsigned long i;

     for (i=0;i<lexBuf.lexModeStackTop;i++)

         if (mode == lexBuf.lexModeStack[i]) return 1;

     return 0;

     }

 

-static char lexGetc_()

+static int lexGetc_()

     {

     /* get next char from input, no buffering. */

     if (lexBuf.curPos == lexBuf.inputLen)

         return EOF;

     else if (lexBuf.inputString)

         return *(lexBuf.inputString + lexBuf.curPos++);

     else {

 #ifdef INCLUDEMFC

@@ -920,17 +946,17 @@ static int match_begin_end_name(int end) {
         DBG_(("db: begin/end %d\n", token));

         return token;

         }

     return 0;

     }

 

 static char* lexGetQuotedPrintable()

     {

-    char cur;

+    int cur;

 

     lexClearToken();

     do {

         cur = lexGetc();

         switch (cur) {

             case '=': {

                 int c = 0;

                 int next[2];

@@ -962,23 +988,23 @@ static char* lexGetQuotedPrintable()
                     lexAppendc(c);

                     }

                 break;

                 } /* '=' */

             case '\n': {

                 lexPushLookaheadc('\n');

                 goto EndString;

                 }

-            case (char)EOF:

+            case (int)EOF:

                 break;

             default:

                 lexAppendc(cur);

                 break;

             } /* switch */

-        } while (cur != (char)EOF);

+        } while (cur != (int)EOF);

 

 EndString:

     lexAppendc(0);

     return lexStr();

     } /* LexQuotedPrintable */

 

 static int yylex() {

 

@@ -1145,23 +1171,28 @@ VObject* Parse_MIME_FromFile(FILE *file)
     if (!(result = Parse_MIMEHelper())) {

         fseek(file,startPos,SEEK_SET);

         }

     return result;

     }

 

 DLLEXPORT(VObject*) Parse_MIME_FromFileName(char *fname)

     {

-        QFileDirect f( fname );

-        if ( !f.open( IO_ReadOnly ) ) {

-                qWarning("Unable to open mime for reading %s", fname);

-                return 0;

+    FILE *fp = fopen(fname,"r");

+    if (fp) {

+        VObject* o = Parse_MIME_FromFile(fp);

+        fclose(fp);

+        return o;

+        }

+    else {

+        char msg[80];

+        sprintf(msg, "can't open file '%s' for reading\n", fname);

+        mime_error_(msg);

+        return 0;

         }

-

-    return Parse_MIME_FromFile( f.directHandle() );

     }

 

 #endif

 

 /*-------------------------------------*/

 

 static MimeErrorHandler mimeErrorHandler;

 

@@ -1181,23 +1212,27 @@ void mime_error(char *s)
 

 void mime_error_(char *s)

     {

     if (mimeErrorHandler) {

         mimeErrorHandler(s);

         }

     }

 

-#line 1192 "y.tab.c"
+#line 1221 "y.tab.c"
 #define YYABORT goto yyabort
 #define YYREJECT goto yyabort
 #define YYACCEPT goto yyaccept
 #define YYERROR goto yyerrlab
 int
+#if defined(__STDC__)
+yyparse(void)
+#else
 yyparse()
+#endif
 {
     register int yym, yyn, yystate;
 #if YYDEBUG
     register char *yys;
     extern char *getenv();
 
     if (yys = getenv("YYDEBUG"))
     {
@@ -1211,17 +1246,17 @@ yyparse()
     yyerrflag = 0;
     yychar = (-1);
 
     yyssp = yyss;
     yyvsp = yyvs;
     *yyssp = yystate = 0;
 
 yyloop:
-    if (yyn = yydefred[yystate]) goto yyreduce;
+    if ((yyn = yydefred[yystate]) != 0) goto yyreduce;
     if (yychar < 0)
     {
         if ((yychar = yylex()) < 0) yychar = 0;
 #if YYDEBUG
         if (yydebug)
         {
             yys = 0;
             if (yychar <= YYMAXTOKEN) yys = yyname[yychar];
@@ -1251,20 +1286,16 @@ yyloop:
     }
     if ((yyn = yyrindex[yystate]) && (yyn += yychar) >= 0 &&
             yyn <= YYTABLESIZE && yycheck[yyn] == yychar)
     {
         yyn = yytable[yyn];
         goto yyreduce;
     }
     if (yyerrflag) goto yyinrecovery;
-#ifdef lint
-    goto yynewerror;
-#endif
-yynewerror:
     yyerror("syntax error");
 #ifdef lint
     goto yyerrlab;
 #endif
 yyerrlab:
     ++yynerrs;
 yyinrecovery:
     if (yyerrflag < 3)
@@ -1323,175 +1354,175 @@ yyreduce:
         printf("%sdebug: state %d, reducing by rule %d (%s)\n",
                 YYPREFIX, yystate, yyn, yyrule[yyn]);
 #endif
     yym = yylen[yyn];
     yyval = yyvsp[1-yym];
     switch (yyn)
     {
 case 2:
-#line 217 "vcc.y"
+#line 221 "backend/vcc.y"
 { addList(&vObjList, yyvsp[0].vobj); curObj = 0; }
 break;
 case 3:
-#line 219 "vcc.y"
+#line 223 "backend/vcc.y"
 { addList(&vObjList, yyvsp[0].vobj); curObj = 0; }
 break;
 case 6:
-#line 228 "vcc.y"
+#line 232 "backend/vcc.y"
 {

         lexPushMode(L_VCARD);

         if (!pushVObject(VCCardProp)) YYERROR;

         }
 break;
 case 7:
-#line 233 "vcc.y"
+#line 237 "backend/vcc.y"
 {

         lexPopMode(0);

         yyval.vobj = popVObject();

         }
 break;
 case 8:
-#line 238 "vcc.y"
+#line 242 "backend/vcc.y"
 {

         lexPushMode(L_VCARD);

         if (!pushVObject(VCCardProp)) YYERROR;

         }
 break;
 case 9:
-#line 243 "vcc.y"
+#line 247 "backend/vcc.y"
 {

         lexPopMode(0);

         yyval.vobj = popVObject();

         }
 break;
 case 12:
-#line 254 "vcc.y"
+#line 258 "backend/vcc.y"
 {

         lexPushMode(L_VALUES);

         }
 break;
 case 13:
-#line 258 "vcc.y"
+#line 262 "backend/vcc.y"
 {

         if (lexWithinMode(L_BASE64) || lexWithinMode(L_QUOTED_PRINTABLE))

            lexPopMode(0);

         lexPopMode(0);

         }
 break;
 case 15:
-#line 267 "vcc.y"
+#line 271 "backend/vcc.y"
 {

         enterProps(yyvsp[0].str);

         }
 break;
 case 17:
-#line 272 "vcc.y"
+#line 276 "backend/vcc.y"
 {

         enterProps(yyvsp[0].str);

         }
 break;
 case 21:
-#line 285 "vcc.y"
+#line 289 "backend/vcc.y"
 {

         enterAttr(yyvsp[0].str,0);

         }
 break;
 case 22:
-#line 289 "vcc.y"
+#line 293 "backend/vcc.y"
 {

         enterAttr(yyvsp[-2].str,yyvsp[0].str);

 

         }
 break;
 case 24:
-#line 298 "vcc.y"
+#line 302 "backend/vcc.y"
 { enterValues(yyvsp[-1].str); }
 break;
 case 26:
-#line 300 "vcc.y"
+#line 304 "backend/vcc.y"
 { enterValues(yyvsp[0].str); }
 break;
 case 28:
-#line 305 "vcc.y"
+#line 309 "backend/vcc.y"
 { yyval.str = 0; }
 break;
 case 29:
-#line 310 "vcc.y"
+#line 314 "backend/vcc.y"
 { if (!pushVObject(VCCalProp)) YYERROR; }
 break;
 case 30:
-#line 313 "vcc.y"
+#line 317 "backend/vcc.y"
 { yyval.vobj = popVObject(); }
 break;
 case 31:
-#line 315 "vcc.y"
+#line 319 "backend/vcc.y"
 { if (!pushVObject(VCCalProp)) YYERROR; }
 break;
 case 32:
-#line 317 "vcc.y"
+#line 321 "backend/vcc.y"
 { yyval.vobj = popVObject(); }
 break;
 case 38:
-#line 332 "vcc.y"
+#line 336 "backend/vcc.y"
 {

         lexPushMode(L_VEVENT);

         if (!pushVObject(VCEventProp)) YYERROR;

         }
 break;
 case 39:
-#line 338 "vcc.y"
+#line 342 "backend/vcc.y"
 {

         lexPopMode(0);

         popVObject();

         }
 break;
 case 40:
-#line 343 "vcc.y"
+#line 347 "backend/vcc.y"
 {

         lexPushMode(L_VEVENT);

         if (!pushVObject(VCEventProp)) YYERROR;

         }
 break;
 case 41:
-#line 348 "vcc.y"
+#line 352 "backend/vcc.y"
 {

         lexPopMode(0);

         popVObject();

         }
 break;
 case 42:
-#line 356 "vcc.y"
+#line 360 "backend/vcc.y"
 {

         lexPushMode(L_VTODO);

         if (!pushVObject(VCTodoProp)) YYERROR;

         }
 break;
 case 43:
-#line 362 "vcc.y"
+#line 366 "backend/vcc.y"
 {

         lexPopMode(0);

         popVObject();

         }
 break;
 case 44:
-#line 367 "vcc.y"
+#line 371 "backend/vcc.y"
 {

         lexPushMode(L_VTODO);

         if (!pushVObject(VCTodoProp)) YYERROR;

         }
 break;
 case 45:
-#line 372 "vcc.y"
+#line 376 "backend/vcc.y"
 {

         lexPopMode(0);

         popVObject();

         }
 break;
-#line 1492 "y.tab.c"
+#line 1521 "y.tab.c"
     }
     yyssp -= yym;
     yystate = *yyssp;
     yyvsp -= yym;
     yym = yylhs[yyn];
     if (yystate == 0 && yym == 0)
     {
 #if YYDEBUG
diff --git a/library/backend/vobject.cpp b/library/backend/vobject.cpp
index 9c2ba3b..e6f6b78 100644
--- a/library/backend/vobject.cpp
+++ b/library/backend/vobject.cpp
@@ -1,1219 +1,1315 @@
-/***************************************************************************

-(C) Copyright 1996 Apple Computer, Inc., AT&T Corp., International             

-Business Machines Corporation and Siemens Rolm Communications Inc.             

-                                                                               

-For purposes of this license notice, the term Licensors shall mean,            

-collectively, Apple Computer, Inc., AT&T Corp., International                  

-Business Machines Corporation and Siemens Rolm Communications Inc.             

-The term Licensor shall mean any of the Licensors.                             

-                                                                               

-Subject to acceptance of the following conditions, permission is hereby        

-granted by Licensors without the need for written agreement and without        

-license or royalty fees, to use, copy, modify and distribute this              

-software for any purpose.                                                      

-                                                                               

-The above copyright notice and the following four paragraphs must be           

-reproduced in all copies of this software and any software including           

-this software.                                                                 

-                                                                               

-THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS AND NO LICENSOR SHALL HAVE       

-ANY OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS OR       

-MODIFICATIONS.                                                                 

-                                                                               

-IN NO EVENT SHALL ANY LICENSOR BE LIABLE TO ANY PARTY FOR DIRECT,              

-INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES OR LOST PROFITS ARISING OUT         

-OF THE USE OF THIS SOFTWARE EVEN IF ADVISED OF THE POSSIBILITY OF SUCH         

-DAMAGE.                                                                        

-                                                                               

-EACH LICENSOR SPECIFICALLY DISCLAIMS ANY WARRANTIES, EXPRESS OR IMPLIED,       

-INCLUDING BUT NOT LIMITED TO ANY WARRANTY OF NONINFRINGEMENT OR THE            

-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR             

-PURPOSE.                                                                       

-

-The software is provided with RESTRICTED RIGHTS.  Use, duplication, or         

-disclosure by the government are subject to restrictions set forth in          

-DFARS 252.227-7013 or 48 CFR 52.227-19, as applicable.                         

-

-***************************************************************************/

-

-/*

- * src: vobject.c

- * doc: vobject and APIs to construct vobject, APIs pretty print 

- * vobject, and convert a vobject into its textual representation.

- */

-

-        #ifndef MWERKS

-#include <malloc.h>

-#endif

-

-#include "vobject_p.h"

-#include "qfiledirect_p.h"

-#include <string.h>

-#include <stdio.h>

-#include <fcntl.h>

-//#include <io.h>

-

-

-        #define NAME_OF(o)                      o->id

-        #define VALUE_TYPE(o)           o->valType

-        #define STRINGZ_VALUE_OF(o)     o->val.strs

-        #define INTEGER_VALUE_OF(o)     o->val.i

-        #define LONG_VALUE_OF(o)        o->val.l

-        #define ANY_VALUE_OF(o)                 o->val.any

-        #define VOBJECT_VALUE_OF(o)     o->val.vobj

-

-typedef union ValueItem {

-    const char *strs;

-    unsigned int i;

-    unsigned long l;

-    void *any;

-    VObject *vobj;

-    } ValueItem;

-

-struct VObject {

-    VObject *next;

-    const char *id;

-    VObject *prop;

-    unsigned short valType;

-    ValueItem val;

-    };

-

-typedef struct StrItem StrItem;

-

-struct StrItem {

-    StrItem *next;

-    const char *s;

-    unsigned int refCnt;

-    };

-

-const char** fieldedProp;

-

-

-

-/*----------------------------------------------------------------------

-   The following functions involve with memory allocation:

-        newVObject

-        deleteVObject

-        dupStr

-        deleteStr

-        newStrItem

-        deleteStrItem

-   ----------------------------------------------------------------------*/

-

-DLLEXPORT(VObject*) newVObject_(const char *id)

-{

-    VObject *p = (VObject*)malloc(sizeof(VObject));

-    p->next = 0;

-    p->id = id;

-    p->prop = 0;

-    VALUE_TYPE(p) = 0;

-    ANY_VALUE_OF(p) = 0;

-    return p;

-}

-

-DLLEXPORT(VObject*) newVObject(const char *id)

-{

-    return newVObject_(lookupStr(id));

-}

-

-DLLEXPORT(void) deleteVObject(VObject *p)

-{

-    unUseStr(p->id);

-    free(p);

-}

-

-DLLEXPORT(char*) dupStr(const char *s, unsigned int size)

-{

-    char *t;

-    if  (size == 0) {

-        size = strlen(s);

-        }

-    t = (char*)malloc(size+1);

-    if (t) {

-        memcpy(t,s,size);

-        t[size] = 0;

-        return t;

-        }

-    else {

-        return (char*)0;

-        }

-}

-

-DLLEXPORT(void) deleteStr(const char *p)

-{

-    if (p) free((void*)p);

-}

-

-

-static StrItem* newStrItem(const char *s, StrItem *next)

-{

-    StrItem *p = (StrItem*)malloc(sizeof(StrItem));

-    p->next = next;

-    p->s = s;

-    p->refCnt = 1;

-    return p;

-}

-

-static void deleteStrItem(StrItem *p)

-{

-    free((void*)p);

-}

-

-

-/*----------------------------------------------------------------------

-  The following function provide accesses to VObject's value.

-  ----------------------------------------------------------------------*/

-

-DLLEXPORT(const char*) vObjectName(VObject *o)

-{

-    return NAME_OF(o);

-}

-

-DLLEXPORT(void) setVObjectName(VObject *o, const char* id)

-{

-    NAME_OF(o) = id;

-}

-

-DLLEXPORT(const char*) vObjectStringZValue(VObject *o)

-{

-    return STRINGZ_VALUE_OF(o);

-}

-

-DLLEXPORT(void) setVObjectStringZValue(VObject *o, const char *s)

-{

-    STRINGZ_VALUE_OF(o) = dupStr(s,0);

-    VALUE_TYPE(o) = VCVT_STRINGZ;

-}

-

-DLLEXPORT(void) setVObjectStringZValue_(VObject *o, const char *s)

-{

-    STRINGZ_VALUE_OF(o) = s;

-    VALUE_TYPE(o) = VCVT_STRINGZ;

-}

-

-DLLEXPORT(unsigned int) vObjectIntegerValue(VObject *o)

-{

-    return INTEGER_VALUE_OF(o);

-}

-

-DLLEXPORT(void) setVObjectIntegerValue(VObject *o, unsigned int i)

-{

-    INTEGER_VALUE_OF(o) = i;

-    VALUE_TYPE(o) = VCVT_UINT;

-}

-

-DLLEXPORT(unsigned long) vObjectLongValue(VObject *o)

-{

-    return LONG_VALUE_OF(o);

-}

-

-DLLEXPORT(void) setVObjectLongValue(VObject *o, unsigned long l)

-{

-    LONG_VALUE_OF(o) = l;

-    VALUE_TYPE(o) = VCVT_ULONG;

-}

-

-DLLEXPORT(void*) vObjectAnyValue(VObject *o)

-{

-    return ANY_VALUE_OF(o);

-}

-

-DLLEXPORT(void) setVObjectAnyValue(VObject *o, void *t)

-{

-    ANY_VALUE_OF(o) = t;

-    VALUE_TYPE(o) = VCVT_RAW;

-}

-

-DLLEXPORT(VObject*) vObjectVObjectValue(VObject *o)

-{

-    return VOBJECT_VALUE_OF(o);

-}

-

-DLLEXPORT(void) setVObjectVObjectValue(VObject *o, VObject *p)

-{

-    VOBJECT_VALUE_OF(o) = p;

-    VALUE_TYPE(o) = VCVT_VOBJECT;

-}

-

-DLLEXPORT(int) vObjectValueType(VObject *o)

-{

-    return VALUE_TYPE(o);

-}

-

-

-/*----------------------------------------------------------------------

-  The following functions can be used to build VObject.

-  ----------------------------------------------------------------------*/

-

-DLLEXPORT(VObject*) addVObjectProp(VObject *o, VObject *p)

-{

-    /* circular link list pointed to tail */

-    /*

-    o {next,id,prop,val}

-                V

-        pn {next,id,prop,val}

-             V

-            ...

-        p1 {next,id,prop,val}

-             V

-             pn

-    -->

-    o {next,id,prop,val}

-                V

-        pn {next,id,prop,val}

-             V

-        p {next,id,prop,val}

-            ...

-        p1 {next,id,prop,val}

-             V

-             pn

-    */

-

-    VObject *tail = o->prop;

-    if (tail) {

-        p->next = tail->next;

-        o->prop = tail->next = p;

-        }

-    else {

-        o->prop = p->next = p;

-        }

-    return p;

-}

-

-DLLEXPORT(VObject*) addProp(VObject *o, const char *id)

-{

-    return addVObjectProp(o,newVObject(id));

-}

-

-DLLEXPORT(VObject*) addProp_(VObject *o, const char *id)

-{

-    return addVObjectProp(o,newVObject_(id));

-}

-

-DLLEXPORT(void) addList(VObject **o, VObject *p)

-{

-    p->next = 0;

-    if (*o == 0) {

-        *o = p;

-        }

-    else {

-        VObject *t = *o;

-        while (t->next) {

-           t = t->next;

-           }

-        t->next = p;

-        }

-}

-

-DLLEXPORT(VObject*) nextVObjectInList(VObject *o)

-{

-    return o->next;

-}

-

-DLLEXPORT(VObject*) setValueWithSize_(VObject *prop, void *val, unsigned int size)

-{

-    VObject *sizeProp;

-    setVObjectAnyValue(prop, val);

-    sizeProp = addProp(prop,VCDataSizeProp);

-    setVObjectLongValue(sizeProp, size);

-    return prop;

-}

-

-DLLEXPORT(VObject*) setValueWithSize(VObject *prop, void *val, unsigned int size)

-{

-    void *p = dupStr((const char *)val,size);

-    return setValueWithSize_(prop,p,p?size:0);

-}

-

-DLLEXPORT(void) initPropIterator(VObjectIterator *i, VObject *o)

-{

-    i->start = o->prop; 

-    i->next = 0;

-}

-

-DLLEXPORT(void) initVObjectIterator(VObjectIterator *i, VObject *o)

-{

-    i->start = o->next; 

-    i->next = 0;

-}

-

-DLLEXPORT(int) moreIteration(VObjectIterator *i)

-{ 

-    return (i->start && (i->next==0 || i->next!=i->start));

-}

-

-DLLEXPORT(VObject*) nextVObject(VObjectIterator *i)

-{

-    if (i->start && i->next != i->start) {

-        if (i->next == 0) {

-            i->next = i->start->next;

-            return i->next;

-            }

-        else {

-            i->next = i->next->next;

-            return i->next;

-            }

-        }

-    else return (VObject*)0;

-}

-

-DLLEXPORT(VObject*) isAPropertyOf(VObject *o, const char *id)

-{

-    VObjectIterator i;

-    initPropIterator(&i,o);

-    while (moreIteration(&i)) {

-        VObject *each = nextVObject(&i);

-        if (!qstricmp(id,each->id))

-            return each;

-        }

-    return (VObject*)0;

-}

-

-DLLEXPORT(VObject*) addGroup(VObject *o, const char *g)

-{

-    /*

-        a.b.c

-        -->

-        prop(c)

-            prop(VCGrouping=b)

-                prop(VCGrouping=a)

-     */

-    char *dot = strrchr(g,'.');

-    if (dot) {

-        VObject *p, *t;

-        char *gs, *n = dot+1;

-                gs = dupStr(g,0);/* so we can write to it. */

-        /* used to be

-        * t = p = addProp_(o,lookupProp_(n));

-        */

-        t = p = addProp_(o,lookupProp(n));

-        dot = strrchr(gs,'.');

-        *dot = 0;

-        do {

-            dot = strrchr(gs,'.');

-            if (dot) {

-                n = dot+1;

-                *dot=0;

-                }

-            else

-                n = gs;

-            /* property(VCGroupingProp=n);

-                     *and the value may have VCGrouping property

-             */

-            t = addProp(t,VCGroupingProp);

-            setVObjectStringZValue(t,lookupProp_(n));

-            } while (n != gs);

-                deleteStr(gs);

-        return p;

-        }

-    else

-        return addProp_(o,lookupProp(g));

-}

-

-DLLEXPORT(VObject*) addPropValue(VObject *o, const char *p, const char *v)

-{

-    VObject *prop;

-    prop = addProp(o,p);

-    setVObjectStringZValue_(prop, strdup( v ) );

-    return prop;

-}

-

-DLLEXPORT(VObject*) addPropSizedValue_(VObject *o, const char *p, const char *v,

-        unsigned int size)

-{

-    VObject *prop;

-    prop = addProp(o,p);

-    setValueWithSize_(prop, (void*)v, size);

-    return prop;

-}

-

-DLLEXPORT(VObject*) addPropSizedValue(VObject *o, const char *p, const char *v,

-        unsigned int size)

-{

-    return addPropSizedValue_(o,p,dupStr(v,size),size);

-}

-

-

-DLLEXPORT(void) cleanVObject(VObject *o)

-{

-    if (o == 0) return;

-    if (o->prop) {

-        /* destroy time: cannot use the iterator here.

-           Have to break the cycle in the circular link

-           list and turns it into regular NULL-terminated

-           list -- since at some point of destruction,

-           the reference entry for the iterator to work

-           will not longer be valid.

-           */

-        VObject *p;

-        p = o->prop->next;

-        o->prop->next = 0;

-        do {

-           VObject *t = p->next;

-           cleanVObject(p);

-           p = t;

-           } while (p);

-        }

-    switch (VALUE_TYPE(o)) {

-        case VCVT_STRINGZ:

-        case VCVT_RAW:

-            // assume they are all allocated by malloc.

-            free((char*)STRINGZ_VALUE_OF(o));

-            break;

-        case VCVT_VOBJECT:

-            cleanVObject(VOBJECT_VALUE_OF(o));

-            break;

-        }

-    deleteVObject(o);

-}

-

-DLLEXPORT(void) cleanVObjects(VObject *list)

-{

-    while (list) {

-        VObject *t = list;

-        list = nextVObjectInList(list);

-        cleanVObject(t);

-        }

-}

-

-/*----------------------------------------------------------------------

-  The following is a String Table Facilities.

-  ----------------------------------------------------------------------*/

-

-#define STRTBLSIZE 255

-

-static StrItem *strTbl[STRTBLSIZE];

-

-static unsigned int hashStr(const char *s)

-{

-    unsigned int h = 0;

-    int i;

-    for (i=0;s[i];i++) {

-        h += s[i]*i;

-        }

-    return h % STRTBLSIZE;

-}

-

-DLLEXPORT(const char*) lookupStr(const char *s)

-{

-    StrItem *t;

-    unsigned int h = hashStr(s);

-    if ((t = strTbl[h]) != 0) {

-        do {

-            if (qstricmp(t->s,s) == 0) {

-                t->refCnt++;

-                return t->s;

-                }

-            t = t->next;

-            } while (t);

-        }

-    s = dupStr(s,0);

-    strTbl[h] = newStrItem(s,strTbl[h]);

-    return s;

-}

-

-DLLEXPORT(void) unUseStr(const char *s)

-{

-    StrItem *t, *p;

-    unsigned int h = hashStr(s);

-    if ((t = strTbl[h]) != 0) {

-        p = t;

-        do {

-            if (qstricmp(t->s,s) == 0) {

-                t->refCnt--;

-                if (t->refCnt == 0) {

-                    if (p == strTbl[h]) {

-                        strTbl[h] = t->next;

-                        }

-                    else {

-                        p->next = t->next;

-                        }

-                    deleteStr(t->s);

-                    deleteStrItem(t);

-                    return;

-                    }

-                }

-            p = t;

-            t = t->next;

-            } while (t);

-        }

-}

-

-DLLEXPORT(void) cleanStrTbl()

-{

-    int i;

-    for (i=0; i<STRTBLSIZE;i++) {

-        StrItem *t = strTbl[i];

-        while (t) {

-            StrItem *p;

-            deleteStr(t->s);

-            p = t;

-            t = t->next;

-            deleteStrItem(p);

-            } while (t);

-        strTbl[i] = 0;

-        }

-}

-

-

-struct PreDefProp {

-    const char *name;

-    const char *alias;

-    const char** fields;

-    unsigned int flags;

-    };

-

-/* flags in PreDefProp */

-        #define PD_BEGIN0x1

-        #define PD_INTERNAL0x2

-

-static const char *adrFields[] = {

-    VCPostalBoxProp,

-    VCExtAddressProp,

-    VCStreetAddressProp,

-    VCCityProp,

-    VCRegionProp,

-    VCPostalCodeProp,

-    VCCountryNameProp,

-    0

-};

-

-static const char *nameFields[] = {

-    VCFamilyNameProp,

-    VCGivenNameProp,

-    VCAdditionalNamesProp,

-    VCNamePrefixesProp,

-    VCNameSuffixesProp,

-    NULL

-    };

-

-static const char *orgFields[] = {

-    VCOrgNameProp,

-    VCOrgUnitProp,

-    VCOrgUnit2Prop,

-    VCOrgUnit3Prop,

-    VCOrgUnit4Prop,

-    NULL

-    };

-

-static const char *AAlarmFields[] = {

-    VCRunTimeProp,

-    VCSnoozeTimeProp,

-    VCRepeatCountProp,

-    VCAudioContentProp,

-    0

-    };

-

-/* ExDate -- has unamed fields */

-/* RDate -- has unamed fields */

-

-static const char *DAlarmFields[] = {

-    VCRunTimeProp,

-    VCSnoozeTimeProp,

-    VCRepeatCountProp,

-    VCDisplayStringProp,

-    0

-    };

-

-static const char *MAlarmFields[] = {

-    VCRunTimeProp,

-    VCSnoozeTimeProp,

-    VCRepeatCountProp,

-    VCEmailAddressProp,

-    VCNoteProp,

-    0

-    };

-

-static const char *PAlarmFields[] = {

-    VCRunTimeProp,

-    VCSnoozeTimeProp,

-    VCRepeatCountProp,

-    VCProcedureNameProp,

-    0

-    };

-

-static struct PreDefProp propNames[] = {

-    { VC7bitProp, 0, 0, 0 },

-    { VC8bitProp, 0, 0, 0 },

-    { VCAAlarmProp, 0, AAlarmFields, 0 },

-    { VCAdditionalNamesProp, 0, 0, 0 },

-    { VCAdrProp, 0, adrFields, 0 },

-    { VCAgentProp, 0, 0, 0 },

-    { VCAIFFProp, 0, 0, 0 },

-    { VCAOLProp, 0, 0, 0 },

-    { VCAppleLinkProp, 0, 0, 0 },

-    { VCAttachProp, 0, 0, 0 },

-    { VCAttendeeProp, 0, 0, 0 },

-    { VCATTMailProp, 0, 0, 0 },

-    { VCAudioContentProp, 0, 0, 0 },

-    { VCAVIProp, 0, 0, 0 },

-    { VCBase64Prop, 0, 0, 0 },

-    { VCBBSProp, 0, 0, 0 },

-    { VCBirthDateProp, 0, 0, 0 },

-    { VCBMPProp, 0, 0, 0 },

-    { VCBodyProp, 0, 0, 0 },

-    { VCBusinessRoleProp, 0, 0, 0 },

-    { VCCalProp, 0, 0, PD_BEGIN },

-    { VCCaptionProp, 0, 0, 0 },

-    { VCCardProp, 0, 0, PD_BEGIN },

-    { VCCarProp, 0, 0, 0 },

-    { VCCategoriesProp, 0, 0, 0 },

-    { VCCellularProp, 0, 0, 0 },

-    { VCCGMProp, 0, 0, 0 },

-    { VCCharSetProp, 0, 0, 0 },

-    { VCCIDProp, VCContentIDProp, 0, 0 },

-    { VCCISProp, 0, 0, 0 },

-    { VCCityProp, 0, 0, 0 },

-    { VCClassProp, 0, 0, 0 },

-    { VCCommentProp, 0, 0, 0 },

-    { VCCompletedProp, 0, 0, 0 },

-    { VCContentIDProp, 0, 0, 0 },

-    { VCCountryNameProp, 0, 0, 0 },

-    { VCDAlarmProp, 0, DAlarmFields, 0 },

-    { VCDataSizeProp, 0, 0, PD_INTERNAL },

-    { VCDayLightProp, 0, 0, 0 },

-    { VCDCreatedProp, 0, 0, 0 },

-    { VCDeliveryLabelProp, 0, 0, 0 },

-    { VCDescriptionProp, 0, 0, 0 },

-    { VCDIBProp, 0, 0, 0 },

-    { VCDisplayStringProp, 0, 0, 0 },

-    { VCDomesticProp, 0, 0, 0 },

-    { VCDTendProp, 0, 0, 0 },

-    { VCDTstartProp, 0, 0, 0 },

-    { VCDueProp, 0, 0, 0 },

-    { VCEmailAddressProp, 0, 0, 0 },

-    { VCEncodingProp, 0, 0, 0 },

-    { VCEndProp, 0, 0, 0 },

-    { VCEventProp, 0, 0, PD_BEGIN },

-    { VCEWorldProp, 0, 0, 0 },

-    { VCExNumProp, 0, 0, 0 },

-    { VCExpDateProp, 0, 0, 0 },

-    { VCExpectProp, 0, 0, 0 },

-    { VCExtAddressProp, 0, 0, 0 },

-    { VCFamilyNameProp, 0, 0, 0 },

-    { VCFaxProp, 0, 0, 0 },

-    { VCFullNameProp, 0, 0, 0 },

-    { VCGeoLocationProp, 0, 0, 0 },

-    { VCGeoProp, 0, 0, 0 },

-    { VCGIFProp, 0, 0, 0 },

-    { VCGivenNameProp, 0, 0, 0 },

-    { VCGroupingProp, 0, 0, 0 },

-    { VCHomeProp, 0, 0, 0 },

-    { VCIBMMailProp, 0, 0, 0 },

-    { VCInlineProp, 0, 0, 0 },

-    { VCInternationalProp, 0, 0, 0 },

-    { VCInternetProp, 0, 0, 0 },

-    { VCISDNProp, 0, 0, 0 },

-    { VCJPEGProp, 0, 0, 0 },

-    { VCLanguageProp, 0, 0, 0 },

-    { VCLastModifiedProp, 0, 0, 0 },

-    { VCLastRevisedProp, 0, 0, 0 },

-    { VCLocationProp, 0, 0, 0 },

-    { VCLogoProp, 0, 0, 0 },

-    { VCMailerProp, 0, 0, 0 },

-    { VCMAlarmProp, 0, MAlarmFields, 0 },

-    { VCMCIMailProp, 0, 0, 0 },

-    { VCMessageProp, 0, 0, 0 },

-    { VCMETProp, 0, 0, 0 },

-    { VCModemProp, 0, 0, 0 },

-    { VCMPEG2Prop, 0, 0, 0 },

-    { VCMPEGProp, 0, 0, 0 },

-    { VCMSNProp, 0, 0, 0 },

-    { VCNamePrefixesProp, 0, 0, 0 },

-    { VCNameProp, 0, nameFields, 0 },

-    { VCNameSuffixesProp, 0, 0, 0 },

-    { VCNoteProp, 0, 0, 0 },

-    { VCOrgNameProp, 0, 0, 0 },

-    { VCOrgProp, 0, orgFields, 0 },

-    { VCOrgUnit2Prop, 0, 0, 0 },

-    { VCOrgUnit3Prop, 0, 0, 0 },

-    { VCOrgUnit4Prop, 0, 0, 0 },

-    { VCOrgUnitProp, 0, 0, 0 },

-    { VCPagerProp, 0, 0, 0 },

-    { VCPAlarmProp, 0, PAlarmFields, 0 },

-    { VCParcelProp, 0, 0, 0 },

-    { VCPartProp, 0, 0, 0 },

-    { VCPCMProp, 0, 0, 0 },

-    { VCPDFProp, 0, 0, 0 },

-    { VCPGPProp, 0, 0, 0 },

-    { VCPhotoProp, 0, 0, 0 },

-    { VCPICTProp, 0, 0, 0 },

-    { VCPMBProp, 0, 0, 0 },

-    { VCPostalBoxProp, 0, 0, 0 },

-    { VCPostalCodeProp, 0, 0, 0 },

-    { VCPostalProp, 0, 0, 0 },

-    { VCPowerShareProp, 0, 0, 0 },

-    { VCPreferredProp, 0, 0, 0 },

-    { VCPriorityProp, 0, 0, 0 },

-    { VCProcedureNameProp, 0, 0, 0 },

-    { VCProdIdProp, 0, 0, 0 },

-    { VCProdigyProp, 0, 0, 0 },

-    { VCPronunciationProp, 0, 0, 0 },

-    { VCPSProp, 0, 0, 0 },

-    { VCPublicKeyProp, 0, 0, 0 },

-    { VCQPProp, VCQuotedPrintableProp, 0, 0 },

-    { VCQuickTimeProp, 0, 0, 0 },

-    { VCQuotedPrintableProp, 0, 0, 0 },

-    { VCRDateProp, 0, 0, 0 },

-    { VCRegionProp, 0, 0, 0 },

-    { VCRelatedToProp, 0, 0, 0 },

-    { VCRepeatCountProp, 0, 0, 0 },

-    { VCResourcesProp, 0, 0, 0 },

-    { VCRNumProp, 0, 0, 0 },

-    { VCRoleProp, 0, 0, 0 },

-    { VCRRuleProp, 0, 0, 0 },

-    { VCRSVPProp, 0, 0, 0 },

-    { VCRunTimeProp, 0, 0, 0 },

-    { VCSequenceProp, 0, 0, 0 },

-    { VCSnoozeTimeProp, 0, 0, 0 },

-    { VCStartProp, 0, 0, 0 },

-    { VCStatusProp, 0, 0, 0 },

-    { VCStreetAddressProp, 0, 0, 0 },

-    { VCSubTypeProp, 0, 0, 0 },

-    { VCSummaryProp, 0, 0, 0 },

-    { VCTelephoneProp, 0, 0, 0 },

-    { VCTIFFProp, 0, 0, 0 },

-    { VCTimeZoneProp, 0, 0, 0 },

-    { VCTitleProp, 0, 0, 0 },

-    { VCTLXProp, 0, 0, 0 },

-    { VCTodoProp, 0, 0, PD_BEGIN },

-    { VCTranspProp, 0, 0, 0 },

-    { VCUniqueStringProp, 0, 0, 0 },

-    { VCURLProp, 0, 0, 0 },

-    { VCURLValueProp, 0, 0, 0 },

-    { VCValueProp, 0, 0, 0 },

-    { VCVersionProp, 0, 0, 0 },

-    { VCVideoProp, 0, 0, 0 },

-    { VCVoiceProp, 0, 0, 0 },

-    { VCWAVEProp, 0, 0, 0 },

-    { VCWMFProp, 0, 0, 0 },

-    { VCWorkProp, 0, 0, 0 },

-    { VCX400Prop, 0, 0, 0 },

-    { VCX509Prop, 0, 0, 0 },

-    { VCXRuleProp, 0, 0, 0 },

-    { 0,0,0,0 }

-    };

-

-

-static struct PreDefProp* lookupPropInfo(const char* str)

-{

-    /* brute force for now, could use a hash table here. */

-    int i;

-        

-    for (i = 0; propNames[i].name; i++)

-        if (qstricmp(str, propNames[i].name) == 0) {

-            return &propNames[i];

-            }

-    

-    return 0;

-}

-

-

-DLLEXPORT(const char*) lookupProp_(const char* str)

-{

-    int i;

-        

-    for (i = 0; propNames[i].name; i++)

-        if (qstricmp(str, propNames[i].name) == 0) {

-            const char* s;

-            s = propNames[i].alias?propNames[i].alias:propNames[i].name;

-            return lookupStr(s);

-            }

-    return lookupStr(str);

-}

-

-

-DLLEXPORT(const char*) lookupProp(const char* str)

-{

-    int i;

-        

-    for (i = 0; propNames[i].name; i++)

-        if (qstricmp(str, propNames[i].name) == 0) {

-            const char *s;

-            fieldedProp = propNames[i].fields;

-            s = propNames[i].alias?propNames[i].alias:propNames[i].name;

-            return lookupStr(s);

-            }

-    fieldedProp = 0;

-    return lookupStr(str);

-}

-

-

-/*----------------------------------------------------------------------

-  APIs to Output text form.

-  ----------------------------------------------------------------------*/

-#define OFILE_REALLOC_SIZE 256

-typedef struct OFile {

-    FILE *fp;

-    char *s;

-    int len;

-    int limit;

-    int alloc:1;

-    int fail:1;

-    } OFile;

-

-#if 0

-static void appendsOFile(OFile *fp, const char *s)

-{

-    int slen;

-    if (fp->fail) return;

-    slen  = strlen(s);

-    if (fp->fp) {

-        fwrite(s,1,slen,fp->fp);

-        }

-    else {

-stuff:

-        if (fp->len + slen < fp->limit) {

-            memcpy(fp->s+fp->len,s,slen);

-            fp->len += slen;

-            return;

-            }

-        else if (fp->alloc) {

-            fp->limit = fp->limit + OFILE_REALLOC_SIZE;

-            if (OFILE_REALLOC_SIZE <= slen) fp->limit += slen;

-            fp->s = (char *) realloc(fp->s,fp->limit);

-            if (fp->s) goto stuff;

-            }

-        if (fp->alloc)

-            free(fp->s);

-        fp->s = 0;

-        fp->fail = 1;

-        }

-}

-

-static void appendcOFile(OFile *fp, char c)

-{

-    if (fp->fail) return;

-    if (fp->fp) {

-        fputc(c,fp->fp);

-        }

-    else {

-stuff:

-        if (fp->len+1 < fp->limit) {

-            fp->s[fp->len] = c;

-            fp->len++;

-            return;

-            }

-        else if (fp->alloc) {

-            fp->limit = fp->limit + OFILE_REALLOC_SIZE;

-            fp->s = (char *) realloc(fp->s,fp->limit);

-            if (fp->s) goto stuff;

-            }

-        if (fp->alloc)

-            free(fp->s);

-        fp->s = 0;

-        fp->fail = 1;

-        }

-}

-#else

-static void appendcOFile_(OFile *fp, char c)

-{

-    if (fp->fail) return;

-    if (fp->fp) {

-        fputc(c,fp->fp);

-        }

-    else {

-stuff:

-        if (fp->len+1 < fp->limit) {

-            fp->s[fp->len] = c;

-            fp->len++;

-            return;

-            }

-        else if (fp->alloc) {

-            fp->limit = fp->limit + OFILE_REALLOC_SIZE;

-            fp->s = (char *)realloc(fp->s,fp->limit);

-            if (fp->s) goto stuff;

-            }

-        if (fp->alloc)

-            free(fp->s);

-        fp->s = 0;

-        fp->fail = 1;

-        }

-}

-

-static void appendcOFile(OFile *fp, char c)

-{

-    if (c == '\n') {

-        /* write out as <CR><LF> */

-        appendcOFile_(fp,0xd);

-        appendcOFile_(fp,0xa);

-        }

-    else

-        appendcOFile_(fp,c);

-}

-

-static void appendsOFile(OFile *fp, const char *s)

-{

-    int i, slen;

-    slen  = strlen(s);

-    for (i=0; i<slen; i++) {

-        appendcOFile(fp,s[i]);

-        }

-}

-

-#endif

-

-static void initOFile(OFile *fp, FILE *ofp)

-{

-    fp->fp = ofp;

-    fp->s = 0;

-    fp->len = 0;

-    fp->limit = 0;

-    fp->alloc = 0;

-    fp->fail = 0;

-}

-

-static int writeBase64(OFile *fp, unsigned char *s, long len)

-{

-    long cur = 0;

-    int i, numQuads = 0;

-    unsigned long trip;

-    unsigned char b;

-    char quad[5];

-#define MAXQUADS 16

-

-    quad[4] = 0;

-

-    while (cur < len) {

-        // collect the triplet of bytes into 'trip'

-        trip = 0;

-        for (i = 0; i < 3; i++) {

-            b = (cur < len) ? *(s + cur) : 0;

-            cur++;

-            trip = trip << 8 | b;

-            }

-        // fill in 'quad' with the appropriate four characters

-        for (i = 3; i >= 0; i--) {

-            b = (unsigned char)(trip & 0x3F);

-            trip = trip >> 6;

-            if ((3 - i) < (cur - len))

-                quad[i] = '='; // pad char

-            else if (b < 26) quad[i] = (char)b + 'A';

-            else if (b < 52) quad[i] = (char)(b - 26) + 'a';

-            else if (b < 62) quad[i] = (char)(b - 52) + '0';

-            else if (b == 62) quad[i] = '+';

-            else quad[i] = '/';

-            }

-        // now output 'quad' with appropriate whitespace and line ending

-        appendsOFile(fp, (numQuads == 0 ? "    " : ""));

-        appendsOFile(fp, quad);

-        appendsOFile(fp, ((cur >= len)?"\n" :(numQuads==MAXQUADS-1?"\n" : "")));

-        numQuads = (numQuads + 1) % MAXQUADS;

-        }

-    appendcOFile(fp,'\n');

-

-    return 1;

-}

-

-static void writeQPString(OFile *fp, const char *s)

-{

-    const char *p = s;

-    while (*p) {

-        if (*p == '\n') {

-            if (p[1]) appendsOFile(fp,"=0A=");

-            }

-        appendcOFile(fp,*p);

-        p++;

-        }

-}

-

-

-

-static void writeVObject_(OFile *fp, VObject *o);

-

-static void writeValue(OFile *fp, VObject *o, unsigned long size)

-{

-    if (o == 0) return;

-    switch (VALUE_TYPE(o)) {

-        case VCVT_STRINGZ: {

-            writeQPString(fp, STRINGZ_VALUE_OF(o));

-            break;

-            }

-        case VCVT_UINT: {

-            char buf[16];

-            sprintf(buf,"%u", INTEGER_VALUE_OF(o));

-            appendsOFile(fp,buf);

-            break;

-            }

-        case VCVT_ULONG: {

-            char buf[16];

-            sprintf(buf,"%lu", LONG_VALUE_OF(o));

-            appendsOFile(fp,buf);

-            break;

-            }

-        case VCVT_RAW: {

-            appendcOFile(fp,'\n');

-            writeBase64(fp,(unsigned char*)(ANY_VALUE_OF(o)),size);

-            break;

-            }

-        case VCVT_VOBJECT:

-            appendcOFile(fp,'\n');

-            writeVObject_(fp,VOBJECT_VALUE_OF(o));

-            break;

-        }

-}

-

-static void writeAttrValue(OFile *fp, VObject *o)

-{

-    if (NAME_OF(o)) {

-        struct PreDefProp *pi;

-        pi = lookupPropInfo(NAME_OF(o));

-        if (pi && ((pi->flags & PD_INTERNAL) != 0)) return;

-        appendcOFile(fp,';');

-        appendsOFile(fp,NAME_OF(o));

-        }

-    else

-        appendcOFile(fp,';');

-    if (VALUE_TYPE(o)) {

-        appendcOFile(fp,'=');

-        writeValue(fp,o,0);

-        }

-}

-

-static void writeGroup(OFile *fp, VObject *o)

-{

-    char buf1[256];

-    char buf2[256];

-    strcpy(buf1,NAME_OF(o));

-    while ((o=isAPropertyOf(o,VCGroupingProp)) != 0) {

-        strcpy(buf2,STRINGZ_VALUE_OF(o));

-        strcat(buf2,".");

-        strcat(buf2,buf1);

-        strcpy(buf1,buf2);

-        }

-    appendsOFile(fp,buf1);

-}

-

-static int inList(const char **list, const char *s)

-{

-    if (list == 0) return 0;

-    while (*list) {

-        if (qstricmp(*list,s) == 0) return 1;

-        list++;

-        }

-    return 0;

-}

-

-static void writeProp(OFile *fp, VObject *o)

-{

-    if (NAME_OF(o)) {

-        struct PreDefProp *pi;

-        VObjectIterator t;

-        const char **fields_ = 0;

-        pi = lookupPropInfo(NAME_OF(o));

-        if (pi && ((pi->flags & PD_BEGIN) != 0)) {

-            writeVObject_(fp,o);

-            return;

-            }

-        if (isAPropertyOf(o,VCGroupingProp))

-            writeGroup(fp,o);

-        else

-            appendsOFile(fp,NAME_OF(o));

-        if (pi) fields_ = pi->fields;

-        initPropIterator(&t,o);

-        while (moreIteration(&t)) {

-            const char *s;

-            VObject *eachProp = nextVObject(&t);

-            s = NAME_OF(eachProp);

-            if (qstricmp(VCGroupingProp,s) && !inList(fields_,s))

-                writeAttrValue(fp,eachProp);

-            }

-        if (fields_) {

-            int i = 0, n = 0;

-            const char** fields = fields_;

-            /* output prop as fields */

-            appendcOFile(fp,':');

-            while (*fields) {

-                VObject *t = isAPropertyOf(o,*fields);

-                i++;

-                if (t) n = i;

-                fields++;

-                }

-            fields = fields_;

-            for (i=0;i<n;i++) {

-                writeValue(fp,isAPropertyOf(o,*fields),0);

-                fields++;

-                if (i<(n-1)) appendcOFile(fp,';');

-                }

-            }

-        }

-        

-    if (VALUE_TYPE(o)) {

-        unsigned long size = 0;

-        VObject *p = isAPropertyOf(o,VCDataSizeProp);

-        if (p) size = LONG_VALUE_OF(p);

-        appendcOFile(fp,':');

-        writeValue(fp,o,size);

-        }

-

-    appendcOFile(fp,'\n');

-}

-

-static void writeVObject_(OFile *fp, VObject *o)

-{

-    if (NAME_OF(o)) {

-        struct PreDefProp *pi;

-        pi = lookupPropInfo(NAME_OF(o));

-

-        if (pi && ((pi->flags & PD_BEGIN) != 0)) {

-            VObjectIterator t;

-            const char *begin = NAME_OF(o);

-            appendsOFile(fp,"BEGIN:");

-            appendsOFile(fp,begin);

-            appendcOFile(fp,'\n');

-            initPropIterator(&t,o);

-            while (moreIteration(&t)) {

-                VObject *eachProp = nextVObject(&t);

-                writeProp(fp, eachProp);

-                }

-            appendsOFile(fp,"END:");

-            appendsOFile(fp,begin);

-            appendsOFile(fp,"\n\n");

-            }

-        }

-}

-

-void writeVObject(FILE *fp, VObject *o)

-{

-    OFile ofp;

-    // #####

-    //_setmode(_fileno(fp), _O_BINARY);

-    initOFile(&ofp,fp);

-    writeVObject_(&ofp,o);

-}

-

-DLLEXPORT(void) writeVObjectToFile(char *fname, VObject *o)

-{

-        QFileDirect f( fname);

-        if ( !f.open( IO_WriteOnly ) ) {

-                qWarning("Unable to open vobject write %s", fname);

-                return;

-        }

-

-    writeVObject( f.directHandle(),o );

-}

-

-DLLEXPORT(void) writeVObjectsToFile(char *fname, VObject *list)

-{

-        QFileDirect f( fname);

-        if ( !f.open( IO_WriteOnly ) ) {

-                qWarning("Unable to open vobject write %s", fname);

-                return;

-        }

-

-        while (list) {

-            writeVObject(f.directHandle(),list);

-            list = nextVObjectInList(list);

-            }

-}

-

-DLLEXPORT(const char *) vObjectTypeInfo(VObject *o)

-{

-    const char *type = vObjectName( o );

-    if ( strcmp( type, "TYPE" ) == 0 )

-        type = vObjectStringZValue( o );

-    return type;

-}

-

-

-// end of source file vobject.c

+/***************************************************************************
+(C) Copyright 1996 Apple Computer, Inc., AT&T Corp., International             
+Business Machines Corporation and Siemens Rolm Communications Inc.             
+                                                                               
+For purposes of this license notice, the term Licensors shall mean,            
+collectively, Apple Computer, Inc., AT&T Corp., International                  
+Business Machines Corporation and Siemens Rolm Communications Inc.             
+The term Licensor shall mean any of the Licensors.                             
+                                                                               
+Subject to acceptance of the following conditions, permission is hereby        
+granted by Licensors without the need for written agreement and without        
+license or royalty fees, to use, copy, modify and distribute this              
+software for any purpose.                                                      
+                                                                               
+The above copyright notice and the following four paragraphs must be           
+reproduced in all copies of this software and any software including           
+this software.                                                                 
+                                                                               
+THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS AND NO LICENSOR SHALL HAVE       
+ANY OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS OR       
+MODIFICATIONS.                                                                 
+                                                                               
+IN NO EVENT SHALL ANY LICENSOR BE LIABLE TO ANY PARTY FOR DIRECT,              
+INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES OR LOST PROFITS ARISING OUT         
+OF THE USE OF THIS SOFTWARE EVEN IF ADVISED OF THE POSSIBILITY OF SUCH         
+DAMAGE.                                                                        
+                                                                               
+EACH LICENSOR SPECIFICALLY DISCLAIMS ANY WARRANTIES, EXPRESS OR IMPLIED,       
+INCLUDING BUT NOT LIMITED TO ANY WARRANTY OF NONINFRINGEMENT OR THE            
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR             
+PURPOSE.                                                                       
+
+The software is provided with RESTRICTED RIGHTS.  Use, duplication, or         
+disclosure by the government are subject to restrictions set forth in          
+DFARS 252.227-7013 or 48 CFR 52.227-19, as applicable.                         
+
+***************************************************************************/
+
+/*
+ * src: vobject.c
+ * doc: vobject and APIs to construct vobject, APIs pretty print 
+ * vobject, and convert a vobject into its textual representation.
+ */
+
+        #ifndef MWERKS
+#include <malloc.h>
+#endif
+
+#include "vobject_p.h"
+#include "qfiledirect_p.h"
+#include <string.h>
+#include <stdio.h>
+#include <fcntl.h>
+//#include <io.h>
+
+
+        #define NAME_OF(o)                      o->id
+        #define VALUE_TYPE(o)           o->valType
+        #define STRINGZ_VALUE_OF(o)     o->val.strs
+        #define INTEGER_VALUE_OF(o)     o->val.i
+        #define LONG_VALUE_OF(o)        o->val.l
+        #define ANY_VALUE_OF(o)                 o->val.any
+        #define VOBJECT_VALUE_OF(o)     o->val.vobj
+
+typedef union ValueItem {
+    const char *strs;
+    unsigned int i;
+    unsigned long l;
+    void *any;
+    VObject *vobj;
+    } ValueItem;
+
+struct VObject {
+    VObject *next;
+    const char *id;
+    VObject *prop;
+    unsigned short valType;
+    ValueItem val;
+    };
+
+typedef struct StrItem StrItem;
+
+struct StrItem {
+    StrItem *next;
+    const char *s;
+    unsigned int refCnt;
+    };
+
+const char** fieldedProp;
+
+
+
+/*----------------------------------------------------------------------
+   The following functions involve with memory allocation:
+        newVObject
+        deleteVObject
+        dupStr
+        deleteStr
+        newStrItem
+        deleteStrItem
+   ----------------------------------------------------------------------*/
+
+DLLEXPORT(VObject*) newVObject_(const char *id)
+{
+    VObject *p = (VObject*)malloc(sizeof(VObject));
+    p->next = 0;
+    p->id = id;
+    p->prop = 0;
+    VALUE_TYPE(p) = 0;
+    ANY_VALUE_OF(p) = 0;
+    return p;
+}
+
+DLLEXPORT(VObject*) newVObject(const char *id)
+{
+    return newVObject_(lookupStr(id));
+}
+
+DLLEXPORT(void) deleteVObject(VObject *p)
+{
+    unUseStr(p->id);
+    free(p);
+}
+
+DLLEXPORT(char*) dupStr(const char *s, unsigned int size)
+{
+    char *t;
+    if  (size == 0) {
+        size = strlen(s);
+        }
+    t = (char*)malloc(size+1);
+    if (t) {
+        memcpy(t,s,size);
+        t[size] = 0;
+        return t;
+        }
+    else {
+        return (char*)0;
+        }
+}
+
+DLLEXPORT(void) deleteStr(const char *p)
+{
+    if (p) free((void*)p);
+}
+
+
+static StrItem* newStrItem(const char *s, StrItem *next)
+{
+    StrItem *p = (StrItem*)malloc(sizeof(StrItem));
+    p->next = next;
+    p->s = s;
+    p->refCnt = 1;
+    return p;
+}
+
+static void deleteStrItem(StrItem *p)
+{
+    free((void*)p);
+}
+
+
+/*----------------------------------------------------------------------
+  The following function provide accesses to VObject's value.
+  ----------------------------------------------------------------------*/
+
+DLLEXPORT(const char*) vObjectName(VObject *o)
+{
+    return NAME_OF(o);
+}
+
+DLLEXPORT(void) setVObjectName(VObject *o, const char* id)
+{
+    NAME_OF(o) = id;
+}
+
+DLLEXPORT(const char*) vObjectStringZValue(VObject *o)
+{
+    return STRINGZ_VALUE_OF(o);
+}
+
+DLLEXPORT(void) setVObjectStringZValue(VObject *o, const char *s)
+{
+    STRINGZ_VALUE_OF(o) = dupStr(s,0);
+    VALUE_TYPE(o) = VCVT_STRINGZ;
+}
+
+DLLEXPORT(void) setVObjectStringZValue_(VObject *o, const char *s)
+{
+    STRINGZ_VALUE_OF(o) = s;
+    VALUE_TYPE(o) = VCVT_STRINGZ;
+}
+
+DLLEXPORT(unsigned int) vObjectIntegerValue(VObject *o)
+{
+    return INTEGER_VALUE_OF(o);
+}
+
+DLLEXPORT(void) setVObjectIntegerValue(VObject *o, unsigned int i)
+{
+    INTEGER_VALUE_OF(o) = i;
+    VALUE_TYPE(o) = VCVT_UINT;
+}
+
+DLLEXPORT(unsigned long) vObjectLongValue(VObject *o)
+{
+    return LONG_VALUE_OF(o);
+}
+
+DLLEXPORT(void) setVObjectLongValue(VObject *o, unsigned long l)
+{
+    LONG_VALUE_OF(o) = l;
+    VALUE_TYPE(o) = VCVT_ULONG;
+}
+
+DLLEXPORT(void*) vObjectAnyValue(VObject *o)
+{
+    return ANY_VALUE_OF(o);
+}
+
+DLLEXPORT(void) setVObjectAnyValue(VObject *o, void *t)
+{
+    ANY_VALUE_OF(o) = t;
+    VALUE_TYPE(o) = VCVT_RAW;
+}
+
+DLLEXPORT(VObject*) vObjectVObjectValue(VObject *o)
+{
+    return VOBJECT_VALUE_OF(o);
+}
+
+DLLEXPORT(void) setVObjectVObjectValue(VObject *o, VObject *p)
+{
+    VOBJECT_VALUE_OF(o) = p;
+    VALUE_TYPE(o) = VCVT_VOBJECT;
+}
+
+DLLEXPORT(int) vObjectValueType(VObject *o)
+{
+    return VALUE_TYPE(o);
+}
+
+
+/*----------------------------------------------------------------------
+  The following functions can be used to build VObject.
+  ----------------------------------------------------------------------*/
+
+DLLEXPORT(VObject*) addVObjectProp(VObject *o, VObject *p)
+{
+    /* circular link list pointed to tail */
+    /*
+    o {next,id,prop,val}
+                V
+        pn {next,id,prop,val}
+             V
+            ...
+        p1 {next,id,prop,val}
+             V
+             pn
+    -->
+    o {next,id,prop,val}
+                V
+        pn {next,id,prop,val}
+             V
+        p {next,id,prop,val}
+            ...
+        p1 {next,id,prop,val}
+             V
+             pn
+    */
+
+    VObject *tail = o->prop;
+    if (tail) {
+        p->next = tail->next;
+        o->prop = tail->next = p;
+        }
+    else {
+        o->prop = p->next = p;
+        }
+    return p;
+}
+
+DLLEXPORT(VObject*) addProp(VObject *o, const char *id)
+{
+    return addVObjectProp(o,newVObject(id));
+}
+
+DLLEXPORT(VObject*) addProp_(VObject *o, const char *id)
+{
+    return addVObjectProp(o,newVObject_(id));
+}
+
+DLLEXPORT(void) addList(VObject **o, VObject *p)
+{
+    p->next = 0;
+    if (*o == 0) {
+        *o = p;
+        }
+    else {
+        VObject *t = *o;
+        while (t->next) {
+           t = t->next;
+           }
+        t->next = p;
+        }
+}
+
+DLLEXPORT(VObject*) nextVObjectInList(VObject *o)
+{
+    return o->next;
+}
+
+DLLEXPORT(VObject*) setValueWithSize_(VObject *prop, void *val, unsigned int size)
+{
+    VObject *sizeProp;
+    setVObjectAnyValue(prop, val);
+    sizeProp = addProp(prop,VCDataSizeProp);
+    setVObjectLongValue(sizeProp, size);
+    return prop;
+}
+
+DLLEXPORT(VObject*) setValueWithSize(VObject *prop, void *val, unsigned int size)
+{
+    void *p = dupStr((const char *)val,size);
+    return setValueWithSize_(prop,p,p?size:0);
+}
+
+DLLEXPORT(void) initPropIterator(VObjectIterator *i, VObject *o)
+{
+    i->start = o->prop; 
+    i->next = 0;
+}
+
+DLLEXPORT(void) initVObjectIterator(VObjectIterator *i, VObject *o)
+{
+    i->start = o->next; 
+    i->next = 0;
+}
+
+DLLEXPORT(int) moreIteration(VObjectIterator *i)
+{ 
+    return (i->start && (i->next==0 || i->next!=i->start));
+}
+
+DLLEXPORT(VObject*) nextVObject(VObjectIterator *i)
+{
+    if (i->start && i->next != i->start) {
+        if (i->next == 0) {
+            i->next = i->start->next;
+            return i->next;
+            }
+        else {
+            i->next = i->next->next;
+            return i->next;
+            }
+        }
+    else return (VObject*)0;
+}
+
+DLLEXPORT(VObject*) isAPropertyOf(VObject *o, const char *id)
+{
+    VObjectIterator i;
+    initPropIterator(&i,o);
+    while (moreIteration(&i)) {
+        VObject *each = nextVObject(&i);
+        if (!qstricmp(id,each->id))
+            return each;
+        }
+    return (VObject*)0;
+}
+
+DLLEXPORT(VObject*) addGroup(VObject *o, const char *g)
+{
+    /*
+        a.b.c
+        -->
+        prop(c)
+            prop(VCGrouping=b)
+                prop(VCGrouping=a)
+     */
+    char *dot = strrchr(g,'.');
+    if (dot) {
+        VObject *p, *t;
+        char *gs, *n = dot+1;
+                gs = dupStr(g,0);/* so we can write to it. */
+        /* used to be
+        * t = p = addProp_(o,lookupProp_(n));
+        */
+        t = p = addProp_(o,lookupProp(n));
+        dot = strrchr(gs,'.');
+        *dot = 0;
+        do {
+            dot = strrchr(gs,'.');
+            if (dot) {
+                n = dot+1;
+                *dot=0;
+                }
+            else
+                n = gs;
+            /* property(VCGroupingProp=n);
+                     *and the value may have VCGrouping property
+             */
+            t = addProp(t,VCGroupingProp);
+            setVObjectStringZValue(t,lookupProp_(n));
+            } while (n != gs);
+                deleteStr(gs);
+        return p;
+        }
+    else
+        return addProp_(o,lookupProp(g));
+}
+
+DLLEXPORT(VObject*) addPropValue(VObject *o, const char *p, const char *v)
+{
+    VObject *prop;
+    prop = addProp(o,p);
+    setVObjectStringZValue_(prop, strdup( v ) );
+    return prop;
+}
+
+DLLEXPORT(VObject*) addPropSizedValue_(VObject *o, const char *p, const char *v,
+        unsigned int size)
+{
+    VObject *prop;
+    prop = addProp(o,p);
+    setValueWithSize_(prop, (void*)v, size);
+    return prop;
+}
+
+DLLEXPORT(VObject*) addPropSizedValue(VObject *o, const char *p, const char *v,
+        unsigned int size)
+{
+    return addPropSizedValue_(o,p,dupStr(v,size),size);
+}
+
+
+DLLEXPORT(void) cleanVObject(VObject *o)
+{
+    if (o == 0) return;
+    if (o->prop) {
+        /* destroy time: cannot use the iterator here.
+           Have to break the cycle in the circular link
+           list and turns it into regular NULL-terminated
+           list -- since at some point of destruction,
+           the reference entry for the iterator to work
+           will not longer be valid.
+           */
+        VObject *p;
+        p = o->prop->next;
+        o->prop->next = 0;
+        do {
+           VObject *t = p->next;
+           cleanVObject(p);
+           p = t;
+           } while (p);
+        }
+    switch (VALUE_TYPE(o)) {
+        case VCVT_STRINGZ:
+        case VCVT_RAW:
+            // assume they are all allocated by malloc.
+            free((char*)STRINGZ_VALUE_OF(o));
+            break;
+        case VCVT_VOBJECT:
+            cleanVObject(VOBJECT_VALUE_OF(o));
+            break;
+        }
+    deleteVObject(o);
+}
+
+DLLEXPORT(void) cleanVObjects(VObject *list)
+{
+    while (list) {
+        VObject *t = list;
+        list = nextVObjectInList(list);
+        cleanVObject(t);
+        }
+}
+
+/*----------------------------------------------------------------------
+  The following is a String Table Facilities.
+  ----------------------------------------------------------------------*/
+
+#define STRTBLSIZE 255
+
+static StrItem *strTbl[STRTBLSIZE];
+
+static unsigned int hashStr(const char *s)
+{
+    unsigned int h = 0;
+    int i;
+    for (i=0;s[i];i++) {
+        h += s[i]*i;
+        }
+    return h % STRTBLSIZE;
+}
+
+DLLEXPORT(const char*) lookupStr(const char *s)
+{
+    StrItem *t;
+    unsigned int h = hashStr(s);
+    if ((t = strTbl[h]) != 0) {
+        do {
+            if (qstricmp(t->s,s) == 0) {
+                t->refCnt++;
+                return t->s;
+                }
+            t = t->next;
+            } while (t);
+        }
+    s = dupStr(s,0);
+    strTbl[h] = newStrItem(s,strTbl[h]);
+    return s;
+}
+
+DLLEXPORT(void) unUseStr(const char *s)
+{
+    StrItem *t, *p;
+    unsigned int h = hashStr(s);
+    if ((t = strTbl[h]) != 0) {
+        p = t;
+        do {
+            if (qstricmp(t->s,s) == 0) {
+                t->refCnt--;
+                if (t->refCnt == 0) {
+                    if (p == strTbl[h]) {
+                        strTbl[h] = t->next;
+                        }
+                    else {
+                        p->next = t->next;
+                        }
+                    deleteStr(t->s);
+                    deleteStrItem(t);
+                    return;
+                    }
+                }
+            p = t;
+            t = t->next;
+            } while (t);
+        }
+}
+
+DLLEXPORT(void) cleanStrTbl()
+{
+    int i;
+    for (i=0; i<STRTBLSIZE;i++) {
+        StrItem *t = strTbl[i];
+        while (t) {
+            StrItem *p;
+            deleteStr(t->s);
+            p = t;
+            t = t->next;
+            deleteStrItem(p);
+            } while (t);
+        strTbl[i] = 0;
+        }
+}
+
+
+struct PreDefProp {
+    const char *name;
+    const char *alias;
+    const char** fields;
+    unsigned int flags;
+    };
+
+/* flags in PreDefProp */
+        #define PD_BEGIN0x1
+        #define PD_INTERNAL0x2
+
+static const char *adrFields[] = {
+    VCPostalBoxProp,
+    VCExtAddressProp,
+    VCStreetAddressProp,
+    VCCityProp,
+    VCRegionProp,
+    VCPostalCodeProp,
+    VCCountryNameProp,
+    0
+};
+
+static const char *nameFields[] = {
+    VCFamilyNameProp,
+    VCGivenNameProp,
+    VCAdditionalNamesProp,
+    VCNamePrefixesProp,
+    VCNameSuffixesProp,
+    NULL
+    };
+
+static const char *orgFields[] = {
+    VCOrgNameProp,
+    VCOrgUnitProp,
+    VCOrgUnit2Prop,
+    VCOrgUnit3Prop,
+    VCOrgUnit4Prop,
+    NULL
+    };
+
+static const char *AAlarmFields[] = {
+    VCRunTimeProp,
+    VCSnoozeTimeProp,
+    VCRepeatCountProp,
+    VCAudioContentProp,
+    0
+    };
+
+/* ExDate -- has unamed fields */
+/* RDate -- has unamed fields */
+
+static const char *DAlarmFields[] = {
+    VCRunTimeProp,
+    VCSnoozeTimeProp,
+    VCRepeatCountProp,
+    VCDisplayStringProp,
+    0
+    };
+
+static const char *MAlarmFields[] = {
+    VCRunTimeProp,
+    VCSnoozeTimeProp,
+    VCRepeatCountProp,
+    VCEmailAddressProp,
+    VCNoteProp,
+    0
+    };
+
+static const char *PAlarmFields[] = {
+    VCRunTimeProp,
+    VCSnoozeTimeProp,
+    VCRepeatCountProp,
+    VCProcedureNameProp,
+    0
+    };
+
+static struct PreDefProp propNames[] = {
+    { VC7bitProp, 0, 0, 0 },
+    { VC8bitProp, 0, 0, 0 },
+    { VCAAlarmProp, 0, AAlarmFields, 0 },
+    { VCAdditionalNamesProp, 0, 0, 0 },
+    { VCAdrProp, 0, adrFields, 0 },
+    { VCAgentProp, 0, 0, 0 },
+    { VCAIFFProp, 0, 0, 0 },
+    { VCAOLProp, 0, 0, 0 },
+    { VCAppleLinkProp, 0, 0, 0 },
+    { VCAttachProp, 0, 0, 0 },
+    { VCAttendeeProp, 0, 0, 0 },
+    { VCATTMailProp, 0, 0, 0 },
+    { VCAudioContentProp, 0, 0, 0 },
+    { VCAVIProp, 0, 0, 0 },
+    { VCBase64Prop, 0, 0, 0 },
+    { VCBBSProp, 0, 0, 0 },
+    { VCBirthDateProp, 0, 0, 0 },
+    { VCBMPProp, 0, 0, 0 },
+    { VCBodyProp, 0, 0, 0 },
+    { VCBusinessRoleProp, 0, 0, 0 },
+    { VCCalProp, 0, 0, PD_BEGIN },
+    { VCCaptionProp, 0, 0, 0 },
+    { VCCardProp, 0, 0, PD_BEGIN },
+    { VCCarProp, 0, 0, 0 },
+    { VCCategoriesProp, 0, 0, 0 },
+    { VCCellularProp, 0, 0, 0 },
+    { VCCGMProp, 0, 0, 0 },
+    { VCCharSetProp, 0, 0, 0 },
+    { VCCIDProp, VCContentIDProp, 0, 0 },
+    { VCCISProp, 0, 0, 0 },
+    { VCCityProp, 0, 0, 0 },
+    { VCClassProp, 0, 0, 0 },
+    { VCCommentProp, 0, 0, 0 },
+    { VCCompletedProp, 0, 0, 0 },
+    { VCContentIDProp, 0, 0, 0 },
+    { VCCountryNameProp, 0, 0, 0 },
+    { VCDAlarmProp, 0, DAlarmFields, 0 },
+    { VCDataSizeProp, 0, 0, PD_INTERNAL },
+    { VCDayLightProp, 0, 0, 0 },
+    { VCDCreatedProp, 0, 0, 0 },
+    { VCDeliveryLabelProp, 0, 0, 0 },
+    { VCDescriptionProp, 0, 0, 0 },
+    { VCDIBProp, 0, 0, 0 },
+    { VCDisplayStringProp, 0, 0, 0 },
+    { VCDomesticProp, 0, 0, 0 },
+    { VCDTendProp, 0, 0, 0 },
+    { VCDTstartProp, 0, 0, 0 },
+    { VCDueProp, 0, 0, 0 },
+    { VCEmailAddressProp, 0, 0, 0 },
+    { VCEncodingProp, 0, 0, 0 },
+    { VCEndProp, 0, 0, 0 },
+    { VCEventProp, 0, 0, PD_BEGIN },
+    { VCEWorldProp, 0, 0, 0 },
+    { VCExNumProp, 0, 0, 0 },
+    { VCExpDateProp, 0, 0, 0 },
+    { VCExpectProp, 0, 0, 0 },
+    { VCExtAddressProp, 0, 0, 0 },
+    { VCFamilyNameProp, 0, 0, 0 },
+    { VCFaxProp, 0, 0, 0 },
+    { VCFullNameProp, 0, 0, 0 },
+    { VCGeoLocationProp, 0, 0, 0 },
+    { VCGeoProp, 0, 0, 0 },
+    { VCGIFProp, 0, 0, 0 },
+    { VCGivenNameProp, 0, 0, 0 },
+    { VCGroupingProp, 0, 0, 0 },
+    { VCHomeProp, 0, 0, 0 },
+    { VCIBMMailProp, 0, 0, 0 },
+    { VCInlineProp, 0, 0, 0 },
+    { VCInternationalProp, 0, 0, 0 },
+    { VCInternetProp, 0, 0, 0 },
+    { VCISDNProp, 0, 0, 0 },
+    { VCJPEGProp, 0, 0, 0 },
+    { VCLanguageProp, 0, 0, 0 },
+    { VCLastModifiedProp, 0, 0, 0 },
+    { VCLastRevisedProp, 0, 0, 0 },
+    { VCLocationProp, 0, 0, 0 },
+    { VCLogoProp, 0, 0, 0 },
+    { VCMailerProp, 0, 0, 0 },
+    { VCMAlarmProp, 0, MAlarmFields, 0 },
+    { VCMCIMailProp, 0, 0, 0 },
+    { VCMessageProp, 0, 0, 0 },
+    { VCMETProp, 0, 0, 0 },
+    { VCModemProp, 0, 0, 0 },
+    { VCMPEG2Prop, 0, 0, 0 },
+    { VCMPEGProp, 0, 0, 0 },
+    { VCMSNProp, 0, 0, 0 },
+    { VCNamePrefixesProp, 0, 0, 0 },
+    { VCNameProp, 0, nameFields, 0 },
+    { VCNameSuffixesProp, 0, 0, 0 },
+    { VCNoteProp, 0, 0, 0 },
+    { VCOrgNameProp, 0, 0, 0 },
+    { VCOrgProp, 0, orgFields, 0 },
+    { VCOrgUnit2Prop, 0, 0, 0 },
+    { VCOrgUnit3Prop, 0, 0, 0 },
+    { VCOrgUnit4Prop, 0, 0, 0 },
+    { VCOrgUnitProp, 0, 0, 0 },
+    { VCPagerProp, 0, 0, 0 },
+    { VCPAlarmProp, 0, PAlarmFields, 0 },
+    { VCParcelProp, 0, 0, 0 },
+    { VCPartProp, 0, 0, 0 },
+    { VCPCMProp, 0, 0, 0 },
+    { VCPDFProp, 0, 0, 0 },
+    { VCPGPProp, 0, 0, 0 },
+    { VCPhotoProp, 0, 0, 0 },
+    { VCPICTProp, 0, 0, 0 },
+    { VCPMBProp, 0, 0, 0 },
+    { VCPostalBoxProp, 0, 0, 0 },
+    { VCPostalCodeProp, 0, 0, 0 },
+    { VCPostalProp, 0, 0, 0 },
+    { VCPowerShareProp, 0, 0, 0 },
+    { VCPreferredProp, 0, 0, 0 },
+    { VCPriorityProp, 0, 0, 0 },
+    { VCProcedureNameProp, 0, 0, 0 },
+    { VCProdIdProp, 0, 0, 0 },
+    { VCProdigyProp, 0, 0, 0 },
+    { VCPronunciationProp, 0, 0, 0 },
+    { VCPSProp, 0, 0, 0 },
+    { VCPublicKeyProp, 0, 0, 0 },
+    { VCQPProp, VCQuotedPrintableProp, 0, 0 },
+    { VCQuickTimeProp, 0, 0, 0 },
+    { VCQuotedPrintableProp, 0, 0, 0 },
+    { VCRDateProp, 0, 0, 0 },
+    { VCRegionProp, 0, 0, 0 },
+    { VCRelatedToProp, 0, 0, 0 },
+    { VCRepeatCountProp, 0, 0, 0 },
+    { VCResourcesProp, 0, 0, 0 },
+    { VCRNumProp, 0, 0, 0 },
+    { VCRoleProp, 0, 0, 0 },
+    { VCRRuleProp, 0, 0, 0 },
+    { VCRSVPProp, 0, 0, 0 },
+    { VCRunTimeProp, 0, 0, 0 },
+    { VCSequenceProp, 0, 0, 0 },
+    { VCSnoozeTimeProp, 0, 0, 0 },
+    { VCStartProp, 0, 0, 0 },
+    { VCStatusProp, 0, 0, 0 },
+    { VCStreetAddressProp, 0, 0, 0 },
+    { VCSubTypeProp, 0, 0, 0 },
+    { VCSummaryProp, 0, 0, 0 },
+    { VCTelephoneProp, 0, 0, 0 },
+    { VCTIFFProp, 0, 0, 0 },
+    { VCTimeZoneProp, 0, 0, 0 },
+    { VCTitleProp, 0, 0, 0 },
+    { VCTLXProp, 0, 0, 0 },
+    { VCTodoProp, 0, 0, PD_BEGIN },
+    { VCTranspProp, 0, 0, 0 },
+    { VCUniqueStringProp, 0, 0, 0 },
+    { VCURLProp, 0, 0, 0 },
+    { VCURLValueProp, 0, 0, 0 },
+    { VCValueProp, 0, 0, 0 },
+    { VCVersionProp, 0, 0, 0 },
+    { VCVideoProp, 0, 0, 0 },
+    { VCVoiceProp, 0, 0, 0 },
+    { VCWAVEProp, 0, 0, 0 },
+    { VCWMFProp, 0, 0, 0 },
+    { VCWorkProp, 0, 0, 0 },
+    { VCX400Prop, 0, 0, 0 },
+    { VCX509Prop, 0, 0, 0 },
+    { VCXRuleProp, 0, 0, 0 },
+    { 0,0,0,0 }
+    };
+
+
+static struct PreDefProp* lookupPropInfo(const char* str)
+{
+    /* brute force for now, could use a hash table here. */
+    int i;
+        
+    for (i = 0; propNames[i].name; i++)
+        if (qstricmp(str, propNames[i].name) == 0) {
+            return &propNames[i];
+            }
+    
+    return 0;
+}
+
+
+DLLEXPORT(const char*) lookupProp_(const char* str)
+{
+    int i;
+        
+    for (i = 0; propNames[i].name; i++)
+        if (qstricmp(str, propNames[i].name) == 0) {
+            const char* s;
+            s = propNames[i].alias?propNames[i].alias:propNames[i].name;
+            return lookupStr(s);
+            }
+    return lookupStr(str);
+}
+
+
+DLLEXPORT(const char*) lookupProp(const char* str)
+{
+    int i;
+        
+    for (i = 0; propNames[i].name; i++)
+        if (qstricmp(str, propNames[i].name) == 0) {
+            const char *s;
+            fieldedProp = propNames[i].fields;
+            s = propNames[i].alias?propNames[i].alias:propNames[i].name;
+            return lookupStr(s);
+            }
+    fieldedProp = 0;
+    return lookupStr(str);
+}
+
+
+/*----------------------------------------------------------------------
+  APIs to Output text form.
+  ----------------------------------------------------------------------*/
+#define OFILE_REALLOC_SIZE 256
+typedef struct OFile {
+    FILE *fp;
+    char *s;
+    int len;
+    int limit;
+    int alloc:1;
+    int fail:1;
+    } OFile;
+
+#if 0
+static void appendsOFile(OFile *fp, const char *s)
+{
+    int slen;
+    if (fp->fail) return;
+    slen  = strlen(s);
+    if (fp->fp) {
+        fwrite(s,1,slen,fp->fp);
+        }
+    else {
+stuff:
+        if (fp->len + slen < fp->limit) {
+            memcpy(fp->s+fp->len,s,slen);
+            fp->len += slen;
+            return;
+            }
+        else if (fp->alloc) {
+            fp->limit = fp->limit + OFILE_REALLOC_SIZE;
+            if (OFILE_REALLOC_SIZE <= slen) fp->limit += slen;
+            fp->s = (char *) realloc(fp->s,fp->limit);
+            if (fp->s) goto stuff;
+            }
+        if (fp->alloc)
+            free(fp->s);
+        fp->s = 0;
+        fp->fail = 1;
+        }
+}
+
+static void appendcOFile(OFile *fp, char c)
+{
+    if (fp->fail) return;
+    if (fp->fp) {
+        fputc(c,fp->fp);
+        }
+    else {
+stuff:
+        if (fp->len+1 < fp->limit) {
+            fp->s[fp->len] = c;
+            fp->len++;
+            return;
+            }
+        else if (fp->alloc) {
+            fp->limit = fp->limit + OFILE_REALLOC_SIZE;
+            fp->s = (char *) realloc(fp->s,fp->limit);
+            if (fp->s) goto stuff;
+            }
+        if (fp->alloc)
+            free(fp->s);
+        fp->s = 0;
+        fp->fail = 1;
+        }
+}
+#else
+static void appendcOFile_(OFile *fp, char c)
+{
+    if (fp->fail) return;
+    if (fp->fp) {
+        fputc(c,fp->fp);
+        }
+    else {
+stuff:
+        if (fp->len+1 < fp->limit) {
+            fp->s[fp->len] = c;
+            fp->len++;
+            return;
+            }
+        else if (fp->alloc) {
+            fp->limit = fp->limit + OFILE_REALLOC_SIZE;
+            fp->s = (char *)realloc(fp->s,fp->limit);
+            if (fp->s) goto stuff;
+            }
+        if (fp->alloc)
+            free(fp->s);
+        fp->s = 0;
+        fp->fail = 1;
+        }
+}
+
+static void appendcOFile(OFile *fp, char c)
+{
+    if (c == '\n') {
+        /* write out as <CR><LF> */
+        appendcOFile_(fp,0xd);
+        appendcOFile_(fp,0xa);
+        }
+    else
+        appendcOFile_(fp,c);
+}
+
+static void appendsOFile(OFile *fp, const char *s)
+{
+    int i, slen;
+    slen  = strlen(s);
+    for (i=0; i<slen; i++) {
+        appendcOFile(fp,s[i]);
+        }
+}
+
+#endif
+
+static void initOFile(OFile *fp, FILE *ofp)
+{
+    fp->fp = ofp;
+    fp->s = 0;
+    fp->len = 0;
+    fp->limit = 0;
+    fp->alloc = 0;
+    fp->fail = 0;
+}
+
+static int writeBase64(OFile *fp, unsigned char *s, long len)
+{
+    long cur = 0;
+    int i, numQuads = 0;
+    unsigned long trip;
+    unsigned char b;
+    char quad[5];
+#define MAXQUADS 16
+
+    quad[4] = 0;
+
+    while (cur < len) {
+        // collect the triplet of bytes into 'trip'
+        trip = 0;
+        for (i = 0; i < 3; i++) {
+            b = (cur < len) ? *(s + cur) : 0;
+            cur++;
+            trip = trip << 8 | b;
+            }
+        // fill in 'quad' with the appropriate four characters
+        for (i = 3; i >= 0; i--) {
+            b = (unsigned char)(trip & 0x3F);
+            trip = trip >> 6;
+            if ((3 - i) < (cur - len))
+                quad[i] = '='; // pad char
+            else if (b < 26) quad[i] = (char)b + 'A';
+            else if (b < 52) quad[i] = (char)(b - 26) + 'a';
+            else if (b < 62) quad[i] = (char)(b - 52) + '0';
+            else if (b == 62) quad[i] = '+';
+            else quad[i] = '/';
+            }
+        // now output 'quad' with appropriate whitespace and line ending
+        appendsOFile(fp, (numQuads == 0 ? "    " : ""));
+        appendsOFile(fp, quad);
+        appendsOFile(fp, ((cur >= len)?"\n" :(numQuads==MAXQUADS-1?"\n" : "")));
+        numQuads = (numQuads + 1) % MAXQUADS;
+        }
+    appendcOFile(fp,'\n');
+
+    return 1;
+}
+
+static const char *replaceChar(unsigned char c) 
+{
+    if (c == '\n') {
+        return "=0A=\n";
+    } else if (
+            (c >= 'A' && c <= 'Z') 
+            ||
+            (c >= 'a' && c <= 'z') 
+            ||
+            (c >= '0' && c <= '9') 
+            ||
+            (c >= '\'' && c <= ')') 
+            ||
+            (c >= '+' && c <= '-') 
+            ||
+            (c == '/')
+            ||
+            (c == '?') 
+            ||
+            (c == ' ')) 
+    { 
+        return 0;
+    }
+
+    static char trans[4];
+    trans[0] = '=';
+    trans[3] = '\0';
+    int rem = c % 16;
+    int div = c / 16;
+
+    if (div < 10)
+        trans[1] = '0' + div;
+    else
+        trans[1] = 'A' + (div - 10);
+
+    if (rem < 10)
+        trans[2] = '0' + rem;
+    else
+        trans[2] = 'A' + (rem - 10);
+
+    return trans;
+}
+
+static void writeQPString(OFile *fp, const char *s)
+{
+    /*
+        only A-Z, 0-9 and 
+       "'"  (ASCII code 39)
+       "("  (ASCII code 40)
+       ")"  (ASCII code 41)
+       "+"  (ASCII code 43)
+       ","  (ASCII code 44)
+       "-"  (ASCII code 45)
+       "/"  (ASCII code 47)
+       "?"  (ASCII code 63)
+       
+       should remain un-encoded.
+       '=' needs to be encoded as it is the escape character.
+       ';' needs to be as it is a field separator.
+
+     */
+    const char *p = s;
+    while (*p) {
+        const char *rep = replaceChar(*p);
+        if (rep)
+            appendsOFile(fp, rep);
+        else
+            appendcOFile(fp, *p);
+        p++;
+    }
+}
+
+static bool includesUnprintable(VObject *o)
+{
+    if (o) {
+        if (VALUE_TYPE(o) == VCVT_STRINGZ) {
+            const char *p = STRINGZ_VALUE_OF(o);
+            if (p) {
+                while (*p) {
+                    if (replaceChar(*p))
+                        return TRUE;
+                    p++;
+                }
+            }
+        }
+    }
+    return FALSE;
+}
+            
+static void writeVObject_(OFile *fp, VObject *o);
+
+static void writeValue(OFile *fp, VObject *o, unsigned long size)
+{
+    if (o == 0) return;
+    switch (VALUE_TYPE(o)) {
+        case VCVT_STRINGZ: {
+            writeQPString(fp, STRINGZ_VALUE_OF(o));
+            break;
+            }
+        case VCVT_UINT: {
+            char buf[16];
+            sprintf(buf,"%u", INTEGER_VALUE_OF(o));
+            appendsOFile(fp,buf);
+            break;
+            }
+        case VCVT_ULONG: {
+            char buf[16];
+            sprintf(buf,"%lu", LONG_VALUE_OF(o));
+            appendsOFile(fp,buf);
+            break;
+            }
+        case VCVT_RAW: {
+            appendcOFile(fp,'\n');
+            writeBase64(fp,(unsigned char*)(ANY_VALUE_OF(o)),size);
+            break;
+            }
+        case VCVT_VOBJECT:
+            appendcOFile(fp,'\n');
+            writeVObject_(fp,VOBJECT_VALUE_OF(o));
+            break;
+        }
+}
+
+static void writeAttrValue(OFile *fp, VObject *o)
+{
+    if (NAME_OF(o)) {
+        struct PreDefProp *pi;
+        pi = lookupPropInfo(NAME_OF(o));
+        if (pi && ((pi->flags & PD_INTERNAL) != 0)) return;
+        if ( includesUnprintable(o) ) {
+            appendsOFile(fp, ";" VCEncodingProp "=" VCQuotedPrintableProp);
+            appendsOFile(fp, ";" VCCharSetProp "=" "UTF-8");
+        }
+        appendcOFile(fp,';');
+        appendsOFile(fp,NAME_OF(o));
+        }
+    else
+        appendcOFile(fp,';');
+    if (VALUE_TYPE(o)) {
+        appendcOFile(fp,'=');
+        writeValue(fp,o,0);
+        }
+}
+
+static void writeGroup(OFile *fp, VObject *o)
+{
+    char buf1[256];
+    char buf2[256];
+    strcpy(buf1,NAME_OF(o));
+    while ((o=isAPropertyOf(o,VCGroupingProp)) != 0) {
+        strcpy(buf2,STRINGZ_VALUE_OF(o));
+        strcat(buf2,".");
+        strcat(buf2,buf1);
+        strcpy(buf1,buf2);
+        }
+    appendsOFile(fp,buf1);
+}
+
+static int inList(const char **list, const char *s)
+{
+    if (list == 0) return 0;
+    while (*list) {
+        if (qstricmp(*list,s) == 0) return 1;
+        list++;
+        }
+    return 0;
+}
+
+static void writeProp(OFile *fp, VObject *o)
+{
+    if (NAME_OF(o)) {
+        struct PreDefProp *pi;
+        VObjectIterator t;
+        const char **fields_ = 0;
+        pi = lookupPropInfo(NAME_OF(o));
+        if (pi && ((pi->flags & PD_BEGIN) != 0)) {
+            writeVObject_(fp,o);
+            return;
+            }
+        if (isAPropertyOf(o,VCGroupingProp))
+            writeGroup(fp,o);
+        else
+            appendsOFile(fp,NAME_OF(o));
+        if (pi) fields_ = pi->fields;
+        initPropIterator(&t,o);
+        while (moreIteration(&t)) {
+            const char *s;
+            VObject *eachProp = nextVObject(&t);
+            s = NAME_OF(eachProp);
+            if (qstricmp(VCGroupingProp,s) && !inList(fields_,s))
+                writeAttrValue(fp,eachProp);
+            }
+        if (fields_) {
+            int i = 0, n = 0;
+            const char** fields = fields_;
+            /* output prop as fields */
+            bool printable = TRUE;
+            while (*fields && printable) {
+                VObject *t = isAPropertyOf(o,*fields);
+                if (includesUnprintable(t))
+                    printable = FALSE;
+                fields++;
+            }
+            fields = fields_;
+            if (!printable) {
+                appendsOFile(fp, ";" VCEncodingProp "=" VCQuotedPrintableProp);
+                appendsOFile(fp, ";" VCCharSetProp "=" "UTF-8");
+            }
+            appendcOFile(fp,':');
+            while (*fields) {
+                VObject *t = isAPropertyOf(o,*fields);
+                i++;
+                if (t) n = i;
+                fields++;
+            }
+            fields = fields_;
+            for (i=0;i<n;i++) {
+                writeValue(fp,isAPropertyOf(o,*fields),0);
+                fields++;
+                if (i<(n-1)) appendcOFile(fp,';');
+            }
+            }
+        }
+
+        
+    if (VALUE_TYPE(o)) {
+            if ( includesUnprintable(o) ) {
+            appendsOFile(fp, ";" VCEncodingProp "=" VCQuotedPrintableProp);
+            appendsOFile(fp, ";" VCCharSetProp "=" "UTF-8");
+        }
+        unsigned long size = 0;
+        VObject *p = isAPropertyOf(o,VCDataSizeProp);
+        if (p) size = LONG_VALUE_OF(p);
+        appendcOFile(fp,':');
+        writeValue(fp,o,size);
+        }
+
+    appendcOFile(fp,'\n');
+}
+
+static void writeVObject_(OFile *fp, VObject *o)
+{
+    if (NAME_OF(o)) {
+        struct PreDefProp *pi;
+        pi = lookupPropInfo(NAME_OF(o));
+
+        if (pi && ((pi->flags & PD_BEGIN) != 0)) {
+            VObjectIterator t;
+            const char *begin = NAME_OF(o);
+            appendsOFile(fp,"BEGIN:");
+            appendsOFile(fp,begin);
+            appendcOFile(fp,'\n');
+            initPropIterator(&t,o);
+            while (moreIteration(&t)) {
+                VObject *eachProp = nextVObject(&t);
+                writeProp(fp, eachProp);
+                }
+            appendsOFile(fp,"END:");
+            appendsOFile(fp,begin);
+            appendsOFile(fp,"\n\n");
+            }
+        }
+}
+
+void writeVObject(FILE *fp, VObject *o)
+{
+    OFile ofp;
+    // #####
+    //_setmode(_fileno(fp), _O_BINARY);
+    initOFile(&ofp,fp);
+    writeVObject_(&ofp,o);
+}
+
+DLLEXPORT(void) writeVObjectToFile(char *fname, VObject *o)
+{
+        QFileDirect f( fname);
+        if ( !f.open( IO_WriteOnly ) ) {
+                qWarning("Unable to open vobject write %s", fname);
+                return;
+        }
+
+    writeVObject( f.directHandle(),o );
+}
+
+DLLEXPORT(void) writeVObjectsToFile(char *fname, VObject *list)
+{
+        QFileDirect f( fname);
+        if ( !f.open( IO_WriteOnly ) ) {
+                qWarning("Unable to open vobject write %s", fname);
+                return;
+        }
+
+        while (list) {
+            writeVObject(f.directHandle(),list);
+            list = nextVObjectInList(list);
+            }
+}
+
+DLLEXPORT(const char *) vObjectTypeInfo(VObject *o)
+{
+    const char *type = vObjectName( o );
+    if ( strcmp( type, "TYPE" ) == 0 )
+        type = vObjectStringZValue( o );
+    return type;
+}
+
+
+// end of source file vobject.c
diff --git a/library/backend/vobject_p.h b/library/backend/vobject_p.h
index a0d921e..0d0a2a8 100644
--- a/library/backend/vobject_p.h
+++ b/library/backend/vobject_p.h
@@ -1,404 +1,406 @@
-/***************************************************************************

-(C) Copyright 1996 Apple Computer, Inc., AT&T Corp., International

-Business Machines Corporation and Siemens Rolm Communications Inc.

-

-For purposes of this license notice, the term Licensors shall mean,

-collectively, Apple Computer, Inc., AT&T Corp., International

-Business Machines Corporation and Siemens Rolm Communications Inc.

-The term Licensor shall mean any of the Licensors.

-

-Subject to acceptance of the following conditions, permission is hereby

-granted by Licensors without the need for written agreement and without

-license or royalty fees, to use, copy, modify and distribute this

-software for any purpose.

-

-The above copyright notice and the following four paragraphs must be

-reproduced in all copies of this software and any software including

-this software.

-

-THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS AND NO LICENSOR SHALL HAVE

-ANY OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS OR

-MODIFICATIONS.

-

-IN NO EVENT SHALL ANY LICENSOR BE LIABLE TO ANY PARTY FOR DIRECT,

-INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES OR LOST PROFITS ARISING OUT

-OF THE USE OF THIS SOFTWARE EVEN IF ADVISED OF THE POSSIBILITY OF SUCH

-DAMAGE.

-

-EACH LICENSOR SPECIFICALLY DISCLAIMS ANY WARRANTIES, EXPRESS OR IMPLIED,

-INCLUDING BUT NOT LIMITED TO ANY WARRANTY OF NONINFRINGEMENT OR THE

-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR

-PURPOSE.

-

-The software is provided with RESTRICTED RIGHTS.  Use, duplication, or

-disclosure by the government are subject to restrictions set forth in

-DFARS 252.227-7013 or 48 CFR 52.227-19, as applicable.

-

-***************************************************************************/

-

-/*

-

-The vCard/vCalendar C interface is implemented in the set

-of files as follows:

-

-vcc.y, yacc source, and vcc.c, the yacc output you will use

-implements the core parser

-

-vobject.c implements an API that insulates the caller from

-the parser and changes in the vCard/vCalendar BNF

-

-port.h defines compilation environment dependent stuff

-

-vcc.h and vobject.h are header files for their .c counterparts

-

-vcaltmp.h and vcaltmp.c implement vCalendar "macro" functions

-which you may find useful.

-

-test.c is a standalone test driver that exercises some of

-the features of the APIs provided. Invoke test.exe on a

-VCARD/VCALENDAR input text file and you will see the pretty

-print output of the internal representation (this pretty print

-output should give you a good idea of how the internal

-representation looks like -- there is one such output in the

-following too). Also, a file with the .out suffix is generated

-to show that the internal representation can be written back

-in the original text format.

-

-For more information on this API see the readme.txt file

-which accompanied this distribution.

-

-  Also visit:

-

-                http://www.versit.com

-                http://www.ralden.com

-

-*/

-

-

-#ifndef __VOBJECT_H__

-#define __VOBJECT_H__ 1

-

-#include <qstring.h>

-

-        #define         vCardClipboardFormat    "+//ISBN 1-887687-00-9::versit::PDI//vCard"

-        #define         vCalendarClipboardFormat"+//ISBN 1-887687-00-9::versit::PDI//vCalendar"

-

-/* The above strings vCardClipboardFormat and vCalendarClipboardFormat

-are globally unique IDs which can be used to generate clipboard format

-ID's as per the requirements of a specific platform. For example, in

-Windows they are used as the parameter in a call to RegisterClipboardFormat.

-For example:

-

-  CLIPFORMAT foo = RegisterClipboardFormat(vCardClipboardFormat);

-

-*/

-

-        #define vCardMimeType   "text/x-vCard"

-        #define vCalendarMimeType"text/x-vCalendar"

-

-#undef DLLEXPORT

-#include <qglobal.h>

-#if defined(Q_WS_WIN)

-#define DLLEXPORT(t)   __declspec(dllexport) t

-#else

-#define DLLEXPORT(t)   t

-#endif

-

-#ifndef FALSE

-        #define FALSE0

-#endif

-#ifndef TRUE

-        #define TRUE1

-#endif

-

-#include <stdlib.h>

-#include <stdio.h>

-

-

-        #define VC7bitProp                      "7BIT"

-        #define VC8bitProp                      "8BIT"

-        #define VCAAlarmProp            "AALARM"

-        #define VCAdditionalNamesProp"ADDN"

-        #define VCAdrProp                       "ADR"

-        #define VCAgentProp                     "AGENT"

-        #define VCAIFFProp                      "AIFF"

-        #define VCAOLProp                       "AOL"

-        #define VCAppleLinkProp                 "APPLELINK"

-        #define VCAttachProp            "ATTACH"

-        #define VCAttendeeProp          "ATTENDEE"

-        #define VCATTMailProp           "ATTMAIL"

-        #define VCAudioContentProp      "AUDIOCONTENT"

-        #define VCAVIProp                       "AVI"

-        #define VCBase64Prop            "BASE64"

-        #define VCBBSProp                       "BBS"

-        #define VCBirthDateProp                 "BDAY"

-        #define VCBMPProp                       "BMP"

-        #define VCBodyProp                      "BODY"

-        #define VCBusinessRoleProp      "ROLE"

-        #define VCCalProp                       "VCALENDAR"

-        #define VCCaptionProp           "CAP"

-        #define VCCardProp                      "VCARD"

-        #define VCCarProp                       "CAR"

-        #define VCCategoriesProp        "CATEGORIES"

-        #define VCCellularProp          "CELL"

-        #define VCCGMProp                       "CGM"

-        #define VCCharSetProp           "CS"

-        #define VCCIDProp                       "CID"

-        #define VCCISProp                       "CIS"

-        #define VCCityProp                      "L"

-        #define VCClassProp                     "CLASS"

-        #define VCCommentProp           "NOTE"

-        #define VCCompletedProp                 "COMPLETED"

-        #define VCContentIDProp                 "CONTENT-ID"

-        #define VCCountryNameProp       "C"

-        #define VCDAlarmProp            "DALARM"

-        #define VCDataSizeProp          "DATASIZE"

-        #define VCDayLightProp          "DAYLIGHT"

-        #define VCDCreatedProp          "DCREATED"

-#define VCDeliveryLabelProp     "LABEL"

-        #define VCDescriptionProp       "DESCRIPTION"

-        #define VCDIBProp                       "DIB"

-        #define VCDisplayStringProp     "DISPLAYSTRING"

-        #define VCDomesticProp          "DOM"

-        #define VCDTendProp                     "DTEND"

-        #define VCDTstartProp           "DTSTART"

-        #define VCDueProp                       "DUE"

-        #define VCEmailAddressProp      "EMAIL"

-        #define VCEncodingProp          "ENCODING"

-        #define VCEndProp                       "END"

-        #define VCEventProp                     "VEVENT"

-        #define VCEWorldProp            "EWORLD"

-        #define VCExNumProp                     "EXNUM"

-        #define VCExpDateProp           "EXDATE"

-        #define VCExpectProp            "EXPECT"

-        #define VCExtAddressProp        "EXT ADD"

-        #define VCFamilyNameProp        "F"

-        #define VCFaxProp                       "FAX"

-        #define VCFullNameProp          "FN"

-        #define VCGeoProp                       "GEO"

-        #define VCGeoLocationProp       "GEO"

-        #define VCGIFProp                       "GIF"

-        #define VCGivenNameProp                 "G"

-        #define VCGroupingProp          "Grouping"

-        #define VCHomeProp                      "HOME"

-        #define VCIBMMailProp           "IBMMail"

-        #define VCInlineProp            "INLINE"

-        #define VCInternationalProp     "INTL"

-        #define VCInternetProp          "INTERNET"

-        #define VCISDNProp                      "ISDN"

-        #define VCJPEGProp                      "JPEG"

-        #define VCLanguageProp          "LANG"

-        #define VCLastModifiedProp      "LAST-MODIFIED"

-        #define VCLastRevisedProp       "REV"

-        #define VCLocationProp          "LOCATION"

-        #define VCLogoProp                      "LOGO"

-        #define VCMailerProp            "MAILER"

-        #define VCMAlarmProp            "MALARM"

-        #define VCMCIMailProp           "MCIMAIL"

-        #define VCMessageProp           "MSG"

-        #define VCMETProp                       "MET"

-        #define VCModemProp                     "MODEM"

-        #define VCMPEG2Prop                     "MPEG2"

-        #define VCMPEGProp                      "MPEG"

-        #define VCMSNProp                       "MSN"

-        #define VCNamePrefixesProp      "NPRE"

-        #define VCNameProp                      "N"

-        #define VCNameSuffixesProp      "NSUF"

-        #define VCNoteProp                      "NOTE"

-        #define VCOrgNameProp           "ORGNAME"

-        #define VCOrgProp                       "ORG"

-        #define VCOrgUnit2Prop          "OUN2"

-        #define VCOrgUnit3Prop          "OUN3"

-        #define VCOrgUnit4Prop          "OUN4"

-        #define VCOrgUnitProp           "OUN"

-        #define VCPagerProp                     "PAGER"

-        #define VCPAlarmProp            "PALARM"

-        #define VCParcelProp            "PARCEL"

-        #define VCPartProp                      "PART"

-        #define VCPCMProp                       "PCM"

-        #define VCPDFProp                       "PDF"

-        #define VCPGPProp                       "PGP"

-        #define VCPhotoProp                     "PHOTO"

-        #define VCPICTProp                      "PICT"

-        #define VCPMBProp                       "PMB"

-        #define VCPostalBoxProp                 "BOX"

-        #define VCPostalCodeProp        "PC"

-        #define VCPostalProp            "POSTAL"

-        #define VCPowerShareProp        "POWERSHARE"

-        #define VCPreferredProp                 "PREF"

-        #define VCPriorityProp          "PRIORITY"

-        #define VCProcedureNameProp     "PROCEDURENAME"

-        #define VCProdIdProp            "PRODID"

-        #define VCProdigyProp           "PRODIGY"

-        #define VCPronunciationProp     "SOUND"

-        #define VCPSProp                        "PS"

-        #define VCPublicKeyProp                 "KEY"

-        #define VCQPProp                        "QP"

-        #define VCQuickTimeProp                 "QTIME"

-        #define VCQuotedPrintableProp"QUOTED-PRINTABLE"

-        #define VCRDateProp                     "RDATE"

-        #define VCRegionProp            "R"

-        #define VCRelatedToProp                 "RELATED-TO"

-        #define VCRepeatCountProp       "REPEATCOUNT"

-        #define VCResourcesProp                 "RESOURCES"

-        #define VCRNumProp                      "RNUM"

-        #define VCRoleProp                      "ROLE"

-        #define VCRRuleProp                     "RRULE"

-        #define VCRSVPProp                      "RSVP"

-        #define VCRunTimeProp           "RUNTIME"

-        #define VCSequenceProp          "SEQUENCE"

-        #define VCSnoozeTimeProp        "SNOOZETIME"

-        #define VCStartProp                     "START"

-        #define VCStatusProp            "STATUS"

-        #define VCStreetAddressProp     "STREET"

-        #define VCSubTypeProp           "SUBTYPE"

-        #define VCSummaryProp           "SUMMARY"

-        #define VCTelephoneProp                 "TEL"

-        #define VCTIFFProp                      "TIFF"

-        #define VCTimeZoneProp          "TZ"

-        #define VCTitleProp                     "TITLE"

-        #define VCTLXProp                       "TLX"

-        #define VCTodoProp                      "VTODO"

-        #define VCTranspProp            "TRANSP"

-        #define VCUniqueStringProp      "UID"

-        #define VCURLProp                       "URL"

-        #define VCURLValueProp          "URLVAL"

-        #define VCValueProp                     "VALUE"

-        #define VCVersionProp           "VERSION"

-        #define VCVideoProp                     "VIDEO"

-        #define VCVoiceProp                     "VOICE"

-        #define VCWAVEProp                      "WAVE"

-        #define VCWMFProp                       "WMF"

-        #define VCWorkProp                      "WORK"

-        #define VCX400Prop                      "X400"

-        #define VCX509Prop                      "X509"

-        #define VCXRuleProp                     "XRULE"

-

-

-typedef struct VObject VObject;

-

-typedef struct VObjectIterator {

-    VObject* start;

-    VObject* next;

-    } VObjectIterator;

-

-extern DLLEXPORT(VObject*) newVObject(const char *id);

-extern DLLEXPORT(void) deleteVObject(VObject *p);

-extern DLLEXPORT(char*) dupStr(const char *s, unsigned int size);

-extern DLLEXPORT(void) deleteStr(const char *p);

-extern DLLEXPORT(void) unUseStr(const char *s);

-

-extern DLLEXPORT(void) setVObjectName(VObject *o, const char* id);

-extern DLLEXPORT(void) setVObjectStringZValue(VObject *o, const char *s);

-extern DLLEXPORT(void) setVObjectStringZValue_(VObject *o, const char *s);

-extern DLLEXPORT(void) setVObjectIntegerValue(VObject *o, unsigned int i);

-extern DLLEXPORT(void) setVObjectLongValue(VObject *o, unsigned long l);

-extern DLLEXPORT(void) setVObjectAnyValue(VObject *o, void *t);

-extern DLLEXPORT(VObject*) setValueWithSize(VObject *prop, void *val, unsigned int size);

-extern DLLEXPORT(VObject*) setValueWithSize_(VObject *prop, void *val, unsigned int size);

-

-extern DLLEXPORT(const char*) vObjectName(VObject *o);

-extern DLLEXPORT(const char*) vObjectStringZValue(VObject *o);

-extern DLLEXPORT(unsigned int) vObjectIntegerValue(VObject *o);

-extern DLLEXPORT(unsigned long) vObjectLongValue(VObject *o);

-extern DLLEXPORT(void*) vObjectAnyValue(VObject *o);

-extern DLLEXPORT(VObject*) vObjectVObjectValue(VObject *o);

-extern DLLEXPORT(void) setVObjectVObjectValue(VObject *o, VObject *p);

-

-extern DLLEXPORT(VObject*) addVObjectProp(VObject *o, VObject *p);

-extern DLLEXPORT(VObject*) addProp(VObject *o, const char *id);

-extern DLLEXPORT(VObject*) addProp_(VObject *o, const char *id);

-extern DLLEXPORT(VObject*) addPropValue(VObject *o, const char *p, const char *v);

-extern DLLEXPORT(VObject*) addPropSizedValue_(VObject *o, const char *p, const char *v, unsigned int size);

-extern DLLEXPORT(VObject*) addPropSizedValue(VObject *o, const char *p, const char *v, unsigned int size);

-extern DLLEXPORT(VObject*) addGroup(VObject *o, const char *g);

-extern DLLEXPORT(void) addList(VObject **o, VObject *p);

-

-extern DLLEXPORT(VObject*) isAPropertyOf(VObject *o, const char *id);

-

-extern DLLEXPORT(VObject*) nextVObjectInList(VObject *o);

-extern DLLEXPORT(void) initPropIterator(VObjectIterator *i, VObject *o);

-extern DLLEXPORT(int) moreIteration(VObjectIterator *i);

-extern DLLEXPORT(VObject*) nextVObject(VObjectIterator *i);

-

-extern DLLEXPORT(const char*) lookupStr(const char *s);

-extern DLLEXPORT(void) cleanStrTbl();

-

-extern DLLEXPORT(void) cleanVObject(VObject *o);

-extern DLLEXPORT(void) cleanVObjects(VObject *list);

-

-extern DLLEXPORT(const char*) lookupProp(const char* str);

-extern DLLEXPORT(const char*) lookupProp_(const char* str);

-

-extern DLLEXPORT(void) writeVObjectToFile(char *fname, VObject *o);

-extern DLLEXPORT(void) writeVObjectsToFile(char *fname, VObject *list);

-

-extern DLLEXPORT(int) vObjectValueType(VObject *o);

-

-/* return type of vObjectValueType: */

-        #define VCVT_NOVALUE0

-        /* if the VObject has no value associated with it. */

-        #define VCVT_STRINGZ1

-        /* if the VObject has value set by setVObjectStringZValue. */

-        #define VCVT_UINT       2

-        /* if the VObject has value set by setVObjectIntegerValue. */

-        #define VCVT_ULONG             3

-        /* if the VObject has value set by setVObjectLongValue. */

-        #define VCVT_RAW        4

-        /* if the VObject has value set by setVObjectAnyValue. */

-        #define VCVT_VOBJECT5

-        /* if the VObject has value set by setVObjectVObjectValue. */

-

-extern const char** fieldedProp;

-

-/***************************************************

- * The methods below are implemented in vcc.c (generated from vcc.y )

- ***************************************************/

-

-/* NOTE regarding printVObject and writeVObject

-

-The functions below are not exported from the DLL because they

-take a FILE* as a parameter, which cannot be passed across a DLL

-interface (at least that is my experience). Instead you can use

-their companion functions which take file names or pointers

-to memory. However, if you are linking this code into

-your build directly then you may find them a more convenient API

-and you can go ahead and use them. If you try to use them with

-the DLL LIB you will get a link error.

-*/

-extern void writeVObject(FILE *fp, VObject *o);

-

-

-

-typedef void (*MimeErrorHandler)(char *);

-

-extern DLLEXPORT(void) registerMimeErrorHandler(MimeErrorHandler);

-

-extern DLLEXPORT(VObject*) Parse_MIME(const char *input, unsigned long len);

-extern DLLEXPORT(VObject*) Parse_MIME_FromFileName(char* fname);

-

-

-/* NOTE regarding Parse_MIME_FromFile

-The function above, Parse_MIME_FromFile, comes in two flavors,

-neither of which is exported from the DLL. Each version takes

-a CFile or FILE* as a parameter, neither of which can be

-passed across a DLL interface (at least that is my experience).

-If you are linking this code into your build directly then

-you may find them a more convenient API that the other flavors

-that take a file name. If you use them with the DLL LIB you

-will get a link error.

-*/

-

-

-#if INCLUDEMFC

-extern VObject* Parse_MIME_FromFile(CFile *file);

-#else

-extern VObject* Parse_MIME_FromFile(FILE *file);

-#endif

-

-extern DLLEXPORT(const char *) vObjectTypeInfo(VObject *o);

-

-

-#endif /* __VOBJECT_H__ */

-

-

+/***************************************************************************
+(C) Copyright 1996 Apple Computer, Inc., AT&T Corp., International
+Business Machines Corporation and Siemens Rolm Communications Inc.
+
+For purposes of this license notice, the term Licensors shall mean,
+collectively, Apple Computer, Inc., AT&T Corp., International
+Business Machines Corporation and Siemens Rolm Communications Inc.
+The term Licensor shall mean any of the Licensors.
+
+Subject to acceptance of the following conditions, permission is hereby
+granted by Licensors without the need for written agreement and without
+license or royalty fees, to use, copy, modify and distribute this
+software for any purpose.
+
+The above copyright notice and the following four paragraphs must be
+reproduced in all copies of this software and any software including
+this software.
+
+THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS AND NO LICENSOR SHALL HAVE
+ANY OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS OR
+MODIFICATIONS.
+
+IN NO EVENT SHALL ANY LICENSOR BE LIABLE TO ANY PARTY FOR DIRECT,
+INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES OR LOST PROFITS ARISING OUT
+OF THE USE OF THIS SOFTWARE EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
+DAMAGE.
+
+EACH LICENSOR SPECIFICALLY DISCLAIMS ANY WARRANTIES, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO ANY WARRANTY OF NONINFRINGEMENT OR THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.
+
+The software is provided with RESTRICTED RIGHTS.  Use, duplication, or
+disclosure by the government are subject to restrictions set forth in
+DFARS 252.227-7013 or 48 CFR 52.227-19, as applicable.
+
+***************************************************************************/
+
+/*
+
+The vCard/vCalendar C interface is implemented in the set
+of files as follows:
+
+vcc.y, yacc source, and vcc.c, the yacc output you will use
+implements the core parser
+
+vobject.c implements an API that insulates the caller from
+the parser and changes in the vCard/vCalendar BNF
+
+port.h defines compilation environment dependent stuff
+
+vcc.h and vobject.h are header files for their .c counterparts
+
+vcaltmp.h and vcaltmp.c implement vCalendar "macro" functions
+which you may find useful.
+
+test.c is a standalone test driver that exercises some of
+the features of the APIs provided. Invoke test.exe on a
+VCARD/VCALENDAR input text file and you will see the pretty
+print output of the internal representation (this pretty print
+output should give you a good idea of how the internal
+representation looks like -- there is one such output in the
+following too). Also, a file with the .out suffix is generated
+to show that the internal representation can be written back
+in the original text format.
+
+For more information on this API see the readme.txt file
+which accompanied this distribution.
+
+  Also visit:
+
+                http://www.versit.com
+                http://www.ralden.com
+
+*/
+
+// No tr() anywhere in this file
+
+
+#ifndef __VOBJECT_H__
+#define __VOBJECT_H__ 1
+
+#include <qstring.h>
+
+        #define         vCardClipboardFormat    "+//ISBN 1-887687-00-9::versit::PDI//vCard"
+        #define         vCalendarClipboardFormat"+//ISBN 1-887687-00-9::versit::PDI//vCalendar"
+
+/* The above strings vCardClipboardFormat and vCalendarClipboardFormat
+are globally unique IDs which can be used to generate clipboard format
+ID's as per the requirements of a specific platform. For example, in
+Windows they are used as the parameter in a call to RegisterClipboardFormat.
+For example:
+
+  CLIPFORMAT foo = RegisterClipboardFormat(vCardClipboardFormat);
+
+*/
+
+        #define vCardMimeType   "text/x-vCard"
+        #define vCalendarMimeType"text/x-vCalendar"
+
+#undef DLLEXPORT
+#include <qglobal.h>
+#if defined(Q_WS_WIN)
+#define DLLEXPORT(t)   __declspec(dllexport) t
+#else
+#define DLLEXPORT(t)   t
+#endif
+
+#ifndef FALSE
+        #define FALSE0
+#endif
+#ifndef TRUE
+        #define TRUE1
+#endif
+
+#include <stdlib.h>
+#include <stdio.h>
+
+
+        #define VC7bitProp                      "7BIT"
+        #define VC8bitProp                      "8BIT"
+        #define VCAAlarmProp            "AALARM"
+        #define VCAdditionalNamesProp"ADDN"
+        #define VCAdrProp                       "ADR"
+        #define VCAgentProp                     "AGENT"
+        #define VCAIFFProp                      "AIFF"
+        #define VCAOLProp                       "AOL"
+        #define VCAppleLinkProp                 "APPLELINK"
+        #define VCAttachProp            "ATTACH"
+        #define VCAttendeeProp          "ATTENDEE"
+        #define VCATTMailProp           "ATTMAIL"
+        #define VCAudioContentProp      "AUDIOCONTENT"
+        #define VCAVIProp                       "AVI"
+        #define VCBase64Prop            "BASE64"
+        #define VCBBSProp                       "BBS"
+        #define VCBirthDateProp                 "BDAY"
+        #define VCBMPProp                       "BMP"
+        #define VCBodyProp                      "BODY"
+        #define VCBusinessRoleProp      "ROLE"
+        #define VCCalProp                       "VCALENDAR"
+        #define VCCaptionProp           "CAP"
+        #define VCCardProp                      "VCARD"
+        #define VCCarProp                       "CAR"
+        #define VCCategoriesProp        "CATEGORIES"
+        #define VCCellularProp          "CELL"
+        #define VCCGMProp                       "CGM"
+        #define VCCharSetProp           "CHARSET"
+        #define VCCIDProp                       "CID"
+        #define VCCISProp                       "CIS"
+        #define VCCityProp                      "L"
+        #define VCClassProp                     "CLASS"
+        #define VCCommentProp           "NOTE"
+        #define VCCompletedProp                 "COMPLETED"
+        #define VCContentIDProp                 "CONTENT-ID"
+        #define VCCountryNameProp       "C"
+        #define VCDAlarmProp            "DALARM"
+        #define VCDataSizeProp          "DATASIZE"
+        #define VCDayLightProp          "DAYLIGHT"
+        #define VCDCreatedProp          "DCREATED"
+#define VCDeliveryLabelProp     "LABEL"
+        #define VCDescriptionProp       "DESCRIPTION"
+        #define VCDIBProp                       "DIB"
+        #define VCDisplayStringProp     "DISPLAYSTRING"
+        #define VCDomesticProp          "DOM"
+        #define VCDTendProp                     "DTEND"
+        #define VCDTstartProp           "DTSTART"
+        #define VCDueProp                       "DUE"
+        #define VCEmailAddressProp      "EMAIL"
+        #define VCEncodingProp          "ENCODING"
+        #define VCEndProp                       "END"
+        #define VCEventProp                     "VEVENT"
+        #define VCEWorldProp            "EWORLD"
+        #define VCExNumProp                     "EXNUM"
+        #define VCExpDateProp           "EXDATE"
+        #define VCExpectProp            "EXPECT"
+        #define VCExtAddressProp        "EXT ADD"
+        #define VCFamilyNameProp        "F"
+        #define VCFaxProp                       "FAX"
+        #define VCFullNameProp          "FN"
+        #define VCGeoProp                       "GEO"
+        #define VCGeoLocationProp       "GEO"
+        #define VCGIFProp                       "GIF"
+        #define VCGivenNameProp                 "G"
+        #define VCGroupingProp          "Grouping"
+        #define VCHomeProp                      "HOME"
+        #define VCIBMMailProp           "IBMMail"
+        #define VCInlineProp            "INLINE"
+        #define VCInternationalProp     "INTL"
+        #define VCInternetProp          "INTERNET"
+        #define VCISDNProp                      "ISDN"
+        #define VCJPEGProp                      "JPEG"
+        #define VCLanguageProp          "LANG"
+        #define VCLastModifiedProp      "LAST-MODIFIED"
+        #define VCLastRevisedProp       "REV"
+        #define VCLocationProp          "LOCATION"
+        #define VCLogoProp                      "LOGO"
+        #define VCMailerProp            "MAILER"
+        #define VCMAlarmProp            "MALARM"
+        #define VCMCIMailProp           "MCIMAIL"
+        #define VCMessageProp           "MSG"
+        #define VCMETProp                       "MET"
+        #define VCModemProp                     "MODEM"
+        #define VCMPEG2Prop                     "MPEG2"
+        #define VCMPEGProp                      "MPEG"
+        #define VCMSNProp                       "MSN"
+        #define VCNamePrefixesProp      "NPRE"
+        #define VCNameProp                      "N"
+        #define VCNameSuffixesProp      "NSUF"
+        #define VCNoteProp                      "NOTE"
+        #define VCOrgNameProp           "ORGNAME"
+        #define VCOrgProp                       "ORG"
+        #define VCOrgUnit2Prop          "OUN2"
+        #define VCOrgUnit3Prop          "OUN3"
+        #define VCOrgUnit4Prop          "OUN4"
+        #define VCOrgUnitProp           "OUN"
+        #define VCPagerProp                     "PAGER"
+        #define VCPAlarmProp            "PALARM"
+        #define VCParcelProp            "PARCEL"
+        #define VCPartProp                      "PART"
+        #define VCPCMProp                       "PCM"
+        #define VCPDFProp                       "PDF"
+        #define VCPGPProp                       "PGP"
+        #define VCPhotoProp                     "PHOTO"
+        #define VCPICTProp                      "PICT"
+        #define VCPMBProp                       "PMB"
+        #define VCPostalBoxProp                 "BOX"
+        #define VCPostalCodeProp        "PC"
+        #define VCPostalProp            "POSTAL"
+        #define VCPowerShareProp        "POWERSHARE"
+        #define VCPreferredProp                 "PREF"
+        #define VCPriorityProp          "PRIORITY"
+        #define VCProcedureNameProp     "PROCEDURENAME"
+        #define VCProdIdProp            "PRODID"
+        #define VCProdigyProp           "PRODIGY"
+        #define VCPronunciationProp     "SOUND"
+        #define VCPSProp                        "PS"
+        #define VCPublicKeyProp                 "KEY"
+        #define VCQPProp                        "QP"
+        #define VCQuickTimeProp                 "QTIME"
+        #define VCQuotedPrintableProp"QUOTED-PRINTABLE"
+        #define VCRDateProp                     "RDATE"
+        #define VCRegionProp            "R"
+        #define VCRelatedToProp                 "RELATED-TO"
+        #define VCRepeatCountProp       "REPEATCOUNT"
+        #define VCResourcesProp                 "RESOURCES"
+        #define VCRNumProp                      "RNUM"
+        #define VCRoleProp                      "ROLE"
+        #define VCRRuleProp                     "RRULE"
+        #define VCRSVPProp                      "RSVP"
+        #define VCRunTimeProp           "RUNTIME"
+        #define VCSequenceProp          "SEQUENCE"
+        #define VCSnoozeTimeProp        "SNOOZETIME"
+        #define VCStartProp                     "START"
+        #define VCStatusProp            "STATUS"
+        #define VCStreetAddressProp     "STREET"
+        #define VCSubTypeProp           "SUBTYPE"
+        #define VCSummaryProp           "SUMMARY"
+        #define VCTelephoneProp                 "TEL"
+        #define VCTIFFProp                      "TIFF"
+        #define VCTimeZoneProp          "TZ"
+        #define VCTitleProp                     "TITLE"
+        #define VCTLXProp                       "TLX"
+        #define VCTodoProp                      "VTODO"
+        #define VCTranspProp            "TRANSP"
+        #define VCUniqueStringProp      "UID"
+        #define VCURLProp                       "URL"
+        #define VCURLValueProp          "URLVAL"
+        #define VCValueProp                     "VALUE"
+        #define VCVersionProp           "VERSION"
+        #define VCVideoProp                     "VIDEO"
+        #define VCVoiceProp                     "VOICE"
+        #define VCWAVEProp                      "WAVE"
+        #define VCWMFProp                       "WMF"
+        #define VCWorkProp                      "WORK"
+        #define VCX400Prop                      "X400"
+        #define VCX509Prop                      "X509"
+        #define VCXRuleProp                     "XRULE"
+
+
+typedef struct VObject VObject;
+
+typedef struct VObjectIterator {
+    VObject* start;
+    VObject* next;
+    } VObjectIterator;
+
+extern DLLEXPORT(VObject*) newVObject(const char *id);
+extern DLLEXPORT(void) deleteVObject(VObject *p);
+extern DLLEXPORT(char*) dupStr(const char *s, unsigned int size);
+extern DLLEXPORT(void) deleteStr(const char *p);
+extern DLLEXPORT(void) unUseStr(const char *s);
+
+extern DLLEXPORT(void) setVObjectName(VObject *o, const char* id);
+extern DLLEXPORT(void) setVObjectStringZValue(VObject *o, const char *s);
+extern DLLEXPORT(void) setVObjectStringZValue_(VObject *o, const char *s);
+extern DLLEXPORT(void) setVObjectIntegerValue(VObject *o, unsigned int i);
+extern DLLEXPORT(void) setVObjectLongValue(VObject *o, unsigned long l);
+extern DLLEXPORT(void) setVObjectAnyValue(VObject *o, void *t);
+extern DLLEXPORT(VObject*) setValueWithSize(VObject *prop, void *val, unsigned int size);
+extern DLLEXPORT(VObject*) setValueWithSize_(VObject *prop, void *val, unsigned int size);
+
+extern DLLEXPORT(const char*) vObjectName(VObject *o);
+extern DLLEXPORT(const char*) vObjectStringZValue(VObject *o);
+extern DLLEXPORT(unsigned int) vObjectIntegerValue(VObject *o);
+extern DLLEXPORT(unsigned long) vObjectLongValue(VObject *o);
+extern DLLEXPORT(void*) vObjectAnyValue(VObject *o);
+extern DLLEXPORT(VObject*) vObjectVObjectValue(VObject *o);
+extern DLLEXPORT(void) setVObjectVObjectValue(VObject *o, VObject *p);
+
+extern DLLEXPORT(VObject*) addVObjectProp(VObject *o, VObject *p);
+extern DLLEXPORT(VObject*) addProp(VObject *o, const char *id);
+extern DLLEXPORT(VObject*) addProp_(VObject *o, const char *id);
+extern DLLEXPORT(VObject*) addPropValue(VObject *o, const char *p, const char *v);
+extern DLLEXPORT(VObject*) addPropSizedValue_(VObject *o, const char *p, const char *v, unsigned int size);
+extern DLLEXPORT(VObject*) addPropSizedValue(VObject *o, const char *p, const char *v, unsigned int size);
+extern DLLEXPORT(VObject*) addGroup(VObject *o, const char *g);
+extern DLLEXPORT(void) addList(VObject **o, VObject *p);
+
+extern DLLEXPORT(VObject*) isAPropertyOf(VObject *o, const char *id);
+
+extern DLLEXPORT(VObject*) nextVObjectInList(VObject *o);
+extern DLLEXPORT(void) initPropIterator(VObjectIterator *i, VObject *o);
+extern DLLEXPORT(int) moreIteration(VObjectIterator *i);
+extern DLLEXPORT(VObject*) nextVObject(VObjectIterator *i);
+
+extern DLLEXPORT(const char*) lookupStr(const char *s);
+extern DLLEXPORT(void) cleanStrTbl();
+
+extern DLLEXPORT(void) cleanVObject(VObject *o);
+extern DLLEXPORT(void) cleanVObjects(VObject *list);
+
+extern DLLEXPORT(const char*) lookupProp(const char* str);
+extern DLLEXPORT(const char*) lookupProp_(const char* str);
+
+extern DLLEXPORT(void) writeVObjectToFile(char *fname, VObject *o);
+extern DLLEXPORT(void) writeVObjectsToFile(char *fname, VObject *list);
+
+extern DLLEXPORT(int) vObjectValueType(VObject *o);
+
+/* return type of vObjectValueType: */
+        #define VCVT_NOVALUE0
+        /* if the VObject has no value associated with it. */
+        #define VCVT_STRINGZ1
+        /* if the VObject has value set by setVObjectStringZValue. */
+        #define VCVT_UINT       2
+        /* if the VObject has value set by setVObjectIntegerValue. */
+        #define VCVT_ULONG             3
+        /* if the VObject has value set by setVObjectLongValue. */
+        #define VCVT_RAW        4
+        /* if the VObject has value set by setVObjectAnyValue. */
+        #define VCVT_VOBJECT5
+        /* if the VObject has value set by setVObjectVObjectValue. */
+
+extern const char** fieldedProp;
+
+/***************************************************
+ * The methods below are implemented in vcc.c (generated from vcc.y )
+ ***************************************************/
+
+/* NOTE regarding printVObject and writeVObject
+
+The functions below are not exported from the DLL because they
+take a FILE* as a parameter, which cannot be passed across a DLL
+interface (at least that is my experience). Instead you can use
+their companion functions which take file names or pointers
+to memory. However, if you are linking this code into
+your build directly then you may find them a more convenient API
+and you can go ahead and use them. If you try to use them with
+the DLL LIB you will get a link error.
+*/
+extern void writeVObject(FILE *fp, VObject *o);
+
+
+
+typedef void (*MimeErrorHandler)(char *);
+
+extern DLLEXPORT(void) registerMimeErrorHandler(MimeErrorHandler);
+
+extern DLLEXPORT(VObject*) Parse_MIME(const char *input, unsigned long len);
+extern DLLEXPORT(VObject*) Parse_MIME_FromFileName(char* fname);
+
+
+/* NOTE regarding Parse_MIME_FromFile
+The function above, Parse_MIME_FromFile, comes in two flavors,
+neither of which is exported from the DLL. Each version takes
+a CFile or FILE* as a parameter, neither of which can be
+passed across a DLL interface (at least that is my experience).
+If you are linking this code into your build directly then
+you may find them a more convenient API that the other flavors
+that take a file name. If you use them with the DLL LIB you
+will get a link error.
+*/
+
+
+#if INCLUDEMFC
+extern VObject* Parse_MIME_FromFile(CFile *file);
+#else
+extern VObject* Parse_MIME_FromFile(FILE *file);
+#endif
+
+extern DLLEXPORT(const char *) vObjectTypeInfo(VObject *o);
+
+
+#endif /* __VOBJECT_H__ */
+
+