ruby--ruby/spec/ruby/language
Nobuyoshi Nakada 4e038a7e64
Revert "parse.y: Deprecate flip-flops"
This reverts commit bae638ad5b.

[Feature #5400]
2019-07-11 14:52:02 +09:00
..
fixtures Update to ruby/spec@8d74d49 2019-06-27 21:02:36 +02:00
predefined
regexp Update to ruby/spec@8d74d49 2019-06-27 21:02:36 +02:00
shared
BEGIN_spec.rb
README
alias_spec.rb
and_spec.rb
array_spec.rb
block_spec.rb
break_spec.rb
case_spec.rb
class_spec.rb
class_variable_spec.rb
constants_spec.rb
def_spec.rb
defined_spec.rb
encoding_spec.rb Update to ruby/spec@8d74d49 2019-06-27 21:02:36 +02:00
ensure_spec.rb
execution_spec.rb
file_spec.rb
for_spec.rb
hash_spec.rb Update to ruby/spec@8d74d49 2019-06-27 21:02:36 +02:00
heredoc_spec.rb
if_spec.rb Revert "parse.y: Deprecate flip-flops" 2019-07-11 14:52:02 +09:00
lambda_spec.rb
line_spec.rb
loop_spec.rb
magic_comment_spec.rb
match_spec.rb
metaclass_spec.rb
method_spec.rb
module_spec.rb
next_spec.rb
not_spec.rb
numbers_spec.rb
optional_assignments_spec.rb
or_spec.rb
order_spec.rb
precedence_spec.rb
predefined_spec.rb
private_spec.rb
proc_spec.rb
range_spec.rb
redo_spec.rb
regexp_spec.rb
rescue_spec.rb
retry_spec.rb
return_spec.rb
safe_navigator_spec.rb Update to ruby/spec@6f38a82 2018-04-28 19:50:06 +00:00
safe_spec.rb
send_spec.rb
singleton_class_spec.rb
source_encoding_spec.rb
string_spec.rb Update to ruby/spec@8d74d49 2019-06-27 21:02:36 +02:00
super_spec.rb Update to ruby/spec@8d74d49 2019-06-27 21:02:36 +02:00
symbol_spec.rb Update to ruby/spec@8d74d49 2019-06-27 21:02:36 +02:00
throw_spec.rb
undef_spec.rb
unless_spec.rb
until_spec.rb
variables_spec.rb
while_spec.rb
yield_spec.rb Update to ruby/spec@9a501a8 2019-05-28 22:41:48 +02:00

README

There are numerous possible way of categorizing the entities and concepts that
make up a programming language. Ruby has a fairly large number of reserved
words. These words significantly describe major elements of the language,
including flow control constructs like 'for' and 'while', conditional
execution like 'if' and 'unless', exceptional execution control like 'rescue',
etc. There are also literals for the basic "types" like String, Regexp, Array
and Fixnum.

Behavioral specifications describe the behavior of concrete entities. Rather
than using concepts of computation to organize these spec files, we use
entities of the Ruby language. Consider looking at any syntactic element of a
Ruby program. With (almost) no ambiguity, one can identify it as a literal,
reserved word, variable, etc. There is a spec file that corresponds to each
literal construct and most reserved words, with the exceptions noted below.
There are also several files that are more difficult to classify: all
predefined variables, constants, and objects (predefined_spec.rb), the
precedence of all operators (precedence_spec.rb), the behavior of assignment
to variables (variables_spec.rb), the behavior of subprocess execution
(execution_spec.rb), the behavior of the raise method as it impacts the
execution of a Ruby program (raise_spec.rb), and the block entities like
'begin', 'do', ' { ... }' (block_spec.rb).

Several reserved words and other entities are combined with the primary
reserved word or entity to which they are related:

false, true, nil, self              predefined_spec.rb
in                                  for_spec.rb
then, elsif                         if_spec.rb
when                                case_spec.rb
catch                               throw_spec.rb