← Back to branch summary

~hexmode/+junk/main

« back to all changes in this revision

Viewing changes to install-files/apps/sqlitemanager1.2.0/jscalendar/release-notes.html

  • Committer: Mark A. Hershberger
  • Date: 2008-01-05 19:38:56 UTC
  • Revision ID: hershberger@spawn-xp-20080105193856-6rnzgwa4nehue3qj
initial commit

Show diffs side-by-side

added added

removed removed

Lines of Context:
install-files/apps/sqlitemanager1.2.0/jscalendar/release-notes.html
 
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
    <div style="float: right; border: 1px solid #000; background: #fff; padding: 10px; ">
 
15
      <a href="http://www.dynarch.com/projects/calendar/">The Coolest DHTML Calendar</a><br />
 
16
      © <a href="http://www.dynarch.com/">Dynarch.com</a> 2002 and later.
 
17
    </div>
 
18
    <h1>jscalendar release notes</h1>
 
19
 
 
20
    <p>This release compiled at Monday,  7 Mar 2005 (19:06).</p>
 
21
 
 
22
    <h2>1.0</h2>
 
23
 
 
24
    <ul>
 
25
 
 
26
      <li>
 
27
        Added support for multiple dates selection.  In this mode the
 
28
        calendar will allow the user to select more than one date, and
 
29
        will maintain an array of selected dates that can be
 
30
        investigated from your custom handlers.  Sample in <a
 
31
        href="multiple-dates.html">multiple-dates.html</a>.
 
32
      </li>
 
33
 
 
34
      <li>
 
35
        Support for “day info”.  Using this feature you can display
 
36
        custom information for certain dates.  Sample in <a
 
37
        href="dayinfo.html">dayinfo.html</a>.  Note that if the text
 
38
        is really big the calendar layout might appear somehow broken;
 
39
        this is something that should be easy to fix in the CSS file.
 
40
      </li>
 
41
 
 
42
      <li>
 
43
        Clicking on “Today” will now close the calendar if the current
 
44
        date is already selected.
 
45
      </li>
 
46
 
 
47
      <li>
 
48
        The “first day of week” setting can now be defined in the
 
49
        language file--after all, it is locale-specific.  The new
 
50
        parameter is “Calendar._FD”.  Language files should be
 
51
        updated, but the calendar will not complain nor fail to
 
52
        function if the parameter is not present.
 
53
      </li>
 
54
 
 
55
      <li>
 
56
        Some fixes to make the thing work in Safari.  It now seems to
 
57
        be properly supported, please let me know if you encounter any
 
58
        problems.
 
59
      </li>
 
60
 
 
61
      <li>
 
62
        New skin: Aqua theme, appropriate for MacOSX fan sites :-)
 
63
        This theme is located in “skins/aqua/theme.css” (in the
 
64
        future, all themes will go to this directory).
 
65
      </li>
 
66
 
 
67
      <li>
 
68
        <b>Bug fixes.</b>
 
69
        <ul>
 
70
          <li>
 
71
            Keyboard operation now functions normally when the
 
72
            calendar is displaying days from adjacent months; it might
 
73
            even work correctly for months containing disabled dates
 
74
            :).  This fix was originally developed under contract for
 
75
            <a
 
76
            href="http://www.zapatec.com/website/main/products/prod1/">The
 
77
            Zapatec Calendar</a>.  Zapatec kindly allowed us to
 
78
            include the bugfixes back in the open source calendar.
 
79
          </li>
 
80
          <li>
 
81
            Fixed the time selection bug: the previous version would
 
82
            reset the time to current time when a new date was
 
83
            clicked.
 
84
          </li>
 
85
          <li>
 
86
            Parsing hours like "12:XX pm" would wrongfully replace
 
87
            "pm" with "am"--fixed.
 
88
          </li>
 
89
          <li>
 
90
            Fixed critical bugs in parseDate function that would
 
91
            initialize the calendar with 'NaN' values in all cells if
 
92
            the string to be parsed is not a valid date.
 
93
          </li>
 
94
          <li>
 
95
            The golbal variable that we are using was renamed to
 
96
            “_dynarch_popupCalendar” to minimize the risk of name
 
