Обновлён раздел 'Исправление истории' соответственно оригиналу

Author: Morganov

book/07-git-tools/sections/rewriting-history.asc

@@ -6,8 +6,15 @@
 Область подготовленных изменений позволяет вам решить, какие файлы попадут в коммит непосредственно перед её выполнением; благодаря команде `stash` вы можете решить, что не хотите продолжать работу над какими-то изменениями; также вы можете изменить уже совершённые коммиты так, чтобы они выглядели совершенно другим образом.
 В частности, можно изменить порядок коммитов, сообщения или изменённые в коммитах файлы, объединить вместе или разбить на части, полностью удалить коммит -- но только до того, как вы поделитесь своими наработками с другими.
 
-В данном разделе вы узнаете, как выполнять эти очень полезные задачи.
-Таким образом, перед тем, как поделиться вашими наработками с другими, вы сможете привести вашу историю коммитов к нужному виду.
+В данном разделе вы узнаете, как выполнять эти очень полезные задачи, чтобы привести вашу историю коммитов к желаемому виду до того, как поделиться ей с остальными.
+
+[NOTE]
+.Не отправляйте свои наработки, пока вы ими не довольны
+====
+Одно из основноых правил Git заключается в том, что, так как большую часть работы вы делаете в своём локальном репозитории, то вы вольны переписывать свою историю _локально_.
+Однако, как только вы отправите свои наработки, то это уже совсем другая история и вам следует рассматривать отправленные изменения как финальные до тех пор, пока у вас не появится весомая причина что-то изменить.
+Если кратко, то вы должны воздержаться от отправки своих изменений, пока не будете полностью довольны и готовы поделиться ими со всем миром.
+====
 
 [[r_git_amend]]
 ==== Изменение последнего коммита
@@ -29,7 +36,21 @@ $ git commit --amend
 Вы добавляете в индекс необходимые изменения, редактируя файл и выполняя для него `git add` или `git rm` для отслеживаемого файла, а последующая команда `git commit --amend` берет вашу текущую область подготовленных изменений и делает её снимок для нового коммита.
 
 Вы должны быть осторожными, используя этот приём, так как при этом изменяется SHA-1 коммита.
-Поэтому как и с операцией `rebase` -- не изменяйте ваш последний коммит, если вы уже отправили её в общий репозиторий.
+Поэтому, как и с операцией `rebase` -- не изменяйте ваш последний коммит, если вы уже отправили его в общий репозиторий.
+
+[TIP]
+.Изменённый коммит может потребовать изменения сообщения коммита
+====
+При изменении коммита существует возможность изменить как его содержимое, так и сообщение коммита.
+Если в коммит внесены существенные изменения, то почти наверняка следует обновить и его сообщение, чтобы оно более точно отражало содержимое коммита.
+
+С другой стороны, если изменения незначительны (исправление опечаток, добаление в коммит забытого файла), то текущее сообщение вполне можно оставить; чтобы лишний раз не вызывать редактор, просто добавьте измененные файлы в индекс и выполните команду:
+
+[source,console]
+----
+$ git commit --amend --no-edit
+----
+====
 
 [[r_changing_multiple]]
 ==== Изменение сообщений нескольких коммитов
@@ -55,19 +76,27 @@ $ git rebase -i HEAD~3
 
 [source,console]
 ----
-pick f7f3f6d changed my name a bit
-pick 310154e updated README formatting and added blame
-pick a5f4a0d added cat-file
+pick f7f3f6d Change my name a bit
+pick 310154e Update README formatting and add blame
+pick a5f4a0d Add cat-file
 
 # Rebase 710f0f8..a5f4a0d onto 710f0f8
 #
 # Commands:
-#  p, pick = use commit
-#  r, reword = use commit, but edit the commit message
-#  e, edit = use commit, but stop for amending
-#  s, squash = use commit, but meld into previous commit
-#  f, fixup = like "squash", but discard this commit's log message
-#  x, exec = run command (the rest of the line) using shell
+# p, pick <commit> = use commit
+# r, reword <commit> = use commit, but edit the commit message
+# e, edit <commit> = use commit, but stop for amending
+# s, squash <commit> = use commit, but meld into previous commit
+# f, fixup <commit> = like "squash", but discard this commit's log message
+# x, exec <command> = run command (the rest of the line) using shell
+# b, break = stop here (continue rebase later with 'git rebase --continue')
+# d, drop <commit> = remove commit
+# l, label <label> = label current HEAD with a name
+# t, reset <label> = reset HEAD to a label
+# m, merge [-C <commit> | -c <commit>] <label> [# <oneline>]
+# .       create a merge commit using the original merge commit's
+# .       message (or the oneline, if no original merge commit was
+# .       specified). Use -c <commit> to reword the commit message.
 #
 # These lines can be re-ordered; they are executed from top to bottom.
 #
