Ruby "man"文档-使用 "\"的多行注释？

Question

我正在阅读 Ruby 的“man”页面，我看到以下“-S”标志的描述:

-S   Makes Ruby use the PATH environment variable to search for script, unless its name begins with a slash.  This is used to emulate #! on
     machines that don't support it, in the following manner:

           #! /usr/local/bin/ruby
           # This line makes the next one a comment in Ruby \
           exec /usr/local/bin/ruby -S $0 $*

     On some systems $0 does not always contain the full pathname, so you need the -S switch to tell Ruby to search for the script if necessary
     (to handle embedded spaces and such).  A better construct than $* would be ${1+"$@"}, but it does not work if the script is being
     interpreted by csh(1).

我感到困惑的部分是这部分:

# This line makes the next one a comment in Ruby \
exec /usr/local/bin/ruby -S $0 $*

这听起来像 man 条目是说 \ 字符导致其后面的行被视为注释。

为了测试这一点，我尝试制作一个名为“foo.rb”的新 Ruby 脚本，其中包含这两行和一个简单的“puts”语句:

# This line makes the next one a comment in Ruby \
exec /usr/bin/env ruby -S $0 $*

puts "Hi"

我将脚本从 /usr/local/bin/ruby 更改为 /usr/bin/env ruby​​ 因为我没有 ruby 可执行文件位于 /usr/local/bin。我认为这不会以有意义的方式影响结果，因为(根据文档)该行应该被视为注释，而不是可执行代码。

如果我对 man 条目的解释是正确的，那么当我运行“ruby foo.rb”时，我希望在终端上看到 Hi 输出。但事实并非如此。相反，我看到以下内容:

$ ruby foo.rb
foo.rb:2: unknown regexp option - b
exec /usr/bin/env ruby -S $0 $*
foo.rb:2: syntax error, unexpected local variable or method, expecting `do' or '{' or '('
exec /usr/bin/env ruby -S $0 $*
foo.rb:2: syntax error, unexpected global variable, expecting `do' or '{' or '('
exec /usr/bin/env ruby -S $0 $*

我做错了什么？

Answer 1

Ruby 手册页的这个特定部分似乎已经严重过时了。事实上，最初是添加的in the first (data) commit到 Ruby(当时)的 SVN 存储库。

当时，显然 Ruby 的解析器做了 indeed support注释末尾带有反斜杠的续行，如手册页的语法示例所示。

但是，此功能已于 1999 年 3 月 2 日从 Ruby 中删除 SVN revision 520 (差异相当大，并且在 GitHub 中默认不渲染；检查 parse.y 文件的第 2433 行)。

ChangeLog entry该更改如下:

Tue Mar  2 17:04:19 1999  Yukihiro Matsumoto  <<a href="https://stackoverflow.com/cdn-cgi/l/email-protection" class="__cf_email__" data-cfemail="ddb0bca9a79db3b8a9b1bcbff3beb2f3b7ad" rel="noreferrer noopener nofollow">[email protected]</a>>

    * parse.y (yylex): backslashes do not concatenate comment lines
      anymore.

此更改于 1999 年 8 月随 Ruby 1.4.0 一起发布。从那时起，距今已有 24 年多了，手册页中的示例不再起作用。

后来的(但仍然很旧)文档 suggests a different approach :

#!/bin/sh
exec ruby -S -x $0 "$@"
#! ruby
puts 'Hello World'

这里，exec 始终被执行，并且您仍然使用 -S 标志在 Ruby 解释器中执行当前文件。但是，我们还使用 -x 标志，指示 Ruby 跳过文件中的所有行，直到找到包含 #!ruby 的行(或者显然是 #! ruby )。这在今天仍然有效。