97
            clashes.  It's still difficult to get rid of it.
 
98
          </li>
 
99
          <li>
 
100
            Added z-index property to drop-down menus style.
 
101
          </li>
 
102
          <li>
 
103
            The calendar will update an input field even in flat mode,
 
104
            if an input field was passed.  Also, the “showOthers”
 
105
            parameter will be effective in both popup and flat mode.
 
106
          </li>
 
107
          <li>
 
108
            Others, probably.
 
109
          </li>
 
110
        </ul>
 
111
      </li>
 
112
 
 
113
      <li>
 
114
        Documentation &amp; sample files updated.
 
115
      </li>
 
116
 
 
117
    </ul>
 
118
 
 
119
    <h2>0.9.6</h2>
 
120
 
 
121
    <ul>
 
122
 
 
123
      <li>
 
124
        "Smart" (TM :-) positioning algorithm.  The new algorithm will
 
125
        try to keep the calendar in the browser view, which is helpful
 
126
        in situations when the input field is near the bottom or the
 
127
        right edge.  This code is only tested with IE and Mozilla, but
 
128
        it should work with other browsers too.  Many thanks to <a
 
129
        href="http://www.ex3.com">Sunny Chowdhury</a> for sponsoring
 
130
        this feature!
 
131
      </li>
 
132
 
 
133
      <li>
 
134
        Support for IE5/Win is back.  I also want to thank Janusz
 
135
        Piwowarski for keeping his eye on the CVS ;-) He reviewed my
 
136
        IE5-related changes and sent me a much cleaner patch.
 
137
      </li>
 
138
 
 
139
      <li>
 
140
        The calendar will now allow any day of week to be "the first
 
141
        day of week".  This was requested long time ago, by someone
 
142
        whose name I forgot (sorry).  The reason was that in certain
 
143
        countries weeks start on Saturday.  So I thought that instead
 
144
        of having a "mondayFirst" and a "saturdayFirst" parameter,
 
145
        :-), it's better to have a "firstDayOfWeek" parameter; now
 
146
        it's present and its meaning is: "0 for Sunday", "1 for
 
147
        Monday", "2 for Tuesday", etc.  The equivalent parameter for
 
148
        Calendar.setup is "firstDay".  The end user can also change
 
149
        it very easy: click on the day name in the calendar display.
 
150
      </li>
 
151
 
 
152
      <li>
 
153
        The above feature triggered one <b>important change</b>: the
 
154
        notion of "weekend" is now defined in the language file.
 
155
        Added parameters:
 
156
 
 
157
        <pre>
 
158
          Calendar._TT["WEEKEND"] = "0,6";
 
159
          Calendar._TT["DAY_FIRST"] = "Display %s first";</pre>
 
160
 
 
161
        "WEEKEND" specifies a string with comma-separated numbers from
 
162
        0 to 7; they define what days are marked as "weekend".  5 and
 
163
        6 mean, of course, "Sunday" and "Saturday".  Day first is the
 
164
        tooltip displayed when a day name is hovered; "%s" will get
 
165
        replaced with the day name.  Updated languages are "en" and
 
166
        "ro", which I maintain.  Please note that languages wich are
 
167
        not updated <b>will not work</b>.  If yours is one of them,
 
168
        please consider fixing it and sending me the fix so that I can
 
169
        include it in the distro.
 
170
      </li>
 
171
 
 
172
      <li>
 
173
        The calendar can now display days from the months adjacent to
 
174
        the currently displayed one.  This is optional, of course, and
 
175
        the parameter name is "showsOtherMonths" (or "showOthers" in
 
176
        Calendar.setup).  All theme files were updated.
 
177
      </li>
 
178
 
 
179
      <li>
 
180
        Displays "Time:" near the time selector, only if defined in
 
181
        the language file.
 
182
      </li>
 
183
 
 
184
      <li>
 
185
        Some bugs fixed in the date parsing code (which has also been
 
186
        rewritten a little bit cleaner).
 
187
      </li>
 
188
 
 
189
      <li>
 
190
        Calendar.setup will now configure the calendar to trigger the
 
191
        input fields' "onchange" event, if specified, when a date is
 
