summaryrefslogtreecommitdiffstats
path: root/doc/NEWS
blob: b4445fa59fa2e3934f01df4a09429e1cf1a9407f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
= command line options

: -W option

  new option to specify warning level. -W0 to shut up warnings, -W1 for normal level,
  -W2 for verbose level.  -w equals to -W2.

= language syntax

: arbitrary delimited string array

  %W(...) notation, word list literal like %w(...) with the
  exception that #{} interpolation is allowed.

: arbitrary delimited symbol literl

  :"foo", :"foo#{bar}", etc.

: expression interpolation in strings

  Now arbitrary statements are allowed inside #{} interpolation
  without escapes.  In other hand, they can no longer access to
  variables defined in eval.

: negative number literals

  Digits preceded minus sign is a literal integer.

: array expansion

  Fixed with the following behavior:

    a = *[1]
    p a #=> [1]

  Now 1-element array in rhs is expanded properly.

    a = *[1]
    p a #=> 1

: break and next

  Extended to take an optional expression, which is used as a value
  for termination.

: direct assignment to Foo::Bar is allowed

  also, you can define "class Foo::Bar; end".

= language core

: $stdin, $stdout, $stderr

  can be assignable again.  the original stdio are preserved as STDIN,
  STDOUT, STDERR.

: $VERBOSE now has 3 levels

  nil - silence, false - medium (default), true - verbose

: allocation framework

  any instance of class can be allocated by class.allocate,
  (except for a few classes).

: comparison of exception classes in a rescue clause

  changed to use Module#=== for comparing $! with the exception
  class specified in each rescue clause.

  as the previous behavior was to use kind_of?, the effect is limited
  to the SystemCallError case.  SystemCallError.=== has been newly
  defined to return true when the two have the same errno.  With this
  change, SystemCallError's with the same errno, such as Errno::EAGAIN
  and Errno::EWOULDBLOCK, can both be rescued by listing just one of
  them.

: constants lookup

  improved at the performance of searching by using an internal hash
  table.

  calls const_missing method of the class/module, if constant is not
  found in the look up path.

: expression parenthesis in the first argument

  altered to get the following code (note the space after p):

    p ("xx"*2).to_i

  Interpreted as:

    p (("xx"*2).to_i)

  Instead of:

    (p("xx"*2)).to_i

: implicit comparison in conditional expressions

  Obsoleted except when it is used in -e.

  : between Range and $.
      Use explicit comparison instead.

  : between Regexp and $_
      Use the unary method ~/re/ instead.

: to_str

  added to get objects which define to_str() treated as String's.

  now almost all the built-in methods try each argument with to_str()
  when they expect it to be a String.

    foo = Object.new
    class <<foo
      def to_str
        "foo"
      end
    end
    p File.open(foo)
    => -:7:in `open': wrong argument type Object (expected String) (TypeError)
       ruby 1.6.4 (2001-04-19) [i586-linux]
    => -:7:in `open': No such file or directory - "foo" (Errno::ENOENT)
       ruby 1.7.0 (2001-05-02) [i586-linux]

: multiple assignment behavior

  Fixed so that "*a = nil" results in "a == []".

= changes in core class library

: open

  Extended so that when the third argument is permission flags it
  calls open(2) instead of fopen(3).

: sprintf

  new format specifier "%p" is available.

: lambda and proc

  Proc object returns from these methods has the following attributes:

  * strict argument number check
  * break and return terminates the proc execution.

: warn(message)

  a method to give warnings.

: abort()

  takes optional terminate message argument.

: Object#initialize_copy

  copy constructor for clone and dup.

: Object#instance_variable_set, Object#instance_variable_get

  added.

: Object#singleton_method_removed
: Object#singleton_method_undefined

  Added.

: Array#transpose

  added.

: Array#fetch(index [, default])

  Added.  If a default value isn't given, raises index error if index
  is out of range.