@@ -84,9 +113,9 @@ pick a5f4a0d added cat-file
 [source,console]
 ----
 $ git log --pretty=format:"%h %s" HEAD~3..HEAD
-a5f4a0d added cat-file
-310154e updated README formatting and added blame
-f7f3f6d changed my name a bit
+a5f4a0d Add cat-file
+310154e Update README formatting and add blame
+f7f3f6d Change my name a bit
 ----
 
 Обратите внимание на обратный порядок.
@@ -100,36 +129,36 @@ f7f3f6d changed my name a bit
 
 [source,console]
 ----
-edit f7f3f6d changed my name a bit
-pick 310154e updated README formatting and added blame
-pick a5f4a0d added cat-file
+edit f7f3f6d Change my name a bit
+pick 310154e Update README formatting and add blame
+pick a5f4a0d Add cat-file
 ----
 
 Когда вы сохраните сообщение и выйдете из редактора, Git переместит вас к самому раннему коммиту из списка и вернёт вас в командную строку со следующим сообщением:
 
 [source,console]
 ----
 $ git rebase -i HEAD~3
-Stopped at f7f3f6d... changed my name a bit
+Stopped at f7f3f6d... Change my name a bit
 You can amend the commit now, with
 
        git commit --amend
 
-Once you’re satisfied with your changes, run
+Once you're satisfied with your changes, run
 
        git rebase --continue
 ----
 
 Эти инструкции говорят вам в точности то, что нужно сделать.
-Введите
+Выполните:
 
 [source,console]
 ----
 $ git commit --amend
 ----
 
 Измените сообщение коммита и выйдите из редактора.
-Затем выполните
+Затем выполните:
 
 [source,console]
 ----
@@ -140,29 +169,28 @@ $ git rebase --continue
 Если вы измените `pick' на `edit' в других строках, то можете повторить эти шаги для соответствующих коммитов.
 Каждый раз Git будет останавливаться, позволяя вам исправить коммит, и продолжит, когда вы закончите.
 
-==== Переупорядочивание коммитов
+==== Упорядочивание коммитов
 
-Вы также можете использовать интерактивное перебазирование для переупорядочивания или полного удаления коммитов.
-Если вы хотите удалить коммит ``added cat-file'' и изменить порядок, в котором были внесены два оставшихся, то вы можете изменить скрипт перебазирования с такого:
+Вы также можете использовать интерактивное перебазирование для изменения пордка или полного удаления коммитов.
+Если вы хотите удалить коммит ``Add cat-file'' и изменить порядок, в котором были внесены два оставшихся, то вы можете изменить скрипт перебазирования с такого:
 
 [source,console]
 ----
-pick f7f3f6d changed my name a bit
-pick 310154e updated README formatting and added blame
-pick a5f4a0d added cat-file
+pick f7f3f6d Change my name a bit
+pick 310154e Update README formatting and add blame
+pick a5f4a0d Add cat-file
 ----
 
 на такой:
 
-
 [source,console]
 ----
-pick 310154e updated README formatting and added blame
-pick f7f3f6d changed my name a bit
+pick 310154e Update README formatting and add blame
+pick f7f3f6d Change my name a bit
 ----
 
 Когда вы сохраните скрипт и выйдете из редактора, Git переместит вашу ветку на родителя этих коммитов, применит `310154e`, затем `f7f3f6d` и после этого остановится.
-Вы, фактически, изменили порядок этих коммитов и полностью удалили коммит ``added cat-file''.
+Вы, фактически, изменили порядок этих коммитов и полностью удалили коммит ``Add cat-file''.
 
 [[r_squashing]]
 ==== Объединение коммитов
@@ -174,12 +202,20 @@ Git добавляет полезные инструкции в сообщени
 ----
 #
 # Commands:
