[ruby-dev:39533] [Bug #2263] typo in man/ruby.1

[Tim Pease-3]

Bug #2263: typo in man/ruby.1
http://redmine.ruby-lang.org/issues/show/2263

起票者: Narihiro Nakamura
ステータス: Open, 優先度: Normal
ruby -v: ruby 1.8.7 (2008-08-11 patchlevel 72) [i486-linux]

nariです。

今日、とある方から「manの表示が間違ってませんか？」というご指摘を受けました。
確認してみた所、セーフレベルのデフォルト値がおかしいようです。

 $ man ruby
 (snip)
     -T[level]      Turns on taint checks at the specified level (default 1).

上記の部分は"(default 0)"ではないでしょうか？

以下は修正用のパッチです。

Index: man/ruby.1
===================================================================
--- man/ruby.1  (リビジョン 25452)
+++ man/ruby.1  (作業コピー)
@@ -206,7 +206,7 @@
 .Ed
 .Pp
 .It Fl T Ns Op Ar level
-Turns on taint checks at the specified level (default 1).
+Turns on taint checks at the specified level (default 0).
 .Pp
 .It Fl U
 Sets the defalut value for internal encodings


----------------------------------------
http://redmine.ruby-lang.org

[Yusuke ENDOH]

遠藤です。

2009年10月25日0:31 Narihiro Nakamura <redmine@...>:
> 今日、とある方から「manの表示が間違ってませんか？」というご指摘を受けました。
> 確認してみた所、セーフレベルのデフォルト値がおかしいようです。
>
>  $ man ruby
>  (snip)
>     -T[level]      Turns on taint checks at the specified level (default 1).
>
> 上記の部分は"(default 0)"ではないでしょうか？


その default は -T[level] の level を省略した場合のデフォルト値を
指してるんじゃないかと思います。

$ cat t.rb
p $SAFE

$ ruby19 -T t.rb
1

$ ruby19 -T2 t.rb
2

--
Yusuke ENDOH <mame@...>

[Yukihiro Matsumoto]

まつもと ゆきひろです

In message "Re: [ruby-dev:39533] [Bug #2263] typo in man/ruby.1"
    on Sun, 25 Oct 2009 00:31:59 +0900, Narihiro Nakamura <redmine@...> writes:

|今日、とある方から「manの表示が間違ってませんか？」というご指摘を受けました。
|確認してみた所、セーフレベルのデフォルト値がおかしいようです。

コミットしてください。

[Yukihiro Matsumoto]

まつもと ゆきひろです

In message "Re: [ruby-dev:39534] Re: [Bug #2263] typo in man/ruby.1"
    on Sun, 25 Oct 2009 00:39:49 +0900, Yusuke ENDOH <mame@...> writes:

|>     -T[level]      Turns on taint checks at the specified level (default 1).
|>
|> 上記の部分は"(default 0)"ではないでしょうか？
|
|その default は -T[level] の level を省略した場合のデフォルト値を
|指してるんじゃないかと思います。

あ、そうか。さっきの「コミットしてください」は撤回します。
なお、よりよい文面の提案は歓迎します。

[Yugui (Yuki Sonoda)]

Yugui@メンテナ です。

2009年10月25日1:39 Yukihiro Matsumoto <matz@...>:
> |その default は -T[level] の level を省略した場合のデフォルト値を
> |指してるんじゃないかと思います。
>
> あ、そうか。さっきの「コミットしてください」は撤回します。
> なお、よりよい文面の提案は歓迎します。

はい。そういうことだと理解してます。より良い文言の提案は歓迎します。

--
Yuki Sonoda (Yugui)
yugui@...
http://yugui.jp

[Tim Pease-3]

チケット #2263 が更新されました。 (by Hiro Asari)


-T[level] Turns on taint checking by setting $SAFE to 'level' (to 1 if 'level' is omitted)

というような感じではどうですか。ちょっと長過ぎますね。
----------------------------------------
http://redmine.ruby-lang.org/issues/show/2263

----------------------------------------
http://redmine.ruby-lang.org

[Yusuke ENDOH]

遠藤です。

2009年10月25日11:01 Yugui <yugui@...>:

> Yugui@メンテナ です。
>
> 2009年10月25日1:39 Yukihiro Matsumoto <matz@...>:
>> |その default は -T[level] の level を省略した場合のデフォルト値を
>> |指してるんじゃないかと思います。
>>
>> あ、そうか。さっきの「コミットしてください」は撤回します。
>> なお、よりよい文面の提案は歓迎します。
>
> はい。そういうことだと理解してます。より良い文言の提案は歓迎します。

man はともかく -help の -W[level] の説明が 80 文字に収まってないのですが、
もう諦めたんでしょうか。そこで

  -T[level=1]     turn on tainting checks
  -W[level=2]     set warning level; 0=silence, 1=medium, 2=verbose

というのはどうでしょうか。短い上にオプショナル引数っぽくてわかりやすいと
思います。

--
Yusuke ENDOH <mame@...>

[Yukihiro Matsumoto]

まつもと ゆきひろです

In message "Re: [ruby-dev:39539] Re: [Bug #2263] typo in man/ruby.1"
    on Sun, 25 Oct 2009 11:15:17 +0900, Yusuke ENDOH <mame@...> writes:

|man はともかく -help の -W[level] の説明が 80 文字に収まってないのですが、
|もう諦めたんでしょうか。そこで
|
|  -T[level=1]     turn on tainting checks
|  -W[level=2]     set warning level; 0=silence, 1=medium, 2=verbose
|
|というのはどうでしょうか。短い上にオプショナル引数っぽくてわかりやすいと
|思います。

なる。コミットしてくださいませんか？

[Hideo Konami]

小波です。

>In message "Re: [ruby-dev:39539] Re: [Bug #2263] typo in man/ruby.1"
>    on Sun, 25 Oct 2009 11:15:17 +0900, Yusuke ENDOH <mame@...> writes:
>
>|man はともかく -help の -W[level] の説明が 80 文字に収まってないのですが、
>|もう諦めたんでしょうか。そこで
>|
>|  -T[level=1]     turn on tainting checks
>|  -W[level=2]     set warning level; 0=silence, 1=medium, 2=verbose

英語的には silence -> silent が正しいのではないですかね。　もっとも，ど
っちかというと quiet のほうがいいように思います。

[Yusuke ENDOH]

遠藤です。

2009年10月26日7:57 Hideo Konami <konami@...>:

>>In message "Re: [ruby-dev:39539] Re: [Bug #2263] typo in man/ruby.1"
>>    on Sun, 25 Oct 2009 11:15:17 +0900, Yusuke ENDOH <mame@...> writes:
>>
>>|man はともかく -help の -W[level] の説明が 80 文字に収まってないのですが、
>>|もう諦めたんでしょうか。そこで
>>|
>>|  -T[level=1]     turn on tainting checks
>>|  -W[level=2]     set warning level; 0=silence, 1=medium, 2=verbose
>
> 英語的には silence -> silent が正しいのではないですかね。　もっとも，ど
> っちかというと quiet のほうがいいように思います。

そこは原文を変えなかっただけです。確かに quiet の方が自然な気がしますが、
silence は -W が導入された 2003 年以来の表現で、今まで native から指摘
されたことがなかったというのも不思議ですね。あきらめられてるのかな。

ruby-core で「--help や man を校正してくれ」って言ってみましょうか。

--
Yusuke ENDOH <mame@...>

[Tim Pease-3]

チケット #2263 が更新されました。 (by Yui NARUSE)

カテゴリ DOCにセット
ステータス OpenからClosedに変更

fixed by r25486
----------------------------------------
http://redmine.ruby-lang.org/issues/show/2263

----------------------------------------
http://redmine.ruby-lang.org