1 rizwank 1.1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3.2//EN">
2 <html>
3 <head>
4 <title>jscalendar release notes</title>
5
6 <style type="text/css">
7 h1 { border-bottom: 1px solid #000; }
8 h2 { border-bottom: 1px solid #444; }
9 ul li { margin-top: 0.5em; margin-bottom: 0.5em; }
10 </style>
11 </head>
12
13 <body>
14 <h1>jscalendar release notes</h1>
15
16 <p>This release compiled at Wednesday, 5 Nov 2003 (19:30).</p>
17
18 <h2>0.9.5</h2>
19
20 <p>
21 This release's primary goal is to fix a wrong license statement which
22 rizwank 1.1 can be found in some files from 0.9.4. For instance in README or
23 calendar.js, the statement was that the code is distributed under the
24 GNU GPL; that's because I had plans to change the license, then
25 changed my mind but unfortunately I committed files so. I am sorry
26 for this inconvenience, please use the latest (0.9.5) release which is
27 fully covered by LGPL.
28 </p>
29
30 <p>Other changes:</p>
31
32 <ul>
33
34 <li>
35 <b>Fixed</b> an annoying bug that prevented the calendar to display
36 correctly when it was configured for an input field inside a
37 <b>scrolling area</b>. <b>Many thanks</b> to Ian Barrack (<a
38 href="http://www.simban.com">Simban.com</a>) who pointed it up and
39 donated quote some money for the Calendar project!
40 </li>
41
42 <li>
43 rizwank 1.1 All examples use UTF-8 now; the translations may not be all
44 up-to-date, but I <strong>strongly</strong> suggest everyone to use
45 UTF-8; other encodings are a plain mess. So far I know for sure
46 that Romanian translation will work with UTF-8 and <em>not
47 anymore</em> with ISO-8859-2. Other translations are probably
48 usable under UTF-8, but if your preferred language isn't... ;-)
49 please make it and send it to me for inclusion.
50 </li>
51
52 <li>
53 Fixed small bug in the documentation (one footnote didn't appear
54 where it should have).
55 </li>
56
57 <li>
58 Updated translations: DE, ES, HU, IT, RO. Thanks to everyone who
59 sent translations!
60 </li>
61
62 </ul>
63
64 rizwank 1.1 <h2>0.9.4</h2>
65
66 <h3>New stuff</h3>
67
68 <ul>
69
70 <li>Supports time selection. Yes. ;-) This work has been largely
71 sponsored by <strong>Himanshukumar Shah</strong> (thank you!). See
72 the docs and example files for details on how to setup.</li>
73
74 <li>Easy to link 2 or more fields by using the new
75 <code>onUpdate</code> parameter of <code>Calendar.setup</code>. This
76 is useful, say, to automatically set a value in a second field based
77 on the value selected in the first field. See the documentation and
78 first sample in <a href="simple-1.html">simple-1.html</a>.</li>
79
80 <li>Other <code>Calendar.setup</code> low-level parameters, for those
81 wanting to have the complete control: <code>onSelect</code> and
82 <code>onClose</code>. The handlers are called when something is
83 selected in the calendar or when the calendar is closed.</li>
84
85 rizwank 1.1 <li>The translation files can optionally include the short day names
86 and the short month names. That's because in some languages, like
87 German, the short form is not the first 3 letters of the entire name
88 but only the first 2. Also in other languages short names can't be
89 as easily derived from the full name by just calling substr, so this
90 patch solves the problem.</li>
91
92 <li>Implemented a nice way to make some dates "special" (look
93 different). Specifically, the <code>setDisabledHandler</code> method
94 was replaced with the more general <code>setDateStatusHandler</code>
95 method (the old one is still available for backwards compatibility but
96 <em>will</em> be removed). More details about this in the
97 documentation. Also see <a href="simple-3.html">simple-3.html</a>
98 for a live sample.</li>
99
100 <li>Date parsing and formatting engine is now rewritten and supports a
101 subset of <code>strftime</code> format specifiers from ANSI C. This
102 makes it possible to use dates like "YYYYMMDD" (the corresponding
103 format for this would be "%Y%m%d"). Details in the documentation.
104 <b>Please note that the new engine is not compatibile with older
105 calendar releases!</b></li>
106 rizwank 1.1
107 <li>Along with the new date parser I workarounded an unpleasant crash
108 that occurred in IE when certain accented characters appeared in the
109 texts. I think German was one of the language with such problems, and
110 the workaround was to use the letter without an accent. Well, now you
111 can translate to whatever you want.</li>
112
113 <li>"Fixes" (I mean, "horrible workarounds") for Konqueror (and
114 hopefully Safari). Unfortunately, this otherwise excellent browser
115 still has some bugs that keep the calendar from working
116 <em>exactly</em> as it should.. But they're going to be fixed,
117 right? ;-)</li>
118
119 <li>CSS themes got pretty much modified too so if you wrote your theme
120 you need to update it. Aside for the time selector support, the CSS
121 themes contain a simple hack that makes the navigation buttons show
122 a little arrow in the lower-right corner which indicates that if one
123 holds the mouse a menu will appear.</li>
124
125 </ul>
126
127 rizwank 1.1 <h3>Translation files</h3>
128
129 <p>The translation files need to be updated in order for the calendar to
130 work properly. Currently the only updated files are calendar-en.js
131 (main file) and calendar-ro.js (well, yes, I am a Romanian ;-).</p>
132
133 <p>Specifically, they need the following:</p>
134
135 <ul>
136
137 <li>Correct date format, according with the new format specifiers
138 introduced in 0.9.4. Details about the available format specifiers
139 in the documentation</li>
140
141 <li>Short day or month names, <em>if required</em>. If they can be
142 derived by taking the first N letters of the full name then a simple
143 Calendar._SDN_len = N or Calendar._SMN_len = N will suffice. If N
144 is 3 then nothing needs to be done as we take it for granted if no
145 other option is offered ;-)</li>
146
147 <li>We have some new texts that shows short usage information as well
148 rizwank 1.1 as copyright information.</li>
149
150 </ul>
151
152 <p>If your favorite language is not there yet, or it is but not updated
153 according to the main calendar-en.js file, then please consider
154 translating calendar-en.js and send the translation back to me so that
155 I include it in the official distribution.</p>
156
157 <h3>Bug status</h3>
158
159 <p>Check <a
160 href="http://sourceforge.net/tracker/?atid=544285&group_id=75569&func=browse">SourceForge</a>,
161 I didn't keep track. However, there were a lot of bugfixes.</p>
162
163 <h2>0.9.3</h2>
164
165 <h3>New stuff</h3>
166
167 <ul>
168
169 rizwank 1.1 <li>Opera 7 compatibility — keyboard navigation is
170 still not available; text selection can't be disabled, leading to an
171 ugly effect when walking through the month/year menus.</li>
172
173 <li>Ability to align the calendar relative to the input field (or any
174 other element). Vertical: top, center, bottom. Horizontal: left,
175 center, right. This is established as a new parameter for
176 <tt>showAtElement</tt>.</li>
177
178 <li>Added <tt>dateClicked</tt> property (boolean). This can be
179 inspected in the "onSelect" handler to determine if a date was
180 really clicked or the user only changed month/year using the menus.
181 You <em>need</em> to check this for "single-click" calendars and
182 only close/hide the calendar if it's <tt>true</tt>.</li>
183
184 <li>Full documentation in <a href="doc/html/reference.html">HTML</a>
185 and <a href="doc/reference.pdf">PDF</a> format is now available in the
186 distribution archive.</li>
187
188 <li>New language definition files: HU, HR, PT, ZH. Thanks those who
189 submitted!</li>
190 rizwank 1.1
191 </ul>
192
193 <h3>Bug status</h3>
194
195 <p>This covers only those bugs that have been reported <a
196 href="http://sourceforge.net/projects/jscalendar" target="_blank"
197 title="Project page at SourceForge">at SourceForge</a>.</p>
198
199 <ol>
200
201 <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=703238&group_id=75569&atid=544285" target="_blank"
202 title="Go to bug description at sourceforge"><tt>#703,238</tt></a> — fixed</li>
203 <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=703814&group_id=75569&atid=544285" target="_blank"
204 title="Go to bug description at sourceforge"><tt>#703,814</tt></a> — fixed</li>
205 <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=716777&group_id=75569&atid=544285" target="_blank"
206 title="Go to bug description at sourceforge"><tt>#716,777</tt></a> — closed (was fixed already in 0.9.2-1)</li>
207 <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=723335&group_id=75569&atid=544285" target="_blank"
208 title="Go to bug description at sourceforge"><tt>#723,335</tt></a> — fixed</li>
209 <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=715122&group_id=75569&atid=544285" target="_blank"
210 title="Go to bug description at sourceforge"><tt>#715,122</tt></a> — feature request; implemented.</li>
211 rizwank 1.1 <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=721206&group_id=75569&atid=544285" target="_blank"
212 title="Go to bug description at sourceforge"><tt>#721,206</tt></a> — fixed (added "refresh()" function)</li>
213 <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=721833&group_id=75569&atid=544285" target="_blank"
214 title="Go to bug description at sourceforge"><tt>#721,833</tt></a> — fixed (bug concerning the "yy" format
215 parsing)</li>
216 <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=721833&group_id=75569&atid=544285" target="_blank"
217 title="Go to bug description at sourceforge"><tt>#721,833</tt></a> — won't fix (we won't set the time to
218 midnight; time might actually be useful when we implement support
219 for time selection).
220
221 </ol>
222
223 <hr />
224 <address><a href="http://dynarch.com/mishoo/">Mihai Bazon</a></address>
225 <!-- Created: Tue Jul 8 17:29:37 EEST 2003 -->
226 <!-- hhmts start -->
227 Last modified on Wed Oct 29 02:37:07 2003
228 <!-- hhmts end -->
229 <!-- doc-lang: English -->
230 </body>
231 </html>
232 rizwank 1.1
233
|