-#  p, pick = use commit
-#  r, reword = use commit, but edit the commit message
-#  e, edit = use commit, but stop for amending
-#  s, squash = use commit, but meld into previous commit
-#  f, fixup = like "squash", but discard this commit's log message
-#  x, exec = run command (the rest of the line) using shell
+# p, pick <commit> = use commit
+# r, reword <commit> = use commit, but edit the commit message
+# e, edit <commit> = use commit, but stop for amending
+# s, squash <commit> = use commit, but meld into previous commit
+# f, fixup <commit> = like "squash", but discard this commit's log message
+# x, exec <command> = run command (the rest of the line) using shell
+# b, break = stop here (continue rebase later with 'git rebase --continue')
+# d, drop <commit> = remove commit
+# l, label <label> = label current HEAD with a name
+# t, reset <label> = reset HEAD to a label
+# m, merge [-C <commit> | -c <commit>] <label> [# <oneline>]
+# .       create a merge commit using the original merge commit's
+# .       message (or the oneline, if no original merge commit was
+# .       specified). Use -c <commit> to reword the commit message.
 #
 # These lines can be re-ordered; they are executed from top to bottom.
 #
@@ -195,9 +231,9 @@ Git добавляет полезные инструкции в сообщени
 
 [source,console]
 ----
-pick f7f3f6d changed my name a bit
-squash 310154e updated README formatting and added blame
-squash a5f4a0d added cat-file
+pick f7f3f6d Change my name a bit
+squash 310154e Update README formatting and add blame
+squash a5f4a0d Add cat-file
 ----
 
 Когда вы сохраните скрипт и выйдете из редактора, Git применит изменения всех трёх коммитов и затем вернёт вас обратно в редактор, чтобы вы могли объединить сообщения коммитов:
@@ -206,15 +242,15 @@ squash a5f4a0d added cat-file
 ----
 # This is a combination of 3 commits.
 # The first commit's message is:
-changed my name a bit
+Change my name a bit
 
 # This is the 2nd commit message:
 
-updated README formatting and added blame
+Update README formatting and add blame
 
 # This is the 3rd commit message:
 
-added cat-file
+Add cat-file
 ----
 
 После сохранения сообщения, вы получите один коммит, содержащий изменения всех трёх коммитов, существовавших ранее.
@@ -228,9 +264,9 @@ added cat-file
 
 [source,console]
 ----
-pick f7f3f6d changed my name a bit
-edit 310154e updated README formatting and added blame
-pick a5f4a0d added cat-file
+pick f7f3f6d Change my name a bit
+edit 310154e Update README formatting and add blame
+pick a5f4a0d Add cat-file
 ----
 
 Затем, когда скрипт вернёт вас в командную строку, вам нужно будет отменить индексацию изменений этого коммита, и создать несколько коммитов на основе этих изменений.
@@ -242,9 +278,9 @@ pick a5f4a0d added cat-file
 ----
 $ git reset HEAD^
 $ git add README
-$ git commit -m 'updated README formatting'
+$ git commit -m 'Update README formatting'
 $ git add lib/simplegit.rb
-$ git commit -m 'added blame'
+$ git commit -m 'Add blame'
 $ git rebase --continue
 ----
 
@@ -253,13 +289,15 @@ Git применит последний коммит (`a5f4a0d`) из скрип
 [source,console]
 ----
 $ git log -4 --pretty=format:"%h %s"
-1c002dd added cat-file
-9b29157 added blame
-35cfb2b updated README formatting
-f3cc40e changed my name a bit
+1c002dd Add cat-file
+9b29157 Add blame
+35cfb2b Update README formatting
+f7f3f6d Change my name a bit
 ----
 
 И снова, при этом изменились SHA-1 хеши всех коммитов в вашем списке, поэтому убедитесь, что ни один коммит из этого списка ранее не был отправлен в общий репозиторий.
+Обратите внимание, что последний коммит в списке (`f7f3f6d`) не изменился.
+Несмотря на то, что коммит был в списке перебазирования, он был отмечен как ``pick'' и применён до применения перебизирования, поэтому Git оставил его нетронутым.
 
 ==== Удаление коммита
 
@@ -295,6 +333,13 @@ Drew DeVault создал практическое руководство с у
 Однако, эта команда может быть очень полезной.
 Далее вы ознакомитесь с несколькими обычными вариантами использованиями этой команды, таким образом, вы сможете получить представление о том, на что она способна.
 
+[CAUTION]
+====
+Команда `git filter-branch` таит в себе много подводных камней и более не является рекомендуемым способом изменения истории.
+Вместо этого, рассмотрите возможность использования Python скрипта `git-filter-repo`, который лучше подходит для большинства ситуаций, в которых вы обычно используете `filter-branch`.
+С документаций и исходным кодом скрипта можно ознакомиться здесь: https://github.com/newren/git-filter-repo[].
+====
+
 [[r_removing_file_every_commit]]
 ===== Удаление файла из каждого коммита