サブモジュールの登録を抹消し、未初期化の状態に戻す
「サブモジュール」の登録を抹消し、未初期化の状態に戻します。登録を抹消する「サブモジュール」の指定は、「サブモジュール」の「ワーキングディレクトリー」のパスで指定します。
ワーキングディレクトリーの明示について
オプションの記述方法によっては、「ワーキングディレクトリー」の指定が、別のオプションの指定として解釈されることがあります。このような状況では、「ワーキングディレクトリー」の前に「 -- 」を記述します。
例えば、以下のような記述になります。
git submodule deinit -- mySubProject
複数のワーキングディレクトリーを指定できる
複数の「ワーキングディレクトリー」を指定できます。各「ワーキングディレクトリー」のパスは、スペースで区切ります。
例えば、以下のような記述になります。
git submodule deinit mySubProject mySubProject2
パスにスペースが含まれる場合
「ワーキングディレクトリー」のパスにスペースが含まれる場合は、パスを「'」で括ります。例えば、以下のような記述になります。
git submodule deinit 'my SubProject/my TestProject'
ワイルドカードによるワーキングディレクトリーの指定も可能
ワイルドカードを利用して、条件に合う「ワーキングディレクトリー」を指定することも可能です。利用できるワイルドカードは、「ワイルドカードを利用して、ステージングエリアにファイルを追加する（git add）」を参考にしてください。
1.現在のサブモジュールの状態
まず、現在の「サブモジュール」の状態を確認します。1-1.サブモジュールの状態
「サブモジュール」の状態を見てみます。以下のように、チェックアウトされている「サブモジュール」が2つあることが分かります。
1-2.gitmodulesファイル
「.gitmodules」ファイルを確認すると、以下のように「サブモジュール」の情報が記述されています。
1-3.configファイル
「スーパープロジェクト」の「Gitディレクトリー」に配置されている「config」ファイルを見てみます。以下のように、初期化済みの「サブモジュール」の情報が記述されています。
1-4.サブモジュールのワーキングディレクトリー
「サブモジュール」の「ワーキングディレクトリー」を見ると、チェックアウトされたプロジェクトのファイル群が配置されています。
2.サブモジュールの登録の抹消
ここでは例として、「mySubProject」サブモジュールの登録を抹消します。2-1.コマンドの実行
「端末」から、以下のコマンドを実行します。コマンドの詳細は、「サブモジュールの登録を抹消するコマンドの説明」を参考にしてください。
git submodule deinit mySubProject
2-2.コマンドの実行結果
以下のように、指定された「サブモジュール」の登録が抹消されます。
3.登録抹消後のサブモジュールの状態
登録抹消後の「サブモジュール」の状態を見てみます。3-1.サブモジュールの状態
「サブモジュール」の状態を見てみます。以下のように、「mySubProject」サブモジュールに「-」マークが表示されています。
これは、未初期化の状態を表しています。
3-2.gitmodulesファイル
「.gitmodules」ファイルを確認すると、「1-2.」の内容と同じです。
従って、再度「サブモジュール」を初期化すれば、「サブモジュール」の利用が可能になります。
3-3.configファイル
「スーパープロジェクト」の「Gitディレクトリー」に配置されている「config」ファイルを見てみます。「1-3.」と内容を比較すると、「mySubProject」サブモジュールに関する記述が削除されています。
3-4.サブモジュールのワーキングディレクトリー
「サブモジュール」の「ワーキングディレクトリー」を見ると、「mySubProject」サブモジュールの「ワーキングディレクトリー」内のファイルが、全て削除されています。
