694e92d67985e7a60287841758a8291f9494476e
[gitmo/Mouse.git] / Changes
1 Revision history for Mouse
2
3 0.50_02
4     * Mouse::Meta::Attribute
5         - Implement argument currying for delegation (gfx)
6
7 0.50_01 Sat Feb 13 16:39:48 2010
8     * Mouse
9         - before/around/after now accept regexps (gfx)
10     * Mouse::Object
11         - Support the global destruction flag in DEMOLISH (gfx)
12     * Mouse::Meta::Attribute
13         - Attribute constructors now warn very noisily about unknown (or
14           misspelled) arguments (gfx)
15
16
17 0.50 Mon Feb  8 13:43:19 2010
18     * Mouse::Tiny
19         - Allow "use Mouse::Tiny VERSION" with a patch contributed by
20           chocolateboy, RT #54383 (gfx)
21     * Mouse::Util::MetaRole
22         - Add Mouse::Util::MetaRole::apply_metaroles
23             to catch up the latest Moose API for metaroles (gfx)
24
25 0.49 Tue Feb  2 12:58:45 2010
26     * MouseAccessor.xs
27         - Fix RT #54203 that writers might return undef in setting values
28             reported by chocolateboy (gfx)
29
30 0.48 Sun Jan 31 17:53:31 2010
31     * MouseTypeConstraints.xs
32         - Fix magic handling in type constraints reported by sunnavy (gfx)
33
34 0.47 Fri Jan 15 15:07:21 2010
35     * Makefile.PL
36         - Shipped with M::I::XSUtil 0.21 (gfx)
37         - Fix an issue that gcc 4.0 don't support -Wc++-compat (gfx)
38     * Mouse
39         - Add a caveat on XS callbacks to the pod (gfx)
40
41 0.46 Sat Jan  9 17:54:30 2010
42     * Mouse::Meta::Attribute
43         - Add support for code references for handles
44             patched by Frank Cuny (gfx)
45     * Mouse::Util::TypeConstraints
46         - Fix Str and ScalarRef for typeglobs, lvalues, and etc. (gfx)
47     * oose.pm
48         - Add Moose::Util::TypeConstraints exports to allow easier testing
49             of TypeConsraints from the command line (gfx)
50
51 0.4501 Tue Dec 22 16:02:15 2009
52     * Fix an issue on circular dependencies (RT #52939, thanks to t0m)
53      - (see also http://rt.cpan.org/Public/Bug/Display.html?id=52939 )
54
55 0.45 Sat Dec 19 17:22:46 2009
56     * Fix filename portability issue (RT #52828, thanks to Peter Edwards)
57
58     * Fix an issue that definitions of anonymous types could fail (gfx)
59
60     * Mouse::Meta::Attributes
61         - Add set_value/get_value/has_value/clear_value (gfx)
62           (Note that thsese methods are depend on the accessors)
63
64     * Test::Mouse
65         - Add with_immutable (gfx)
66
67 0.44 Wed Dec  9 21:43:21 2009
68     * Shipped with Module::Install::XSUtil 0.19 (gfx)
69
70     * Test::Mouse
71         - Added (gfx)
72
73     * Mouse::Util::TypeConstraints
74         - Add duck_type (gfx)
75
76 0.43 Mon Dec  7 14:21:59 2009
77     * Improve documents
78
79     * Mouse::Meta::Module
80         - Remove undocumented has_package_symbol and get_package_symbol (gfx)
81             (They are introduced in 0.41, but seem useless in Mouse)
82
83 0.42 Sat Dec  5 16:05:06 2009
84     * Fix a PAUSE indexing issue (gfx)
85
86 0.41 Sat Dec  5 15:00:33 2009
87     * This is the first stable version of Mouse::XS
88         - Mouse::XS is about 2 times faster than Mouse::PurePerl
89
90     * SUMMARY
91         - Many stuff are now in XS
92         - Support "use Mouse -traits => ..." subdirective
93
94     * INCOMPATIBILITY CHANGES (but compatible with Moose)
95         - The type of default value is constrained correctly
96         - The default values is weakend correctly
97         - BUILDALL/DEMOLISHALL are no longer called
98
99 0.40_09 Thu Dec  3 13:42:17 2009
100     * Mouse
101         - Remove @Mouse::EXPORT, which was no longer used (gfx)
102
103     * Mouse::Role
104         - Remove @Mouse::Role::EXPORT, which was no longer used (gfx)
105
106     * Mouse::Util
107         - Fix a bug which caused segv on 5.6.2 (gfx)
108
109     * Mouse::Meta::Module
110         - Add has_package_symbol and get_package_symbol (gfx)
111
112
113 0.40_08 Thu Nov 26 21:36:49 2009
114     * Mouse::Exporter
115         - Add the "-traits => ..." subdirective (gfx)
116
117     * Mouse::Meta::Class
118         - Add metaclass incompatibility resolution (gfx)
119
120 0.40_07 Tue Nov 17 18:28:57 2009
121     * Mouse::Util::MetaRole
122         - Implemented, but there are many to be done (gfx)
123
124     * Mouse::Meta::Method::Accessor
125     * Mouse::Meta::Method::Constructor
126         - Fix a bug that default values are not weaken()ed (gfx)
127
128 0.40_06 Mon Nov 16 17:21:10 2009
129     * Shipped with Module::Install::XSUtil 0.17 (gfx)
130     * Mouse::Object
131         - BUILDALL and DMELISHALL are no longer called by the default ctr/dtr,
132           because generated ctrs/dtrs have never call them anyway (gfx)
133         - new and DESTROY are now in XS (gfx)
134
135 0.40_05 Mon Nov  2 11:59:01 2009
136     * Shipped with Module::Install::XSUtil 0.16 (gfx)
137
138 0.40_04 Tue Nov  1 11:58:27 2009
139     * Implement type constraint generators in XS (gfx)
140
141 0.40_03 Fri Oct 30 12:03:58 2009
142     * Update Module::Install::XSUtil to 0.15 (gfx)
143
144 0.40_02 Tue Oct 27 15:04:10 2009
145     * Add the Mouse::XS documentation (gfx)
146
147     * Mouse::Meta::Method::Accessor
148         - Apply type constraints to default values as Moose does (gfx)
149
150 0.40_01 Mon Oct 26 17:31:23 2009
151     * Add an optional XS implementation (gfx)
152
153 0.40 Mon Oct 19 18:30:32 2009
154     * Mouse::Meta::TypeConstraint
155         - Fix a subtyping issue (Thanks miyagawa san) (gfx)
156     * Mouse/Mouse::Role
157         - Now export their sugars to the "main" package (gfx)
158
159 0.39 Tue Oct 13 16:42:31 2009
160     * Fix RT #50421 (Thanks Michael G Schwern)
161     * Fix RT #50422 (Thanks Michael G Schwern)
162
163 0.38 Tue Oct 13 15:40:39 2009
164     * No code changes from 0.37_06
165
166     * SUMMARY from 0.37 to 0.38
167         - Add documents about compatiblity and incompatibility to Mouse::Spec
168         - Refactor type constraints and type coercions
169             - Now ArrayRef[Foo | Bar] is parsed correctly
170             - Type coercions are stored in type constraint objects
171         - Add Mouse::Exporter for import/unimport methods
172         - Make roles applicable to instances
173         - Implement inner/augment keywords
174         - Port a lot of Moose's tests
175         - Fix a lot of bugs
176
177
178 0.37_06 Mon Oct 12 16:34:18 2009
179     * Mouse::Meta::Attribute
180         - Support handles => qr/pattern/ in has() (gfx)
181
182     * Mouse::Meta::Method::Destructor
183         - Locallize $@ and $? in DESTROY as Moose does (gfx)
184
185     * Mouse::Meta::Role
186         - Fix role application to instances (gfx)
187
188     * Tests
189         - Move t/*.t to t/001_moose/
190
191 0.37_05 Fri Oct  9 15:21:43 2009
192     * Mouse::Exporter
193         - Add build_import_methods() (gfx)
194
195     * Mouse::Spec
196         - Add notes about Moose::Cookbook (gfx)
197
198     * Fix some minor bugs (gfx)
199
200 0.37_04 Thu Oct  8 20:49:11 2009
201     * Mouse::Meta::Role::Composite
202         - Fix and improve role composition mechanism (gfx)
203
204     * Import a number of tests from Moose, and fix various bugs (gfx)
205
206     * Mouse::Tiny is always generated in Makefile.PL (gfx)
207
208 0.37_03 Wed Oct  7 21:10:05 2009
209     * Mouse::Exporter
210         - Add Mouse::Exporter (gfx)
211     * Mouse::Meta::Method::Constructor
212         - Optimize generated constructors (gfx)
213     * Mouse::Meta::Role
214         - Implement role application to instances (gfx)
215
216 0.37_02 Sun Oct  4 17:29:15 2009
217     * Mouse
218         - Implement the argument/inner keywords
219     * Mouse::Meta::Attribute
220         - Add get_read_method_ref() and get_write_method_ref() (gfx)
221         - Add find_attribute_by_name() (gfx)
222         - Fix clone_and_inherit_options() to deal with 'traits' (gfx)
223     * Mouse::Util
224         - Fix meta() method, which was not tested (gfx)
225     * Tests
226         - Port t/010_basics/*.t from Moose
227
228 0.37_01 Thu Oct  1 15:32:58 2009
229     * Type coercions are stored to type constraints (gfx)
230
231     * Refactor the type parser to parse 'ArrayRef[Object|Int]' (gfx)
232
233     * Remove Class::MOP specific subroutines from Mouse::Meta::Module (gfx)
234       (this change might be reverted in the release version)
235         - version, authority, identifier,
236           get_all_metaclasses, store_metaclass_by_name,
237           weaken_metaclass, does_metaclass_exist, remove_metaclass_by_name
238
239     * Add new public utilities to Mouse::Util (gfx)
240         - class_of, the counterpart for Class::MOP::class_of
241         - get_metaclass_by_name for Class::MOP::get_metaclass_by_name
242
243
244 0.37 Mon Sep 28 10:48:27 2009
245     * Ensure backward compatibility by author/test-externa.pl (gfx)
246
247     * Change the algorithm of has_method() for backward compatibility (gfx)
248
249     * $ENV{MOUSE_VERBOSE}=1 for Moose-compatible warnings (gfx)
250
251 0.36 Sun Sep 27 16:53:06 2009
252     * Fix an issue that breaks backward compatibility (gfx)
253       - MouseX::Attribute does work, although make tests doesn't pass
254
255 0.35 Sat Sep 26 12:38:27 2009
256     * Work around Test::Exception 0.27_0x by including authorized ver. (gfx)
257
258 0.34 Fri Sep 25 21:55:48 2009
259     * Make sure to work on 5.6.2 (gfx)
260
261     * Remove Class::Method::Modifiers dependency (gfx)
262
263     * Remove testing modules from inc/ (gfx)
264
265     * Put t/019-handles.t on ice (gfx)
266
267 0.33_01 Thu Sep 24 16:16:57 2009
268     * Implement traits => [...] in has() (gfx)
269
270 0.33 Wed Sep 23 15:06:40 2009
271     * Fix RT #49902: 0.32 fails tests reported by GRUBER (gfx)
272
273     * Add some tests
274
275 0.32 Tue Sep 22 16:44:57 2009
276     * Add many tests copied from Moose (gfx)
277
278     * Fix Mouse::Util::find_meta() and Mouse::Util::does_role() (gfx)
279
280     * Fix the timing triggers are invoked (gfx)
281
282     * Implement confliction checks in roles
283
284     * work around create() and create_anon() in Mouse::Meta::Role
285
286 0.31 Tue Sep 22 11:08:12 2009
287     * Add find_meta() and does_role() to Mouse::Util (gfx)
288
289     * Fix tests using Class::Method::Modifiers to be skipped correctly (gfx)
290
291     * Remove Test::Mouse, which was accidentally included (gfx)
292
293 0.30 Mon Sep 21 16:43:05 2009
294     * Implement RT #46930 (accessor/reader/writer in has()) (gfx)
295
296     * Work around anonymous classes as mortal classes (gfx)
297
298     * Implement with $role => -exlucdes => [...] (gfx)
299
300     * Implement get_method() in M::Meta::Class and M::Meta::Role (gfx)
301
302     * Make get_method_list() compatible with Moose's (gfx)
303
304     * Make unimport() not to remove non-Mouse functions (blessed and confess) (gfx)
305
306     * Remove a lot of duplication code (gfx)
307
308     * Support is => 'bare', and you must pass and 'is' option to has() (gfx)
309
310 0.29 Thu Sep 17 11:49:49 2009
311
312     * role class has ->meta in method_list, because it does in Moose since 0.9
313 0.28 Wed Sep  8 20:00:06 2009
314     * Alter Makefile.PL so in author mode we generate lib/Mouse/Tiny.pm on
315       every run so that 'make dist' actually does what it's meant to (mst)
316
317     * Only unlink Mouse::Tiny if it exists, otherwise autodie pitches
318       a fit (miyagawa)
319     
320     * Make auto_deref also handles isa not only ArrayRef and HashRef, but also 
321       ArrayRef[Foo::Bar] and HashRef[Foo::Bar]
322
323 0.27 Thu Jul  2 15:17:37 2009
324     * Doc updates (Sartak)
325
326     * Include missing Mouse::Tiny
327
328 0.26 Wed Jul  1 13:39:30 2009
329     * Fix failing tests by requiring a newer Moose in that test (t0m)
330
331 0.25 Fri Jun 19 12:05:42 2009
332     * Fix SIGNATURE (reported by daxim) ... by removing it :)
333
334 0.24 Mon Jun 15 14:47:18 2009
335     * Moose's construct_instance is deprecated, use new_object (tokuhirom)
336
337     * Improve Mouse::Tiny generation (tokuhirom)
338
339     * Inlining destructor fixes (tokuhirom)
340
341     * Add Mouse->init_meta (tokuhirom)
342
343     * Fix failing tests by requiring a newer Moose in that test (Sartak)
344
345     * Don't warn in tests about Squirrel deprecations (Sartak)
346
347 0.23 Wed May 27 16:52:28 2009
348     * Take the mro::linearized_isa DEMOLISHALL fix from Moose
349       (originally by doy)
350
351     * Mouse::class_of to mirror Class::MOP::class_of
352
353 0.22 Tue Apr 21 03:26:43 2009
354     * Regenerate broken signature (Sartak)
355       reported by Michael Gray [rt.cpan.org #45167]
356
357     * does_role now checks parent classes (tokuhirom)
358
359     * Fix for $_ not being available type constraint messages (Sartak)
360
361 0.21 Sat Apr 11 13:52:11 2009
362     * clone_instance has been made private, like in Moose (tokuhirom)
363
364     * Fix method modifiers applying to the wrong class (gfuji)
365       reported by Heikki Lehvaslaiho in [rt.cpan.org #42992]
366
367     * Fix test failures when user does not have C::Method::Modifiers(::Fast)
368       installed (Joel Bernstein)
369
370     * use get_all_attributes instead of
371       compute_all_applicable_attributes (tokuhirom)
372
373     * fixed pod bug (tokuhirom)
374       reported by Ryan52 in [rt.cpan.org #44928]
375
376     * Parameterized type constraints can now have messages (tokuhirom)
377
378     * Added documentation about type constraints (Mark Stosberg)
379
380 0.20 Thu Apr 9 20:22:33 2009
381     * Squirrel is now deprecated. Use Any::Moose instead (Sartak)
382
383     * To improve Moose compat, the third argument to trigger
384       (the attribute metaobject) has been removed (Sartak)
385
386     * To improve Moose compat, a single undef passed to new
387       is now disallowed (Sartak)
388
389     * Implemented Mouse::Object->does (wu-lee)
390
391     * Implemented override and super functions for Mouse::Role.
392       (wu-lee)
393
394     * Implemented stub augment and inner functions for Mouse::Role,
395       which merely throw an exception as in Moose::Role. (wu-lee)
396
397     * Stole more tests from Moose (020_roles/*).  Not all these pass
398       yet; the rest have been moved to 020_roles/failing for later
399       examination. (wu-lee)
400
401     * Implemented Mouse::Role->does_role.  This does not yet quite
402       seem to pass all the tests it should. (wu-lee)
403
404     * Fixed bug in Mouse::Meta::Role->apply and ->combine_apply, so that
405       030_roles/002_role.t tests pass. (wu-lee)
406
407     * Implemented ->version, ->authority and ->identifier methods in
408       Mouse::Meta::Role and Mouse::Meta::Class (mainly to make more
409       Moose tests pass). (wu-lee)
410
411     * Implemented emulations of Class::MOP's metaclass accessors
412       (get_metaclass_by_name etc.) in Mouse::Meta::Class.
413
414     * Mouse attribute property 'isa' now accepts Role names. (wu-lee)
415
416     * Fixed bug: typecoercion application order was reversed. (wu-lee)
417
418     * Fixed bug: inlined constructor was invoking BUILD methods in
419       wrong order. (wu-lee)
420
421     * Fixed bug: immutable constructor now redispatches correctly to
422       Mouse::Object::new when used in derived classes (wu-lee).
423
424     * Maybe parameterized type constraint (lestrrat)
425
426     * Performance improvements! (tokuhirom)
427
428     * Improve Moose compat of class_type (lestrrat)
429
430     * Many type-constraint fixes (tokuhirom and lestrrat)
431
432     * Mouse::Meta::Class->has_method and ->get_attribute_list (tokuhirom)
433
434     * Add get_all_attributes, use it internally instead of
435       compute_all_applicable_attributes (nothingmuch)
436
437 0.19 Sun Mar 8 04:38:01 2009
438     * Parameterized type constraints for ArrayRef and HashRef (lestrrat)
439
440     * Allow extensible attribute metaclass in traits too(tokuhirom)
441
442     * Don't use method modifiers in a test since they may not be
443       available (Sartak)
444
445 0.18 Fri Mar 6 19:09:33 2009
446     * Fix the issue preventing Mouse usage on Perl 5.6 - a bug in older
447       Scalar::Util! (tokuhirom)
448
449     * Allow extensible attribute metaclass (tokuhirom)
450
451     * Optimization for method modifiers (tokuhirom)
452
453     * Implement Mouse->import({into_level => 1}) (tokuhirom)
454
455     * Support for Class->meta->add_attribute($name => %options) (tokuhirom)
456
457     * Throw a more useful error message when trying to use a parameterized
458       type (Sartak)
459
460 0.17 Tue Feb 17 20:10:29 2009
461     * Load mro directly if Perl is recent enough (Nicholas Clark)
462
463     * Add dump method from Moose::Object into Mouse::Object (perigrin)
464
465     * Add role-role composition (tokuhirom)
466
467 0.16 Mon Feb 9 20:56:27 2009
468     * Implement get_all_method_names
469
470     * Support for anonymous enums: enum [elements]
471
472     * Moose's make_immutable returns true allowing calling code to skip
473       setting an explicit true value at the end of a source file. (obra)
474
475 0.15 Thu Feb 5 11:44:05 2009
476     * Don't export Mouse's sugar into the package 'main'
477
478     * Rename Mouse::TypeRegistry to Mouse::Util::TypeConstraints
479
480     * "type" sugar for when you're not subtyping anything
481
482     * Keep track of the source package of each type
483
484     * Moose lets you redefine a type within the same package, so we now do too
485
486     * Borrow more of Moose's meta API
487
488     * Mouse::Util::TypeConstraints now uses Exporter so you can select which
489       sugar you want
490
491     * class_type shouldn't load the class (Moose compat; no easy fix :/)
492
493     * suppress warnings when we use "around" and "has '+...'" (dann)
494
495     * use Data::Util to make method modifiers fast if it's available (dann)
496
497     * Implement "enum" type constraints
498
499     * Implement "override" and "super"
500
501     * MouseX::Types is now in its own dist
502
503 0.14 Sat Dec 20 16:53:05 2008
504     * POD fix
505
506     * Document what changes tokuhirom and Yappo made (see below)
507
508 0.13 Tue Dec 16 02:01:40 2008
509     * Pass in the instance to the default sub in the constructor (reported with
510       failing tests by rjbs)
511
512     * Tons of new features implemented by tokuhirom++ and Yappo++:
513       - method API in classes and roles!
514       - "requires" and "with" for Mouse::Role
515       - Type coercion
516       - Inject a constructor after make_immutable. Huge speedup!
517       - class_type and role_type
518       - Inject a destructor for more speedup
519       - MouseX::Types (may move into its own dist)
520       - create_anon_class
521       - union type constraints (eg 'Str | Undef')
522       - subtypes and sugar for them
523
524 0.12 Thu Dec 4 19:23:10 2008
525     * Provide Test::Exception function unless it's version 0.27 - RT #41254
526
527     * Mouse::Util now provides dies_ok
528
529     * Make class-like types behave more like Moose; subclasses OK! (rjbs)
530
531     * Steal more tests from Moose
532
533 0.11 Sun Nov 2 11:35:04 2008
534     * Throw an error if accessor/predicate/clearer/handles code eval fails
535
536     * Optimizations for generated methods, they should now be on par with Moose
537
538 0.10 Tue Oct 28 19:23:07 2008
539     * Require a recent Moose (which has the bugfix) for
540       t/500_moose_extends_mouse.t
541
542     * ouse.pm for perl -Mouse one-liners (thanks rjbs)
543
544     * Doc for init_arg => undef (thanks rjbs)
545
546 0.09 Sun Sep 28 22:37:13 2008
547     * Initial version of Mouse::Tiny, a one-file concatenation of the Mouse
548       classes for easy embedding
549
550     * Fixes caused by test failures (Carp not being loaded, Moose being
551       required in a test)
552
553 0.08 Sun Sep 28 12:46:07 2008
554     * ALL dependencies have been removed!
555
556     * Fixes for Class::Method::Modifiers being required for testing
557
558 0.07 Sun Sep 28 00:19:07 2008
559     * All runtime dependencies have been removed! The only change in
560       functionality (hopefully) is that the Sub::Exporter features can no
561       longer be used (we've backed down to regular Exporter). Scalar::Util is
562       required for "weaken" support, and Class::Method::Modifiers is required
563       for method modifier support, but only if you use these features!
564       Having Scalar::Util and MRO::Compat installed will provide only
565       performance increases.
566
567     * Tests and fixes for extending a Mouse class with Moose (nothingmuch)
568
569     * Support for adding method modifiers to a role, and composing them into
570       classes (we'll get true methods some day)
571
572     * Method modifiers now go through the metaclass instead of invoking
573       Class::Method::Modifiers directly
574
575     * Remove the deprecated before/after/around triggers
576
577     * Roles keywords 'requires' and 'excludes' now throw errors instead of
578       silently doing nothing (they aren't implemented yet)
579
580 0.06 Thu Jul 23 02:10:07 2008
581     * Deprecating before/after/around triggers! Switch back to coderef +
582       whatever you used to do. Moose is have it implemented it as an extension
583       trait.
584
585     * Mouse
586       - updated trigger doc (thanks perigrin)
587         - which will not see CPAN :( sorry perigrin!
588
589     * Mouse::Meta::Class
590       - add a make_immutable method which does nothing(!), for even more
591         Moose compat (nothingmuch's idea)
592
593 0.05 Thu Jul 17 01:53:20 2008
594     * Mouse::Role
595       Mouse::Meta::Role
596       Mouse
597       Squirrel::Role
598       - Begin adding roles! Attributes are mostly there. Still experimental.
599
600     * Mouse::Meta::Class
601       Mouse::Object
602       - Add clone_object and clone_instance (nothingmuch)
603
604     * Mouse::Object
605       - Add BUILDARGS (nothingmuch)
606
607     * Mouse::Meta::Attribute
608       Mouse::Object
609       - Add "before" and "around" triggers. Moose doesn't even have them yet! :)
610
611     * Everywhere
612       - Improvements to the MOP (e.g. Class->add_method)
613
614     * (build)
615       - Excise dependency on Test::Warn, we only used it in one simple test
616
617 0.04 Tue Jun 17 04:56:36 2008
618     * Mouse
619       Mouse::Meta::Attribute
620       - Add support for has '+name'
621       - Add lazy_build (nothingmuch)
622
623 0.03 Thu Jun 12 21:54:07 2008
624     * Mouse
625       - Add before/after/around, courtesy of Class::Method::Modifiers
626
627     * Mouse::Object
628       - Add support for ->new({...})
629       - Use compute_all_applicable_attributes in the constructor to get the
630         attributes of superclasses
631       - Add better support for undef init_arg
632
633     * Mouse::Meta::Class
634       - More methods: compute_all_applicable_attributes, has_attribute
635
636 0.02 Wed Jun 11 01:56:44 2008
637     * Squirrel
638       - Add Squirrel which acts as Moose if it's already loaded, otherwise
639         Mouse (thanks nothingmuch)
640
641     * Mouse::Meta::Object
642       - Fix the order in which BUILD methods are called (thanks Robert
643         Boone)
644
645 0.01 Tue Jun 10 02:13:21 2008
646     * Initial release.
647