ATTENTION file for Gcal. Table of incompatibilities: * Gcal-3.00 - By reason of implementing the optional format instruction which can be used by many special texts in the text part of a Gcal resource file line now, some of these special texts do not exist in this style anymore in Gcal-3.00 or newer. Here comes a complete list of all special texts which are changed: Symbolic name Old-style New-style %complete weekday name `%o' == `%K' %3-letter weekday name `%O' == `%>3#K' %2-letter weekday name `%K' == `%>2#K' %weekday number (Mon=1...Sun=7) `%S' == `%W' %weekday number (Mon=1...Sun=7) ONS `%I' == `%>1&*W' %weekday number (Mon=0...Sun=6) ONS `%J' == `%>1&*E' %weekday number (Sun=1...Sat=7) `%(' == `%I' %weekday number (Sun=1...Sat=7) ONS `%<' == `%>1&*I' %weekday number (Sun=0...Sat=6) `%)' == `%J' %weekday number (Sun=0...Sat=6) ONS `%>' == `%>1&*J' %weekday number (Mon=1...Sun=7) FLX `%[' == `%S' %weekday number (Mon=1...Sun=7) FLX ONS `%{' == `%>1&*S' %weekday number (Mon=0...Sun=6) FLX `%]' == `%T' %weekday number (Mon=0...Sun=6) FLX ONS `%}' == `%>1&*T' %day-of-year number `%+' == `%N' %day-of-year number +LZ `%*' == `%>03*N' %day-of-year number ONS `%&' == `%>1&*N' %day-of-year number +LZ ONS `%#' == `%>03&*N' %day number +LZ `%N' == `%>02*D' %day number ONS `%s' == `%>1&*D' %day number +LZ ONS `%u' == `%>02&*D' %complete month name `%M' == `%U' %3-letter month name `%T' == `%>3#U' %month number `%U' == `%M' %month number +LZ `%W' == `%>02*M' %month number ONS `%z' == `%>1&*M' %month number +LZ ONS `%Z' == `%>02&*M' %complete year number +LZ `%=' == `%>04*Y' %age value (birthday) number `%b' == `%B' %age value (birthday) number ONS `%B' == `%>1&*B' %moonphase `%-' == `%O' %moonphase +LZ `%_' == `%>03*O' %moonphase text graphics image `%:' == `%Z' Legend: +LZ == With leading zero(es) FLX == Flexible starting day of week (`-s N' option) ONS == With Ordinal Number suffix Using these old-style special texts will not produce the wanted results if you use this version of the Gcal program. You can find a `v2x2v300' AWK respectively Perl script in the `data/scripts' directory which converts old-style resource files into the style used by Gcal-3.00 or newer. If you have Gcal version 2.20 or version 2.40 resource files and you want to use them with Gcal version 3.00, you first have to convert them manually into the Gcal-3.00 style by processing them using the `v2x2v300' AWK respectively Perl scripts, for example: $ awk -f v2x2v300.awk FILE-OLD.rc > FILE-v300.rc or $ perl v2x2v300.pl FILE-OLD.rc > FILE-v300.rc It is very possible that the conversion done by using the `v2x2v300' AWK respectively Perl scripts is not sufficient, i.e. the resulting file contains unwanted Gcal special texts or some of the required Gcal special texts are crippled or protected by a `\' character. In this case, you have to edit the resulting file manually to correct the broken text. Sorry! - By reason of implementing the optional format instruction which can be used by many date format texts now, some format elements which can be individually specified by the `--date-format' option are obsolete now and are changed to: Symbolic name Old-style New-style %day number `%d' == `%>02*D' %day number +LS `%D' == `%>2*D' %day number +LZ ONS `%u' == `%02&*D' %day number +LS ONS `%U' == `%>2&*D' %complete month name `%B' == `%U' %3-letter month name `%b' == `%<3#U' %month number +LZ `%m' == `%>02*M' %month number +LS `%M' == `%>2*M' %complete year number +LZ `%y' == `%>04*Y' %complete year number +LS `%Y' == `%>4*Y' %last-2-digit year number +LZ `%z' == `%>02#Y' %last-2-digit year number +LS `%Z' == `%>2#Y' %complete weekday name `%A' == `%K' %3-letter weekday name `%W' == `%<3#K' %2-letter weekday name `%w' == `%<2#K' Legend: +LZ With leading zero(es) +LS == With leading space(s) ONS == With Ordinal Number suffix Using these old-style date format texts will not produce the wanted results if you use this version of the Gcal program. - By reason of implementing the optional format instruction which can be used by many format elements in the date format text now, the burned-in default country specific date formats for `DE == Germany', `US == U.S.A.' and `GB == Great Britain', which can be specified by the `--date-format' option are obsolete now and are changed to: CC Old-style New-style DE `%w, %1%D%2 %b %y' == `%<2#K, %1%>2*D%2 %<3#U %>04*Y' US `%W, %b %1%U%2 %y' == `%<3#K, %<3#U %1%>2&*D%2 %>04*Y' GB `%W, %1%U%2 %b %y' == `%<3#K, %1%>2&*D%2 %<3#U %>04*Y' Using these old-style date format texts will not produce the wanted results if you use this version of the Gcal program. - The `%t[12|24]' special text respected by former versions of the Gcal program in the text part of a resource file line does not exist in this style anymore in Gcal-3.00 or newer. Using above mentioned old-style special text will not produce the wanted results if you use this version of the Gcal program. Use `%t[*][[+|-]MMMM|HH:[MM]]' instead! * Gcal-2.20 The `%s[DATE]' ("starting date" of event) and `%e[DATE]' ("ending date" of event) special texts respected by former versions of the Gcal program in the text part of a Gcal resource file line do not exist in this style anymore in Gcal-2.20 or newer. Using above mentioned old-style special texts will not produce the wanted results if you use this version of the Gcal program. Use `%i[STARTING_DATE][#[ENDING_DATE]]' instead! You can find a `old2v220' AWK respectively Perl script in the `data/scripts' directory which converts old-style resource files into the style used by Gcal-2.20 or newer. This script will be used automatically when running the `install' target of the `data/Makefile' in case the enclosed appointment respecitively reminder files (likewise the `~/.gcalrc' file) of the distribution are already installed. In case the `~/.gcalrc' file is processed like this, a copy of its old contents by the name `~/.gcalrc.YYYYMMDDHHMM' will be created, too. Notice that your Gcal resource files are not changed if the `old2v220' scripts do not detect any old-style _starting date_ and _ending date_ of event special texts! **** WARNING **** The `old2v220' scripts are unable to manage `%s[DATE]' and `%e[DATE]' special texts correctly if all or parts of the DATE component is/are assembled by using Gcal's text variable mechanism! If you have other _old_, pre Gcal version 2.20 resource files, you first have to convert them manually into the Gcal-2.20 style by processing them using the `old2v220' AWK respectively Perl scripts, for example: $ awk -f old2v220.awk FILE-OLD.rc > FILE-v220.rc or $ perl old2v220.pl FILE-OLD.rc > FILE-v220.rc