: Array#insert(n, other, ...)

  Added. [ruby-talk:14289]

  This is much the same as (({ary[n,0] = [other,...]})) except
  returing self.

    ary = [0,1,2,3]
    ary[2, 0] = [4, 5, 6]
    p ary

    ary = [0,1,2,3]
    ary.insert(2, 4, 5, 6)
    p ary

: Array#sort!

  Changed to always return self without checking whether the sequence
  of the elements was modified or not.

  Beware that this behavior is not guaranteed to continue in the
  future.  Do not rely on its return value. [ruby-dev:12506]

: Array#filter

  Previously deprecated, now removed.  Use Array#collect!.

: Array#pack, String#unpack

  Allows comment in template strings.

: Array#pack, String#unpack

  New templates 'q' and 'Q' for 64bit integer (signed and unsigned respectively).

: Array#new

  Now takes block to fill initial values.  E.g.

	Array.new(10) { |i| i + 1 }
	=> [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]

: Array#fill

  Takes block to get the values to fill.

: Array#fetch

  Takes block to get the default value.

: Array#zip

  added.

: Hash#update

  Takes block to resolve key conflict.

: Hash#merge and Hash#merge!

  update hash.  Hash#merge! is a synonym of Hash#update.

: String#split

  if "sep" argument is a string, regular expression meta characters
  are escaped internally.

: String#rstrip

  chop off NULs at the end of strings.

: String#to_i

  Now accepts optional base argument.

	"101".to_i(10) => 101
	"101".to_i(2)  => 5
	"101".to_i(8)  => 65
	"101".to_i(16) => 257

  A base argument of 0 guesses at the base.

	"101".to_i(0)   => 101
	"0b101".to_i(0) => 5
	"0101".to_i(0)  => 65
	"0x101".to_i(0) => 257

: String#[regexp, nth]

  Extended to accepts optional second argument.

  It tries match between self and REGEXP, then returns the
  content of the NTH regexp register.

: String#casecmp

  Added.  This is a case insensitive version of String#<=>.

: String#chomp

  If $/ == "\n", chops off last newlines (any of \n, \r, \r\n).

: String#eql?

  Changed to be always case sensitive.

: String#insert(n, other)

  Added.

  This is much the same as (({str[n, 0] = other})) except returing
  self.

: String#lstrip, rstrip, lstrip!, rstrip!

  Added.  These strip only left or right part of a string.

: String#match

  Added.

: String/Array methods

  Returns an instance of receivers class.

: String.new

  The first argument becomes optional.

: Symbol#intern

  Added.

: Symbol.all_symbols

  Added. [ruby-dev:12921]

: IO

  64bit off_t support by Janathan Baker.

: IO#read
: IO#sysread

  takes optinal second argument for read buffer.

: IO::sysopen

  New method to get a raw file descriptor.

: IO#sysseek

  Added.

: IO#fsync

  new method that copies all in-memory parts of a file to disk and
  waits until the device reports that all parts are on stable storage.
  Implemented with fsync(2) or equivalent.

: IO.open

  Made public.  Can only associate an IO object with a file number
  like IO.new and IO.for_fd, but can take a block.

: IO.for_fd

  Added as a synonym for IO.new.

: IO.read

  Added.  Like IO.readlines, except it returns the entire file as a
  string.  [ruby-talk:9460]

: File#fnmatch, File::Constants::FNM_*

  Added.  Refer to the fnmatch(3) manpage for details.

  Localism is FNM_DOTMATCH which has the opposite meaning of the
  commonly known FNM_PERIOD, which does not exist in Ruby.

  e.g.

    # exclude files matching "*.bak" case-insensitively.
    files.reject! {|fn| File.fnmatch?("*.bak", fn, File::FNM_CASEFOLD) }

: File.lchmod
: File.lchown

  Added.

: File.open, IO.open

  File mode can be specified by flags like open(2),
  e.g. File::open(path, File::CREAT|File::WRONLY).

: Regexp#options

  Added.

: Regexp.last_match(n)

  Extended to take an optional argument.