192
        selected.
 
193
      </li>
 
194
 
 
195
      <li>
 
196
        New parameter in Calendar.setup: "cache" (<b>defaults to
 
197
        false</b>).  If set to true then the popup calendar object
 
198
        will be "cached", meaning, it will be created only once, no
 
199
        matter how many input fields are there in the page.  Sometimes
 
200
        this is not desirable, which is why I've added this
 
201
        parameter.  Please note that it defaults to "false" (thus the
 
202
        default behavior has changed).
 
203
      </li>
 
204
 
 
205
      <li>
 
206
        Added a simple PHP wrapper.  It provides code which loads all
 
207
        the required scripts and theme file, and one function which
 
208
        creates and configures an input field for date input.  It
 
209
        takes care of creating and assigning unique ID-s for the
 
210
        calendar fields and it also creates the "Calendar.setup" code.
 
211
        Functions to create more specialized fields can be added very
 
212
        easily.  This feature was requested by the FreeMED.org project
 
213
        (thanks for donating!).
 
214
      </li>
 
215
 
 
216
    </ul>
 
217
 
 
218
    <p>Wow, there were quite some changes :-D  Enjoy it!</p>
 
219
 
 
220
    <h2>0.9.5</h2>
 
221
 
 
222
    <p>
 
223
      This release's primary goal is to fix a wrong license statement which
 
224
      can be found in some files from 0.9.4.  For instance in README or
 
225
      calendar.js, the statement was that the code is distributed under the
 
226
      GNU GPL; that's because I had plans to change the license, then
 
227
      changed my mind but unfortunately I committed files so.  I am sorry
 
228
      for this inconvenience, please use the latest (0.9.5) release which is
 
229
      fully covered by LGPL.
 
230
    </p>
 
231
 
 
232
    <p>Other changes:</p>
 
233
 
 
234
    <ul>
 
235
 
 
236
      <li>
 
237
        <b>Fixed</b> an annoying bug that prevented the calendar to display
 
238
        correctly when it was configured for an input field inside a
 
239
        <b>scrolling area</b>.  <b>Many thanks</b> to Ian Barrack (<a
 
240
        href="http://www.simban.com">Simban.com</a>) who pointed it up and
 
241
        donated quite some money for the Calendar project!
 
242
      </li>
 
243
 
 
244
      <li>
 
245
        All examples use UTF-8 now; the translations may not be all
 
246
        up-to-date, but I <strong>strongly</strong> suggest everyone to use
 
247
        UTF-8; other encodings are a plain mess.  So far I know for sure
 
248
        that Romanian translation will work with UTF-8 and <em>not
 
249
        anymore</em> with ISO-8859-2.  Other translations are probably
 
250
        usable under UTF-8, but if your preferred language isn't... ;-)
 
251
        please make it and send it to me for inclusion.
 
252
      </li>
 
253
 
 
254
      <li>
 
255
        Fixed small bug in the documentation (one footnote didn't appear
 
256
        where it should have).
 
257
      </li>
 
258
 
 
259
      <li>
 
260
        Updated translations: DE, ES, HU, IT, RO.  Thanks to everyone who
 
261
        sent translations!
 
262
      </li>
 
263
 
 
264
    </ul>
 
265
 
 
266
    <h2>0.9.4</h2>
 
267
 
 
268
    <h3>New stuff</h3>
 
269
 
 
270
    <ul>
 
271
 
 
272
      <li>Supports time selection.  Yes. ;-) This work has been largely
 
273
        sponsored by <strong>Himanshukumar Shah</strong> (thank you!).  See
 
274
        the docs and example files for details on how to setup.</li>
 
275
 
 
276
      <li>Easy to link 2 or more fields by using the new
 
277
        <code>onUpdate</code> parameter of <code>Calendar.setup</code>.  This
 
278
        is useful, say, to automatically set a value in a second field based
 
279
        on the value selected in the first field.  See the documentation and
 
280
        first sample in <a href="simple-1.html">simple-1.html</a>.</li>
 
281
 
 
282
      <li>Other <code>Calendar.setup</code> low-level parameters, for those
 
283
        wanting to have the complete control: <code>onSelect</code> and
 
