Project

General

Profile

Feature #7639

Updated by nobu (Nobuyoshi Nakada) about 5 years ago

=begin 
 When we chain methods with the period at the end of each line, we can put comments in between the lines: 

 ```ruby 
 

     [1, 2, 3]. 
 
     # First, we do blah blah 
 
     method1. 
 
     # Second, we do blah blah 
 
     method2. 
 
     =begin 
   
       Third, the following line 
   
       does this 
   
       and that ... 
 
     =end 
 
     method3 
 ``` 

 but when we have the period at the beginning of the line, putting comments in similar positions returns an error: 

 ```ruby 
 

     [1, 2, 3] 
 
     # First, we do blah blah 
 
     .method1 
 
     # Second, we do blah blah 
 
     .method2 
 
     =begin 
   
       Third, the following line 
   
       does this 
   
       and that ... 
 
     =end 
 
     .method3 

 

     # => Error 
 ``` 

 It is confusing that putting comments between lines in a method chain is sometimes allowed and sometimes not. I think it would be convenient if comments are allowed in these positions even when the following line starts with a period, and I request this as a feature. Currently, it returns an error, which means that, if such syntax were allowed, there would be no conflict with the existing syntax. 

 Furthermore, putting the period at the beginning of a line is suited for method chains because the period will visually work as bullets, and it makes more sense to have comments right before those lines. 
 =end 

Back