Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

[インデックス 12761] ファイルの概要

このコミットは、Go言語の公式ドキュメントである doc/install.html ファイルに変更を加えています。具体的には、Windows環境におけるGoのインストール方法に関する記述が更新されています。

コミット

  • コミットハッシュ: 1b89d514d7d03c1c446df1fb8d4be511b34d3163
  • 作者: Andrew Gerrand adg@golang.org
  • コミット日時: 2012年3月27日 火曜日 11:19:30 +1100
  • コミットメッセージ: 
    doc: describe the Windows MSI installer as experimental

R=golang-dev, r
CC=golang-dev
https://golang.org/cl/5921043

GitHub上でのコミットページへのリンク

https://github.com/golang/go/commit/1b89d514d7d03c1c446df1fb8d4be511b34d3163

元コミット内容

    doc: describe the Windows MSI installer as experimental
    
    R=golang-dev, r
    CC=golang-dev
    https://golang.org/cl/5921043

変更の背景

このコミットの主な目的は、Go言語のWindows向けMSIインストーラーのステータスを明確にすることです。コミットメッセージにある「experimental（実験的）」という記述から、当時のMSIインストーラーはまだ開発途上であり、完全に安定しているとは言えない状態であったことが伺えます。

Goプロジェクトは、ユーザーに対して、このインストール方法がまだ試用段階であり、潜在的な問題や将来的な変更がある可能性を伝える必要がありました。これにより、ユーザーは期待値を適切に設定し、より安定したインストール方法（この場合はzipアーカイブ）を優先的に検討できるようになります。また、ドキュメント内でzipアーカイブのセクションをMSIインストーラーのセクションよりも前に配置することで、推奨されるインストール方法の順序を暗黙的に示しています。

前提知識の解説

このコミットの変更内容を理解するためには、以下の技術的背景知識が役立ちます。

  • Go (Golang): Googleによって開発されたオープンソースのプログラミング言語です。シンプルさ、効率性、信頼性を重視しており、特に並行処理のサポートが強力です。システムプログラミング、Webサービス、CLIツールなど幅広い分野で利用されています。
  • MSI Installer: Microsoft Windows Installerの略で、Windowsオペレーティングシステム上でソフトウェアのインストール、メンテナンス、削除を行うための標準的なパッケージ形式です。通常、グラフィカルユーザーインターフェース（GUI）を備えたウィザード形式でインストールが進行し、環境変数の設定やレジストリの変更などを自動的に行ってくれます。ユーザーにとっては手軽にソフトウェアを導入できるメリットがあります。
  • Zip Archive: 複数のファイルやディレクトリを1つのファイルに圧縮してまとめたものです。Windowsでは標準機能で展開（解凍）できます。ソフトウェアの配布によく用いられますが、MSIインストーラーとは異なり、環境変数の設定やパスの追加といったセットアップ作業はユーザーが手動で行う必要がある場合が多いです。
  • PATH環境変数: オペレーティングシステムが実行可能ファイル（コマンド）を探す際に参照するディレクトリのリストです。Goのbinディレクトリ（例: c:\Go\bin）をPATHに追加することで、コマンドプロンプトのどのディレクトリからでもgoコマンド（go build, go runなど）を実行できるようになります。
  • GOROOT環境変数: Goのインストールディレクトリのパスを示す環境変数です。Goツールチェイン（コンパイラ、リンカなど）がGoの標準ライブラリやツールを見つけるために使用します。通常、Goがインストールされているルートディレクトリ（例: c:\Go）に設定されます。

技術的詳細

このコミットは、doc/install.htmlという単一のHTMLドキュメントファイルを変更しています。変更の核心は、WindowsにおけるGoのインストール手順に関する記述の順序と表現の調整です。

  1. セクションの順序変更:

    • 変更前は、「MSIインストーラー」に関するセクション（<h4 id="windows_msi">MSI installer</h3>）が「Zipアーカイブ」に関するセクション（<h4 id="windows_zip">Zip archive</h3>）よりも先に記述されていました。
    • このコミットにより、これらのセクションの順序が入れ替わり、「Zipアーカイブ」のセクションが先に、その後に「MSIインストーラー」のセクションが来るようになりました。これは、Zipアーカイブによるインストールが、より標準的または推奨される方法であることを示唆しています。

  2. 「experimental（実験的）」の明記:

    • 「MSIインストーラー」のセクション見出しが、<h4 id="windows_msi">MSI installer</h3> から <h4 id="windows_msi">MSI installer (experimental)</h3> へと変更されました。これにより、MSIインストーラーが「実験的」な機能であることが明示的にユーザーに伝えられます。
    • 同様に、導入部の説明文も変更されています。
      • 変更前: an MSI installer that configures your installation automatically, and a zip archive that requires you to set some environment variables.
      • 変更後: a zip archive that requires you to set some environment variables and an experimental MSI installer that configures your installation automatically. この変更により、Zipアーカイブが先に言及され、MSIインストーラーが「実験的」であるという情報が追加されています。

これらの変更は、Goのインストール方法に関するユーザーの認識と期待を管理するための純粋なドキュメントの更新であり、Goのソースコードやビルドプロセス自体には影響を与えません。

コアとなるコードの変更箇所

