|
| 1 | + |
| 2 | + Git installation |
| 3 | + |
| 4 | +通常は、「make」の後に「make install」を実行するだけで、gitプログラムがあなたの ~/bin/ |
| 5 | +ディレクトリにインストールされます(訳注: ~/share も使う)。グローバルインストールを実行する場合は、以下のようにすることができます。 |
| 6 | + |
| 7 | + $ make prefix=/usr all doc info ;# as yourself |
| 8 | + # make prefix=/usr install install-doc install-html install-info ;# as root |
| 9 | + |
| 10 | +(もちろん、 prefix=/usr/local でもOK)。 $prefix を使用する他のプログラム・スイートと同様に、 ビルドされた結果には、 |
| 11 | +$prefixから派生したいくつかのパスが埋め込まれているため、「make all; make prefix=/usr install」は機能しません。 |
| 12 | + |
| 13 | +Makefileの冒頭には、gitの構築方法に影響を与える多くの変数が記載されています。 |
| 14 | +これらは、コマンドラインまたはconfig.makファイルからオーバーライドできます。 |
| 15 | + |
| 16 | +または、autoconfで生成された ./configure |
| 17 | +スクリプトを使用してインストールパスを設定することもできます(config.mak.autogenを介して)。代わりに以下のように記述できます。 |
| 18 | + |
| 19 | + $ make configure ;# as yourself |
| 20 | + $ ./configure --prefix=/usr ;# as yourself |
| 21 | + $ make all doc ;# as yourself |
| 22 | + # make install install-doc install-html;# as root |
| 23 | + |
| 24 | +ビルド時間を（はるかに）長くして、後で高速なgitとトレードオフする場合は、以下のようにプロファイルフィードバックビルド(profile |
| 25 | +feedback build)を実行することもできます。 |
| 26 | + |
| 27 | + $ make prefix=/usr profile |
| 28 | + # make prefix=/usr PROFILE=BUILD install |
| 29 | + |
| 30 | +これにより、完全なテストスイートがトレーニングワークロード(training |
| 31 | +workload)として実行され、生成されたプロファイルフィードバック(profile feedback)を使用してgitが再構築されます。 |
| 32 | +これにより、CPUを集中的に使用するワークロードでgitが数パーセント高速になります。 |
| 33 | +これは、配布パッケージャーにとっては良いトレードオフになる可能性があります。 |
| 34 | + |
| 35 | +または、gitベンチマークスイート(git benchmark suite)でのみプロファイルフィードバック(profile |
| 36 | +feedback)を実行できます。 これは、完全なテストスイートよりも大幅に高速に実行されますが、カバレッジは低くなります。 |
| 37 | + |
| 38 | + $ make prefix=/usr profile-fast |
| 39 | + # make prefix=/usr PROFILE=BUILD install |
| 40 | + |
| 41 | +または、プロファイルに最適化されたバージョンのgitをホームディレクトリにインストールするだけの場合は、以下のコマンドを実行できます: |
| 42 | + |
| 43 | + $ make profile-install |
| 44 | + |
| 45 | +または |
| 46 | + $ make profile-fast-install |
| 47 | + |
| 48 | +警告: |
| 49 | +プロファイル最適化(profile-optimized)ビルドは、gitツリーを2回ビルドする必要があるため、「かなり」時間がかかります。プロファイリング測定を正しく機能させるには、ccacheを無効にし、テストスイートを単一のCPUのみを使用して実行する必要があります。さらに、プロファイルフィードバックビルドステージ(profile |
| 50 | +feedback build stage)は現在、多くの追加のコンパイラ警告を生成します。 |
| 51 | + |
| 52 | +注意事項: |
| 53 | + |
| 54 | + - GNU Interactive |
| 55 | + Toolsの古いバージョン（4.9.2より前）は、「git」という名前のプログラムをインストールしましたが、その名前はこのプログラムと競合しています。しかし、バージョン4.9.2では、アクティブなメンテナンスを行わずに長期間休止した後（1997年頃から）、名前がgnuitに変更され、もはや名前の競合は問題になりません。 |
| 56 | + |
| 57 | + 注 下位互換性オプションを使用してコンパイルした場合でも、 |
| 58 | + GNU Interactive Toolsパッケージは「git」をインストールできますが、 |
| 59 | + これを回避するために --disable-transition オプションを使用してビルドできます。 |
| 60 | + |
| 61 | + - ビルド後にはgitを使用できますが、テスト的に使用する場合はインストールせずに使用できます。ビルドディレクトリの bin-wrappers |
| 62 | + ディレクトリにあるgitを実行するか、そのディレクトリを $PATHの前に追加します(訳注:つまり、あなたの作業ツリー内で、 |
| 63 | + hogehoge/git/bin-wrappers/git version 等と実行できる)。 |
| 64 | + ただし、これはインストールされたgitを実行するよりも効率的ではありません。これは、gitサブコマンドを実行するために常に追加のfork+execが必要になるためです。 |
| 65 | + |
| 66 | + いくつかの環境変数を設定することで、インストールせずにgitを使用することも可能です。 |
| 67 | + 従来はこの方法でしたが、 |
| 68 | + ビルドディレクトリのbin-wrappersディレクトリにあるgitを使用する方がはるかに簡単です。 |
| 69 | + 歴史的な参考として書いておくと、 |
| 70 | + 古い方法は以下のとおりです: |
| 71 | + |
| 72 | + GIT_EXEC_PATH=`pwd` |
| 73 | + PATH=`pwd`:$PATH |
| 74 | + GITPERLLIB=`pwd`/perl/build/lib |
| 75 | + export GIT_EXEC_PATH PATH GITPERLLIB |
| 76 | + |
| 77 | + - (NO_PERLが指定されていない限り)デフォルトではGitはさまざまなperlスクリプトを出荷します。ただし、簡単にするために、 |
| 78 | + ExtUtils::MakeMaker |
| 79 | + ツールチェーンを使用してperlライブラリを配置する場所を決定することはありません。システムによっては、Git自体以外で使用されることが予想される場合、perlライブラリが希望する場所にない可能性があります。 |
| 80 | + |
| 81 | + これが気になる問題である場合、 perllibdir プレフィックスを手動で指定すると、 |
| 82 | + これが修正されます。例: |
| 83 | + |
| 84 | + prefix=/usr perllibdir=/usr/$(/usr/bin/perl -MConfig -wle 'print substr $Config{installsitelib}, 1 + length $Config{siteprefixexp}') |
| 85 | + |
| 86 | + そうすると結果は、例えば、Debianでは perllibdir=/usr/share/perl/5.26.1 で、 |
| 87 | + CentOSでは perllibdir=/usr/share/perl5 (これがデフォルトです)です。 |
| 88 | + |
| 89 | + - NO_PERLが指定されていない限り、Gitは必要なさまざまなperlライブラリを出荷します。 |
| 90 | + Gitのディストリビューターは、NO_PERLが指定されていない場合、Gitが必要とするCPANモジュールの独自のコピーを使用するために、通常はNO_PERL_CPAN_FALLBACKSを設定する必要があります。 |
| 91 | + |
| 92 | + - Gitは適度に自給自足ですが、いくつかの外部プログラムとライブラリに依存します。 |
| 93 | + makeコマンドラインまたはconfig.makファイルに適切な「NO_<LIBRARY>=YesPlease」を追加することで、Gitはそれらのほとんどを利用せずに使用できます。 |
| 94 | + |
| 95 | + - "zlib" 圧縮ライブラリ。Gitはこれなしでは構築できません。 |
| 96 | + |
| 97 | + - "ssh" は、ネット越しにプッシュおよびプルするために使用されます。 |
| 98 | + |
| 99 | + - POSIX準拠のシェル が、日々の使用に必要ないくつかのスクリプト(「bisect」、「request-pull」など)を実行するために必要です。 |
| 100 | + |
| 101 | + - 一部の機能を使用するには、「Perl」バージョン 5.26.0 以降が必要です(たとえば、「git |
| 102 | + send-email」を使用したパッチの送信、「git svn」を使用したsvnリポジトリーとの対話)。 |
| 103 | + これらがなくてもよい場合は、NO_PERLを使用してください。 |
| 104 | + Redhat/Fedoraの最近のリリースでは、一部のコア・モジュールが削除されたPerlバイナリパッケージが出荷されていると報告されているため(https://lwn.net/Articles/477234/を参照)、Perl自体以外の追加パッケージ、例えば |
| 105 | + Digest::MD5 や File::Spec や File::Temp や Net::Domain や Net::SMTP や |
| 106 | + Time::HiRes をインストールする必要がある場合があります。 |
| 107 | + |
| 108 | + - 「libcurl」ライブラリは、 http:// または https:// を介してリポジトリーをフェッチおよびプッシュするために使用されます。 |
| 109 | + また、 git-imap-send によって使用されます。その機能が必要ない場合は、NO_CURLを使用してそれ無しでビルドします。 |
| 110 | + |
| 111 | + GitをNO_CURL指定「なし」でビルドするには、 |
| 112 | + バージョン「7.61.0」以降の「libcurl」が必要です。 |
| 113 | + このバージョン要件は、将来的に引き上げられる可能性があります。 |
| 114 | + |
| 115 | + - 「expat」ライブラリ。git-http-pushがDAVを介したリモートロック管理に使用します。 |
| 116 | + 上記の「curl」と同様に、これはオプションです(必要無い場合はNO_EXPATを使用)。 |
| 117 | + |
| 118 | + - "wish" つまり、Tcl/Tk |
| 119 | + ウィンドウシェルは、履歴をグラフィカルに表示するためにgitkとgit-guiで使用されます。gitkまたはgit-guiが必要ない場合は、NO_TCLTKを使用できます。 |
| 120 | + |
| 121 | + - デフォルトでは、Gitをローカライズするためにgettextライブラリが使用されます。 主なターゲットはGNU |
| 122 | + libintlですが、Solarisのgettext実装も機能します。 |
| 123 | + |
| 124 | + システムにはCコード用のgettext.h、 |
| 125 | + シェルスクリプト用のgettext.sh(またはSolaris gettext(1))、 |
| 126 | + Perlプログラム用のlibintl-perlが必要です。 |
| 127 | + |
| 128 | + NO_GETTEXTを設定して、ローカライゼーションサポートを無効にし、 |
| 129 | + Gitが英語のみを使用するようにします。 |
| 130 | + autoconfの下で、configureスクリプトは、システム上でlibintlが見つからない場合、これを自動的に実行します。 |
| 131 | + |
| 132 | + - PERFORCEへのgit-p4インターフェースを使用するには、Pythonバージョン2.7以降が必要です。 |
| 133 | + |
| 134 | + - 一部のプラットフォーム固有の問題はMakefileルールで処理されますが、特定のインストールによっては、必要なすべてのライブラリ/ツールがない場合や、通常とは異なる場所に必要なライブラリがある場合があります。Makefileの冒頭を見て、ニーズに合わせて調整できるものを確認してください。ローカル設定をconfig.makに配置すると、Makefileにそれらが含まれます。注意: |
| 135 | + config.makは配布されないことに注意してください。ローカル設定での名前はローカル設定用に予約されています。 |
| 136 | + |
| 137 | + - ドキュメントスイートをビルドしてインストールするには、 asciidoc/xmlto ツールチェーンが必要です。 |
| 138 | + 多くの人がそのツールをインストールする傾向がないため、デフォルトのビルドターゲット（「make all」）はドキュメントスイートをビルドしません。 |
| 139 | + |
| 140 | + 「make doc」は、manおよびhtml形式のドキュメントを作成します。 |
| 141 | + 「make man」、「make html」、「make info」もあります。 |
| 142 | + 「make html」にはasciidocが必要ですが、xmltoは必要ないことに注意してください。 |
| 143 | + 「make man」(したがってそれを含むmake doc)には両方が必要です。 |
| 144 | + |
| 145 | + 「make install-doc」は、ドキュメントをman形式でのみインストールします。 |
| 146 | + 「make install-man」、「make install-html」、「make install-info」も |
| 147 | + あります。 |
| 148 | + |
| 149 | + infoファイルの作成とインストールには、makeinfoとdocbook2Xが追加で必要です。 |
| 150 | + バージョン0.8.3が機能することが知られています。 |
| 151 | + |
| 152 | + PDFファイルのビルドとインストールには、さらにdblatexが必要です。 |
| 153 | + バージョン >= 0.2.7 が機能することがわかっています。 |
| 154 | + |
| 155 | + すべての形式には、少なくともasciidoc8.4.1が必要です。 |
| 156 | + または、USE_ASCIIDOCTOR=YesPleaseを渡してAsciidoctor(Rubyが必要)を使用することもできます。 |
| 157 | + Asciidoctorは少なくともバージョン1.5が必要です。 |
| 158 | + |
| 159 | + 事前にフォーマットされたマニュアル・ページとhtmlドキュメントをインストールする |
| 160 | + 「make quick-install-doc」と「make quick-install-man」と「make quick-install-html」もあります。 |
| 161 | + これらのビルド・ターゲットを使用するには、 |
| 162 | + git自体のクローンの隣に |
| 163 | + 2つの別々のgit-htmldocsリポジトリーとgit-manpagesリポジトリを複製する必要があります。 |
| 164 | + |
| 165 | + サポートされているdocbook-xslの最小バージョンは1.74です。 |
| 166 | + |
| 167 | + Cygwinでドキュメントを作成しようとしているユーザーは、 |
| 168 | + /etc/xml/catalogファイルが以下のようになっていることを確認する必要があります: |
| 169 | + |
| 170 | + <?xml version="1.0"?> |
| 171 | + <!DOCTYPE catalog PUBLIC |
| 172 | + "-//OASIS//DTD Entity Resolution XML Catalog V1.0//EN" |
| 173 | + "http://www.oasis-open.org/committees/entity/release/1.0/catalog.dtd" |
| 174 | + > |
| 175 | + <catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog"> |
| 176 | + <rewriteURI |
| 177 | + uriStartString = "http://docbook.sourceforge.net/release/xsl/current" |
| 178 | + rewritePrefix = "/usr/share/sgml/docbook/xsl-stylesheets" |
| 179 | + /> |
| 180 | + <rewriteURI |
| 181 | + uriStartString="http://www.oasis-open.org/docbook/xml/4.5" |
| 182 | + rewritePrefix="/usr/share/sgml/docbook/xml-dtd-4.5" |
| 183 | + /> |
| 184 | + </catalog> |
| 185 | + |
| 186 | + これは、以下の2つのxmlcatalogコマンドで実現できます: |
| 187 | + |
| 188 | + xmlcatalog --noout \ |
| 189 | + --add rewriteURI \ |
| 190 | + http://docbook.sourceforge.net/release/xsl/current \ |
| 191 | + /usr/share/sgml/docbook/xsl-stylesheets \ |
| 192 | + /etc/xml/catalog |
| 193 | + |
| 194 | + xmlcatalog --noout \ |
| 195 | + --add rewriteURI \ |
| 196 | + http://www.oasis-open.org/docbook/xml/4.5/xsl/current \ |
| 197 | + /usr/share/sgml/docbook/xml-dtd-4.5 \ |
| 198 | + /etc/xml/catalog |
0 commit comments