284
        <code>onClose</code>.  The handlers are called when something is
 
285
        selected in the calendar or when the calendar is closed.</li>
 
286
 
 
287
      <li>The translation files can optionally include the short day names
 
288
        and the short month names.  That's because in some languages, like
 
289
        German, the short form is not the first 3 letters of the entire name
 
290
        but only the first 2.  Also in other languages short names can't be
 
291
        as easily derived from the full name by just calling substr, so this
 
292
        patch solves the problem.</li>
 
293
 
 
294
      <li>Implemented a nice way to make some dates "special" (look
 
295
        different).  Specifically, the <code>setDisabledHandler</code> method
 
296
        was replaced with the more general <code>setDateStatusHandler</code>
 
297
        method (the old one is still available for backwards compatibility but
 
298
        <em>will</em> be removed).  More details about this in the
 
299
        documentation.  Also see <a href="simple-3.html">simple-3.html</a>
 
300
        for a live sample.</li>
 
301
 
 
302
      <li>Date parsing and formatting engine is now rewritten and supports a
 
303
        subset of <code>strftime</code> format specifiers from ANSI C.  This
 
304
        makes it possible to use dates like "YYYYMMDD" (the corresponding
 
305
        format for this would be "%Y%m%d").  Details in the documentation.
 
306
        <b>Please note that the new engine is not compatibile with older
 
307
          calendar releases!</b></li>
 
308
 
 
309
      <li>Along with the new date parser I workarounded an unpleasant crash
 
310
        that occurred in IE when certain accented characters appeared in the
 
311
        texts.  I think German was one of the language with such problems, and
 
312
        the workaround was to use the letter without an accent.  Well, now you
 
313
        can translate to whatever you want.</li>
 
314
 
 
315
      <li>"Fixes" (I mean, "horrible workarounds") for Konqueror (and
 
316
        hopefully Safari).  Unfortunately, this otherwise excellent browser
 
317
        still has some bugs that keep the calendar from working
 
318
        <em>exactly</em> as it should..  But they're going to be fixed,
 
319
        right? ;-)</li>
 
320
 
 
321
      <li>CSS themes got pretty much modified too so if you wrote your theme
 
322
        you need to update it.  Aside for the time selector support, the CSS
 
323
        themes contain a simple hack that makes the navigation buttons show
 
324
        a little arrow in the lower-right corner which indicates that if one
 
325
        holds the mouse a menu will appear.</li>
 
326
 
 
327
    </ul>
 
328
 
 
329
    <h3>Translation files</h3>
 
330
 
 
331
    <p>The translation files need to be updated in order for the calendar to
 
332
      work properly.  Currently the only updated files are calendar-en.js
 
333
      (main file) and calendar-ro.js (well, yes, I am a Romanian ;-).</p>
 
334
 
 
335
    <p>Specifically, they need the following:</p>
 
336
 
 
337
    <ul>
 
338
 
 
339
      <li>Correct date format, according with the new format specifiers
 
340
        introduced in 0.9.4.  Details about the available format specifiers
 
341
        in the documentation</li>
 
342
 
 
343
      <li>Short day or month names, <em>if required</em>.  If they can be
 
344
        derived by taking the first N letters of the full name then a simple
 
345
        Calendar._SDN_len = N or Calendar._SMN_len = N will suffice.  If N
 
346
        is 3 then nothing needs to be done as we take it for granted if no
 
347
        other option is offered ;-)</li>
 
348
 
 
349
      <li>We have some new texts that shows short usage information as well
 
350
        as copyright information.</li>
 
351
 
 
352
    </ul>
 
353
 
 
354
    <p>If your favorite language is not there yet, or it is but not updated
 
355
      according to the main calendar-en.js file, then please consider
 
356
      translating calendar-en.js and send the translation back to me so that
 
357
      I include it in the official distribution.</p>
 
358
 
 
359
    <h3>Bug status</h3>
 
360
 
 
361
    <p>Check <a
 
362
        href="http://sourceforge.net/tracker/?atid=544285&group_id=75569&func=browse">SourceForge</a>,
 
363
      I didn't keep track.  However, there were a lot of bugfixes.</p>
 