: MatchData#captures

  added.

: Dir#path

  Added.

: Dir.chdir

  Extended to take a block.

: Dir.glob

  Made to support meta-character escaping by a backslash.  Wildcards
  and spaces may now be escaped using a backslash.

: Dir.open

  Changed to return what the block returns when a block is given, just
  as File.open does. (It always returned (({nil})) in 1.6 and
  prior)

: Dir.chdir

  Changed to warn only when invoked from multiple threads or no block
  is given. [ruby-dev:13823]

    Dir.chdir('foo') {
      Dir.chdir('bar') {   # previously warned
        puts Dir.pwd
      }
    }

: Dir#pos=

  Returns the new position instead of self.

: Dir::glob

  Now accepts optional FNM_* flags via the second argument, whereas
  Dir::[] doesn't.

    Dir.glob("makefile", File::FNM_CASEFOLD) #=> ['Makefile', 'makefile']

: Class#inherited

  Method is called when Class is inherited by another class.

	class A; end
	def A.inherited(by)
          puts "A inherited by #{by.inspect}"
        end
        class B < A; end

        Prints out "A inherited by B"

: Module#include?

  Added. [ruby-dev:13941] 

: Module#included

  Added.  This is a hook called after Module#append_feature.

: Module#method_removed
: Module#method_undefined

  Added.

: Module.new, Class.new

  Extended to take block.

: Time

  Extended to accept a negative time_t. (Only when the platform
  supports it)

    p Time.at(-1)
    => Thu Jan 01 08:59:59 JST 1970

: Time#to_a
: Time#zone

  Made to return "UTC" under gmtime.  It used to return a platform
  dependent value, typically "GMT", in 1.6 and prior.

: Marshal to use marshal_dump and marshal_load

  if a dumping object responds to 'marshal_dump', Marshal.dump calls
  it, and dumps object returned.  Marshal.load allocates a new instance
  using "allocate", then calls its "marshal_load" with dumped data.
  Marshal format version is now 4.8 (was 4.6 in 1.6.8).

: Marshal

  Fixed not to dump anonymous classes/modules.

  Fixed with loading modules.

: Thread#group

  new method to get belonging  ThreadGroup.

: Thread#terminate

  synonym of Thread#exit

: Thread#join

  Optional argument limits maximum time to wait the thread in second.
  And returns nil if timed out.

: ThreagGroup#enclose

  prohibits thread movement from/to enclosed groups.

: Range#step([step=1])

  Added.

: SystemCallError

  SystemCallError's "===" match (used in rescue also) is now based on its errno.

: Interrupt

  Made a subclass of SignalException. (It was a subclass of
  Exception in 1.6 and prior)

: NameError and NoMethodError

  Moved and now NoMethodError < NameError < StandardError.

: NoMethodError

  Added. [ruby-dev:12763]

: NotImplementError

  Finally obsoleted.  Use NotImplementedError.

: SystemCallError.===

  Added. (See the "Comparison of exception classes in a rescue clause"
  paragraph above) [ruby-dev:12670]

: SystemExit#status

  Added.

: Proc#==

  Added.

: Method#==

  Added.

: UnboundMethod is no longer subclass of Method

  class hierarchy changed. 

: Enumerable#all?
: Enumerable#any?
: Enumerable#inject
: Enumerable#sort_by

  Added.

: Math.acos(x)
: Math.asin(x)
: Math.atan(x)
: Math.cosh(x)
: Math.hypot(x,y)
: Math.sinh(x)
: Math.tanh(x)

  Added.

: Process.abort
: Process.exit

  synonym of Kernel#abort, and Kernel#exit respectively.

: Process::detach(pid)

  new method to detach child process.  child process will be "wait"ed
  automagically.

: Process.times

  Moved from Time.times. (Time.times still remains but emits a
  warning)

: Process.waitall

  Added.

: Process::Status

  Added.  (({$?})) is now an instance of this class.

: Process::UID, Process::GID, Process::Sys,

  Added.