diff --git a/doc/install.html b/doc/install.html
index 1c8f9942f3..ad3eaf338b 100644
--- a/doc/install.html
+++ b/doc/install.html
@@ -125,38 +125,38 @@ Terminal sessions for the change to take effect.
 <p>
 The Go project provides two installation options for Windows users
 (besides <a href="/doc/install/source">installing from source</a>):
-an MSI installer that configures your installation automatically,
-and a zip archive that requires you to set some environment variables.
+a zip archive that requires you to set some environment variables and an
+experimental MSI installer that configures your installation automatically.
 </p>
  
-<h4 id="windows_msi">MSI installer</h3>
+<h4 id="windows_zip">Zip archive</h3>
  
 <p>
-Open the <a href="http://code.google.com/p/go/downloads/list?q=OpSys-Windows+Type%3DInstaller">MSI file</a>
-and follow the prompts to install the Go tools.
-By default, the installer puts the Go distribution in <code>c:\Go</code>.
+Extract the <a href="http://code.google.com/p/go/downloads/list?q=OpSys-Windows+Type%3DArchive">zip file</a>
+to the directory of your choice (we suggest <code>c:\Go</code>).
 </p>
  
 <p>
-The installer should put the <code>c:\Go\bin</code> directory in your
-<code>PATH</code> environment variable. You may need to restart any open
-command prompts for the change to take effect.
+If you chose a directory other than <code>c:\Go</code>, you must set
+the <code>GOROOT</code> environment variable to your chosen path.
 </p>
  
-<h4 id="windows_zip">Zip archive</h3>
-\n <p>
-Extract the <a href="http://code.google.com/p/go/downloads/list?q=OpSys-Windows+Type%3DArchive">ZIP file</a>
-to the directory of your choice (we suggest <code>c:\Go</code>).\n+Add the <code>bin</code> subdirectory of your Go root (for example, <code>c:\Go\bin</code>) to to your <code>PATH</code> environment variable.\n </p>\n \n+<h4 id="windows_msi">MSI installer (experimental)</h3>\n+\n <p>\n-If you chose a directory other than <code>c:\Go</code>, you must set\n-the <code>GOROOT</code> environment variable to your chosen path.\n+Open the <a href="http://code.google.com/p/go/downloads/list?q=OpSys-Windows+Type%3DInstaller">MSI file</a>\n+and follow the prompts to install the Go tools.\n+By default, the installer puts the Go distribution in <code>c:\Go</code>.\n </p>\n \n <p>\n-Add the <code>bin</code> subdirectory of your Go root (for example, <code>c:\Go\bin</code>) to to your <code>PATH</code> environment variable.\n+The installer should put the <code>c:\Go\bin</code> directory in your\n+<code>PATH</code> environment variable. You may need to restart any open\n+command prompts for the change to take effect.\n </p>\n \n <h4 id=\"windows_env\">Setting environment variables under Windows</h4>\n```

## コアとなるコードの解説

上記の差分は、`doc/install.html` ファイルに対する以下の主要な変更を示しています。

1.  **導入部の説明の変更**:
    *   `- an MSI installer that configures your installation automatically, and a zip archive that requires you to set some environment variables.`
    *   `+ a zip archive that requires you to set some environment variables and an experimental MSI installer that configures your installation automatically.`
    この変更により、Windowsのインストールオプションの紹介順序が「zipアーカイブ」が先になり、MSIインストーラーが「実験的」であるという記述が追加されました。

2.  **セクション見出しの順序と内容の変更**:
    *   `- <h4 id="windows_msi">MSI installer</h3>` が削除され、その内容が下部に移動しました。
    *   `+ <h4 id="windows_zip">Zip archive</h3>` が追加され、Zipアーカイブに関する説明がこの見出しの下に移動しました。
    *   `- <h4 id="windows_zip">Zip archive</h3>` が削除され、その内容が上部に移動しました。
    *   `+ <h4 id="windows_msi">MSI installer (experimental)</h3>` が追加され、MSIインストーラーに関する説明がこの見出しの下に移動し、見出しに「(experimental)」が追加されました。

これらの変更は、HTMLドキュメントの構造とテキストコンテンツを直接修正するものです。Goのインストール手順に関する情報の提示方法を改善し、特にMSIインストーラーのステータスに関するユーザーの誤解を防ぐことを目的としています。

## 関連リンク

*   **Go Code Review (Gerrit)**: このコミットの元となったコードレビューのリンクです。開発プロセスにおける議論や追加のコンテキストを確認できます。
    [https://golang.org/cl/5921043](https://golang.org/cl/5921043)
*   **Go Downloads List (Windows MSI)**: 当時のGoのダウンロードページで、Windows向けMSIインストーラーがリストされていた場所へのリンクです。
    [http://code.google.com/p/go/downloads/list?q=OpSys-Windows+Type%3DInstaller](http://code.google.com/p/go/downloads/list?q=OpSys-Windows+Type%3DInstaller)
*   **Go Downloads List (Windows Archive)**: 当時のGoのダウンロードページで、Windows向けZipアーカイブがリストされていた場所へのリンクです。
    [http://code.google.com/p/go/downloads/list?q=OpSys-Windows+Type%3DArchive](http://code.google.com/p/go/downloads/list?q=OpSys-Windows+Type%3DArchive)

## 参考にした情報源リンク

*   提供されたコミットデータ (`./commit_data/12761.txt`)
*   Go言語の公式ドキュメントおよび一般的なソフトウェアインストールの概念に関する知識