C# 言語リファレンスが参照している言語仕様書が古い

Question

例えば、C# リファレンスの where のページ
http://msdn.microsoft.com/ja-jp/library/bb384067.aspx
の末尾には、

詳細については、「C# 言語仕様」の次のセクションを参照してください。

• 19.1.4 制約

とあります。

で、その「C# 言語仕様」を見ると、Visual Studio インストール ディレクトリ下にあると書かれている（ディレクトリが 1033 になっていますが、日本語版は 1041 です）ので、そのファイルを見ます。
すると、18章までしかなく、where に関しては 4.4.4 に記述があります。

なお、C# 言語仕様には、Visual C# Developer Centerから入手可能であるともありますが、Developer Center のトップページを見ても、ダウンロードページを見ても、どこにあるのかわかりません。
「ラーニング」の中の「言語」のページには、1.2と2.0の仕様書がありますが、3.0のものはありません。
が、2.0 の仕様書は 1.2 に対する差分となっており、章番号19～25が追加になっています。
where は 2.0 からの仕様ですので、この差分の方を見ると、確かに 19.1.4 に記述があります。

なお、1.2 の頃からある仕様でも、一本化されている方は内容が再編されているため章番号が変わっており、例えば abstract のページにある「1.6.5.4 仮想メソッド、オーバーライド メソッド、抽象メソッド」という記述も、一本化された方では 1.6.6.4 に移動になっています。

しかし、C# 言語仕様には、「以前の各バージョンの内容が 1 つのドキュメントに統合されています」とありますので、見るべきはインストール ディレクトリ下にある、18章までしかないものなのでしょう。

なお、これは誤訳ではなく、原版からの間違いです。
総点検をお願いします。

また、2010 βのドキュメントでも直っていません。
2010 はインストールしていないので、2010 のインストール ディレクトリ下にある仕様書は見ていませんが、もし 2010 でも再編が行われているなら、そちらも適切に修正して頂きたく存じます。

さて、参考までに。
どこからリンクが張られているのかわかりませんが、2.0 の仕様に対する差分として作られた 3.0 の仕様書が、
http://download.microsoft.com/download/B/6/C/B6C2DA74-08F9-4B18-BaB10-CF6DB1A5CFE2/csharp_30_specification.doc
からダウンロードできます。
これは差分ですから、章番号26として書かれており、これを読む限りは先の記述は正しいことになります。

なお、C#リファレンスの「クエリ キーワード」のあたりは、言語仕様書への参照が無くなってしまっています。
できればこれも追加して頂きたいです。

---

αετος(aetos)
Microsoft MVP for Visual C++ Feb 2008 - Jun 2010
http://www.aetosfolia.jp/
http://aetosfolia.spaces.live.com/
Microsoft Certified Technology Specialist
Microsoft Certified Associate

I bing. U bing ?

Answer 1

整理しますと、要望は以下の4点です。

1. C# 言語仕様のページで、ディレクトリ名が 1033 となっているので、1041 にして欲しい（日本語版のみ）
2. C# リファレンスが参照している言語仕様の章番号が古いものなので、3.0の一本化されたものの章番号を反映してほしい（原版から）
3. from句のような、3.0から追加されたキーワードについても、仕様書への参照を追加してほしい（原版から）
4. VS2010の言語仕様も再編されているなら、そちらも適切に修正してほしい（原版から）

---

αετος(aetos)
Microsoft MVP for Visual C++ Feb 2008 - Jun 2010
http://www.aetosfolia.jp/
http://aetosfolia.spaces.live.com/
Microsoft Certified Technology Specialist
Microsoft Certified Associate

I bing. U bing ?

Answer 2

詳細に調べていただきまして、どうもありがとうございます。
また、弊社のミスによりご迷惑をおかけしまして、大変申し訳ございません。

(1) につきましては、日本語版のバグとして登録いたしました。

(2)－(4) につきましては、英語の原文バグとして登録いたしました。（英語の原文が修正されますと、日本語の訳文も翻訳時に修正されるプロセスになっております。）


この投稿は現状のまま何の保証もなく掲載しているものであり、何らかの権利を許諾するものでもありません。コミュニティにおけるマイクロソフト社員による発言やコメントは、マイクロソフトの正式な見解またはコメントではありません。詳しくは http://www.microsoft.com/japan/communities/msp.mspx をご覧ください。