: Signal

  Added. This module has module functions Signal.trap and Signal.list.

= changes in bundled libraries

: lib/cgi.rb

  cgi[name] returns CGI::QueryExtension::Value that wraps string
  value, no longer array.

: lib/timeout

  timeout "function" wrapped in Timeout module.

: TCPServer#accept, UNIXServer#accept, Socket#accept

  New methods to return an accepted socket fd.

: Date and DateTime

  lib/date.rb now provides both Date and DateTime.

  Some methods have been renamed.  But the old names are still alive.

  Some new methods have been added (Date::parse, Date#strftime, etc.).

  Date#mjd now returns the chronological modified Julian day number.

  All facilities about tjd have been removed.

: Curses

  Updated.  New methods and constants for using the mouse, character
  attributes, colors and key codes have been added.

: Net::HTTP

  New version of Net::HTTP has introduced seriously incompatible
  changes. For details, see document embedded in net/http.rb itself.

: Socket.pack_sockaddr_in, Socket.unpack_sockaddr_in

  Added.  Utility for direct Socket access.

: Socket.pack_sockaddr_un, Socket.unpack_sockaddr_un

  Added.  Utility for direct Socket access.

: TCPServer#listen, UNIXServer#listen

  Added.

: TCPSocket.new
: TCPSocket.open

  Extended to take an address and a port number for the local side in
  optional 3rd and 4th arguments.

= newly bundled library

: ext/bigdecimal

  variable precision decimal number 

: ext/dl

  an interface to the dynamic linker.

: ext/enumerator

  a helper module for the Enumerable interface.

: ext/io/wait

  IO wait methods.

: ext/iconv

  wrapper library of (({iconv})).

: ext/openssl

  OpenSSL for Ruby

: ext/racc/cparse

  Racc runtime library in C. (Racc is a parser generator for ruby)

: ext/stringio

  Pseudo (({IO})) class from/to (({String})).

: ext/strscan

  Fast string scanner library.

: ext/syck

  fast YAML parser.

: lib/abbrev

  creates an abbreviation table from a list

: lib/benchmark

  Ruby scripts benchmarker

: lib/cgi/session/pstore

  cgi/session back-end using pstore 

: lib/csv

  reads/writes CSV files.

: lib/date/format

  strftime for Date class

: lib/drb

  dRuby or distributed Ruby

: lib/fileutils

  file utility library.

: lib/generator

  converts an internal iterator to an external iterator

: lib/gserver

  generic server used by xmlrpc

: lib/ipaddr

  manipulates IP address.

: lib/multi-tk

  to allow safe Tk, etc.

: lib/open-uri

  easy-to-use wrapper for net/http and net/ftp

: lib/optparse

  command line options utility library

: lib/pathname

  handles pathname in OO manner.

: lib/pp

  prettyprinter for Ruby objects

: lib/prettyprint

  implements prettyprint algorithm.

: lib/profiler

  library to implement -r "profile"

: lib/racc/parser

  RACC parser generator runtime in Ruby.

: lib/scanf

  scan string and retrieve object with format

: lib/set

  Set class

: lib/runit

  RubyUnit compatible layer for test/unit

: lib/test/unit

  unit testing framework for Ruby

: lib/tmpdir

  get temporary directory path.

: lib/tsort

  topological sorting library.

: lib/rexml

  REXML XML library

: lib/webrick

  generic internet server kit

: lib/xmlrpc

  simple RPC via XML

: lib/un

  used like 'ruby -run -e cp -- -p foo bar'.  neat, isn't it?

: lib/win32/registry

  win32/registry is registry accessor

: lib/yaml

  YAML Ain't Mark-up Language

= removed libraries

: lib/ftplib

  use net/ftp instead.

: lib/telnet

  use net/telnet instead.

= new port

: WindowsCE port
: Win32 BCC

= interpreter implementation

: garbage collector

  faster, but uses more memory for the worst case.

: string concatenation

  faster by avoiding too frequent realloc(3).