head	1.10;
access;
symbols
	camas_1_2_21:1.1.2.4
	camas_1_2_20:1.1.2.4
	camas_1_2_19:1.1.2.4
	camas_1_2_18:1.1.2.4
	camas_1_2_17:1.1.2.3
	camas_1_2:1.1.0.2;
locks; strict;
comment	@# @;


1.10
date	2004.03.29.12.37.34;	author vida;	state Exp;
branches;
next	1.9;

1.9
date	2004.03.28.14.55.35;	author vida;	state Exp;
branches;
next	1.8;

1.8
date	2004.03.26.19.16.36;	author vida;	state Exp;
branches;
next	1.7;

1.7
date	2004.03.18.13.11.36;	author vida;	state Exp;
branches;
next	1.6;

1.6
date	2004.02.13.16.42.45;	author vida;	state Exp;
branches;
next	1.5;

1.5
date	2004.02.10.15.13.04;	author vida;	state Exp;
branches;
next	1.4;

1.4
date	2004.01.30.00.00.28;	author vida;	state Exp;
branches;
next	1.3;

1.3
date	2004.01.21.12.17.08;	author vida;	state Exp;
branches;
next	1.2;

1.2
date	2004.01.21.12.15.15;	author vida;	state Exp;
branches;
next	1.1;

1.1
date	2004.01.13.13.11.35;	author vida;	state Exp;
branches
	1.1.2.1;
next	;

1.1.2.1
date	2004.01.21.12.12.24;	author vida;	state Exp;
branches;
next	1.1.2.2;

1.1.2.2
date	2004.01.21.12.16.29;	author vida;	state Exp;
branches;
next	1.1.2.3;

1.1.2.3
date	2004.02.10.15.12.21;	author vida;	state Exp;
branches;
next	1.1.2.4;

1.1.2.4
date	2004.02.13.16.41.41;	author vida;	state Exp;
branches;
next	;


desc
@@


1.10
log
@All do_output_tag are now converted to <emit> except one in the readmail
screen but it's not a big issue since it doesn't contain special character.
Parsing is also much faster.
@
text
@$Id: UPGRADE,v 1.9 2004/03/28 14:55:35 vida Exp $

Notes on upgrading from Camas 1.2 to Camas 1.3
==============================================
o The IMHO screens and tags are removed since
  they contain bloated code and Camas tags and entities are
  a much better alternative.
  
o Modifications in layouts:
  
  1) General (applied to all screens)
  . The do_output_tag syntax with # has been replaced by entities and emit
  . The navbar container syntax has changed a little, see the default layout
  . camas_link in camas_mailbox is now camas_href_mailboxlist and require
    mailboxnumber="&camas_emit.mailboxnumber;". Same goes for the 
    camas_mailbox, camas_folder and camas_specialfolder containers.
  . &camasmsg.layout_www; is used only for fetching file from HTTP. If you want
    to fetch files from your layout, use &camasmsg.layout_file;. The main 
    consequence of this is that if you use
    <insert file="&camasmsg.layout_www;blabla"> you need to convert to
    <insert file="&camasmsg.layout_file;blabla">

  2) Mailindex specific
  . camas_title is not needed anymore
  . You must add currentmail="&camas_emit.currentmail;" to 
    camas_input_selectmail and camas_href in the mail list.

  3) Folderlist specific 
  . The camas_title container is removed and do_output_tag variables are
    replaced by camasmsg entities. The entities keep the same name as the 
    do_output_tag variables
  . camas_href now requires 
    mailboxnumber="&camas_emit.mailboxnumber;"

  4) Compose specific
  . camas_input_selectattachment now requires the
    attachmentid="&camas_emit.attachmentid;" argument

  5) Addressbook specific
   . You need to provide currentaddres="&camas_emit.mail;" to camas_href and
     camas_input_selectaddress

  6) Searchmail specific
    . camas_searchfield is now a tag and doesn't use do_output_tag 
      variables. It accepts the removefields argument which contains a comma
      separated value of fields to remove from the list.
    . camas_searchmboxes is now an emit source, the do_output_tag variable
      is replaced by the name entity. camas_searchmbox is not a container
      anymore but a tag and you must give it the foldername="&camas_emit.name;"
      argument. See the default layout for detail.

  7) Filterbook specific
    . camas_title is not needed anymore. 
    . do_output_tag variables are replaced
      by camasmsg entities. #field# is &camasmsg.indexfilterfield;, 
      #expression# is &camas.msg. indexfilterexpression and #folder# is 
      &camasmsg.filterfolder;.
    . camas_href requires filtercount="&camas_emit.filtercount;"

  8) Files specific
    . camas_title is removed and do_output_tag variables are replaced
      by their camasmsg entities equivalent.

  9) Importaddress2 specific
    . select_camas_fields is a tag and requires the
      column_number="&camas_emit.column_number;" 
      user_field="&camas_emit.user_field;" arguments.