364
 
 
365
    <h2>0.9.3</h2>    
 
366
 
 
367
    <h3>New stuff</h3>
 
368
 
 
369
    <ul>
 
370
 
 
371
      <li>Opera&nbsp;7 compatibility &mdash; keyboard navigation is
 
372
        still not available; text selection can't be disabled, leading to an
 
373
        ugly effect when walking through the month/year menus.</li>
 
374
 
 
375
      <li>Ability to align the calendar relative to the input field (or any
 
376
        other element).  Vertical: top, center, bottom.  Horizontal: left,
 
377
        center, right.  This is established as a new parameter for
 
378
        <tt>showAtElement</tt>.</li>
 
379
 
 
380
      <li>Added <tt>dateClicked</tt> property (boolean).  This can be
 
381
        inspected in the "onSelect" handler to determine if a date was
 
382
        really clicked or the user only changed month/year using the menus.
 
383
        You <em>need</em> to check this for "single-click" calendars and
 
384
        only close/hide the calendar if it's <tt>true</tt>.</li>
 
385
 
 
386
      <li>Full documentation in <a href="doc/html/reference.html">HTML</a>
 
387
        and <a href="doc/reference.pdf">PDF</a> format is now available in the
 
388
        distribution archive.</li>
 
389
 
 
390
      <li>New language definition files: HU, HR, PT, ZH.  Thanks those who
 
391
        submitted!</li>
 
392
 
 
393
    </ul>
 
394
 
 
395
    <h3>Bug status</h3>
 
396
 
 
397
    <p>This covers only those bugs that have been reported <a
 
398
        href="http://sourceforge.net/projects/jscalendar" target="_blank"
 
399
        title="Project page at SourceForge">at SourceForge</a>.</p>
 
400
 
 
401
    <ol>
 
402
 
 
403
      <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=703238&group_id=75569&atid=544285" target="_blank"
 
404
            title="Go to bug description at sourceforge"><tt>#703,238</tt></a> &mdash; fixed</li>
 
405
      <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=703814&group_id=75569&atid=544285" target="_blank"
 
406
            title="Go to bug description at sourceforge"><tt>#703,814</tt></a> &mdash; fixed</li>
 
407
      <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=716777&group_id=75569&atid=544285" target="_blank"
 
408
            title="Go to bug description at sourceforge"><tt>#716,777</tt></a> &mdash; closed (was fixed already in 0.9.2-1)</li>
 
409
      <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=723335&group_id=75569&atid=544285" target="_blank"
 
410
            title="Go to bug description at sourceforge"><tt>#723,335</tt></a> &mdash; fixed</li>
 
411
      <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=715122&group_id=75569&atid=544285" target="_blank"
 
412
            title="Go to bug description at sourceforge"><tt>#715,122</tt></a> &mdash; feature request; implemented.</li>
 
413
      <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=721206&group_id=75569&atid=544285" target="_blank"
 
414
            title="Go to bug description at sourceforge"><tt>#721,206</tt></a> &mdash; fixed (added "refresh()" function)</li>
 
415
      <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=721833&group_id=75569&atid=544285" target="_blank"
 
416
            title="Go to bug description at sourceforge"><tt>#721,833</tt></a> &mdash; fixed (bug concerning the "yy" format
 
417
        parsing)</li>
 
418
      <li><a href="http://sourceforge.net/tracker/index.php?func=detail&aid=721833&group_id=75569&atid=544285" target="_blank"
 
419
            title="Go to bug description at sourceforge"><tt>#721,833</tt></a> &mdash; won't fix (we won't set the time to
 
420
        midnight; time might actually be useful when we implement support
 
421
        for time selection).
 
422
 
 
423
    </ol>
 
424
 
 
425
    <hr />
 
426
    <address><a href="http://dynarch.com/mishoo/">Mihai Bazon</a></address>
 
427
<!-- Created: Tue Jul  8 17:29:37 EEST 2003 -->
 
428
<!-- hhmts start -->
 
429
Last modified on Wed Oct 29 02:37:07 2003
 
430
<!-- hhmts end -->
 
431
<!-- doc-lang: English -->
 
432
  </body>
 
433
</html>
 
434
 
 
435