[ruby-core:81014] Re: [Ruby trunk Feature#13518] Indented multiline comments

On 7 May 2017 at 08:13, <[e-mail]> wrote:

> Issue #13518 has been updated by tscheingeld (Terry Scheingeld).
>
>
> duerst (Martin Dテシrst) wrote:
> > `=begin`/`=end` are rare, and it's better to make them stick out.
>
> I would make the case that `=begin`/`=end` is rare because it can't be
> indented. Multiline comments are very handy. It makes syntax highlighting
> much cleaner for embedded content (in my case, documentation) if every line
> doesn't have to start with a comment from the outer language.
>
> ----------------------------------------
> Feature #13518: Indented multiline comments
> https://bugs.ruby-lang.org/issues/13518#change-64677
>
> * Author: tscheingeld (Terry Scheingeld)
> * Status: Open
> * Priority: Normal
> * Assignee:
> * Target version:
> ----------------------------------------
> I'd like to submit the idea that multiline comments could be indented.
> That is, `=begin` and `=end` do not have to start at column zero. That
> would allow for more flexibility in documenting and commenting code.
>

窶汽oes anybody write actual POD in their =begin/=end blocks?

Personally, never use them to disable code because to my (Perl
programmer's) eye they're strictly for documentation.  And I don't use them
for that because RDoc does it differently.

Cheers
-- 
  Matthew Kerwin
  http://matthew.kerwin.net.au/

Unsubscribe: <mailto:[e-mail]?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-core>