Notes on upgrading from Camas 1.0 or IMHO to Camas 1.2
======================================================

Camas 1.2 has a lot of differences with previous version.
While we tried to keep the maximum compatbility there are
some steps you will need to do in order to upgrade:

o The Incoming mail server (IMAP) is not anymore in
  Camas main module but in one of the Auth module you
  use (by default it is Camas Auth Basic)

o The layout sub-system has been completely re-written. 
  Your old layouts will be keep by default as well as the
  default blue one. If you want to try the new default layout,
  remove the module named "Camas: Default IMHO layout" and
  restart the server.
  If you don't use the Camas 1.0 or IMHO layouts, you can
  safely remove the modules "Camas: IMHO Screens" and
  "Camas: IMHO Tags".

o The location of the preferences folder has changed. 
  It is now in the "Camas: Preferences IMAP" module 
  instead of the Camas main module.

o For performances reason the size of the folders is not 
  fetched at startup but is either:
    - Set when the user goes in the folder
    - Set by the background IMAP cache feeder at startup if
    you enabled this option

o The quota mecanism has been removed from the Auth modules since
  Camas now support quota from the IMAP server which is a better
  way to support quotas. A side effect is that users of Camas Auth module
  must set again their basedn and filter in Webmail names

o Configuration variable Camas Main module -> Outgoing mail -> Sent message
  notification is gone in flavor of Camas Main module -> Misc ->
  User interface: Display SMTP confirmations to user.
 
o Preferences directory setting in Camas Main module -> User preferences ->
  User preferences directory is now in the Preferences Files module.
@


1.9
log
@Forgot some of them.
@
text
@d1 1
a1 1
$Id: UPGRADE,v 1.8 2004/03/26 19:16:36 vida Exp $
d46 22
a67 1
      separated value of field to remove from the list.
@


1.8
log
@Upgrading notes
@
text
@d1 1
a1 1
$Id: UPGRADE,v 1.7 2004/03/18 13:11:36 vida Exp $
d15 2
a16 1
    mailboxnumber="&camas_emit.mailboxnumber;"
d25 2
@


1.7
log
@Changed the setting for preferences directory.
@
text
@d1 1
a1 1
$Id: UPGRADE,v 1.6 2004/02/13 16:42:45 vida Exp $
d8 36
@


1.6
log
@One more Upgrade note
@
text
@d1 1
a1 1
$Id: UPGRADE,v 1.5 2004/02/10 15:13:04 vida Exp $
d47 3
@


1.5
log
@- Configuration variable Camas Main module -> Outgoing mail -> Sent message
  notification is gone in flavor of Camas Main module -> Misc ->
  User interface: Display SMTP confirmations to user.

- No need to have Features -> Features -> Mailboxes set to Yes to get imhoprefs
  directory created.
@
text
@d1 1
a1 1
$Id: UPGRADE,v 1.4 2004/01/30 00:00:28 vida Exp $
d41 2
a42 1
  way to support quotas.
@


1.4
log
@. Added CVS mark
. Added a note in README about servers we tested.
@
text
@d1 1
a1 1
$Id$
d42 4
@


1.3
log
@typo.
@
text
@d1 2
@


1.2
log
@Upgrading notes for 1.3
@
text
@d39 1
a39 1
  was to support quotas.
@


1.1
log
@Upgrade notes.
@
text
@d1 6
d37 3
@


1.1.2.1
log
@More upgrading notes.
@
text
@a30 3
o The quota mecanism has been removed from the Auth modules since
  Camas now support quota from the IMAP server which is a better
  was to support quotas.
@


1.1.2.2
log
@typo.
@
text
@d33 1
a33 1
  way to support quotas.
@


1.1.2.3
log
@- Configuration variable Camas Main module -> Outgoing mail -> Sent message
  notification is gone in flavor of Camas Main module -> Misc ->
  User interface: Display SMTP confirmations to user.

- No need to have Features -> Features -> Mailboxes set to Yes to get imhoprefs
  directory created.
@
text
@a33 4

o Configuration variable Camas Main module -> Outgoing mail -> Sent message
  notification is gone in flavor of Camas Main module -> Misc ->
  User interface: Display SMTP confirmations to user.
@


1.1.2.4
log
@One more upgrade note.
@
text
@d33 1
a33 2
  way to support quotas. A side effect is that users of Camas Auth module
  must set again their basedn and filter in Webmail names
@


