Merge pull request #401 from SergeiKuznetsov/fix-console-messages

Исправить примеры консольных сообщений

Author: Morganov

book/05-distributed-git/sections/contributing.asc

@@ -532,7 +532,7 @@ $ git commit
 
 [source,console]
 ----
-$ git remote add myfork (url)
+$ git remote add myfork <url>
 ----
 
 После этого следует отправить проделанную работу в него.
@@ -622,8 +622,8 @@ image::images/public-small-2.png["История коммитов после р
 [source,console]
 ----
 $ git checkout -b featureBv2 origin/master
-$ git merge --no-commit --squash featureB
-# (change implementation)
+$ git merge --squash featureB
+  ... change implementation ...
 $ git commit
 $ git push myfork featureBv2
 ----
@@ -732,7 +732,7 @@ index 76f47bc..f9815f1 100644
 
 [source,console]
 ----
-$ cat *.patch | git imap-send
+$ cat *.patch |git imap-send
 Resolving imap.gmail.com... ok
 Connecting to [74.125.142.109]:993... ok
 Logging in...
@@ -743,7 +743,7 @@ sending 2 messages
 Теперь вы можете перейти в папку Drafts, изменить поле To, указав адрес почтовой рассылки, при необходимости заполнить поле СС, указав адрес сопровождающего или ответственного, и отправить письмо.
 
 Так же вы можете отправить свои патчи используя SMTP сервер.
-Как и в предыдущем случае, вы можете использовать набор команд `git config` или создать секцию sendemail в файле `~/.gitconfig`:
+Как и в предыдущем случае, вы можете использовать набор команд `git config` или создать секцию `sendemail` в файле `~/.gitconfig`:
 
 [source,ini]
 ----

book/06-github/sections/2-contributing.asc

@@ -80,7 +80,9 @@ $ cd blink
 $ git checkout -b slow-blink <2>
 Switched to a new branch 'slow-blink'
 
-$ sed -i '' 's/1000/3000/' blink.ino <3>
+$ sed -i '' 's/1000/3000/' blink.ino (macOS) <3>
+# If you're on a Linux system, do this instead:
+# $ sed -i 's/1000/3000/' blink.ino <3>
 
 $ git diff --word-diff <4>
 diff --git a/blink.ino b/blink.ino
@@ -359,7 +361,7 @@ GitHub расширил возможности обычной разметки.
 
 Список задач можно добавить следующим образом:
 
-[source]
+[source,text]
 ----
 - [X] Write the code
 - [ ] Write all the tests
@@ -394,7 +396,7 @@ image::images/markdown-03-task-summary.png["Пример списка задач
 
 Для добавления отрывка кода следует обрамить его обратными кавычками.
 
-[source]
+[source,text]
 ----
 ```java
 for(int i=0 ; i < 5 ; i++)
@@ -419,7 +421,7 @@ image::images/markdown-04-fenced-code.png["Отображение обрамле
 
 Цитаты выглядят примерно так:
 
-[source]
+[source,text]
 ----
 > Whether 'tis Nobler in the mind to suffer
 > The Slings and Arrows of outrageous Fortune,
@@ -447,7 +449,7 @@ image::images/markdown-06-emoji-complete.png["Помощник по смайла
 Смайлы имеют вид `:<name>:` и могут располагаться в любом месте комментария.
 Например, вы можете написать что-нибудь вроде этого:
 
-[source]
+[source,text]
 ----
 I :eyes: that :bug: and I :cold_sweat:.
 
@@ -490,7 +492,7 @@ image::images/markdown-08-drag-drop.png["Перетаскивание карти
 ==== Поддержание GitHub репозитория в актуальном состоянии
 
 После создания форка, ваш репозиторий будет существовать независимо от оригинального репозитория.
-В частности, при появлении в оригинальном репозитории новых коммитов GitHub информирует вас при помощи сообщения:
+В частности, при появлении в оригинальном репозитории новых коммитов GitHub информирует вас следующим сообщением:
 
 [source,text]
 ----
@@ -501,7 +503,7 @@ This branch is 5 commits behind progit:master.
 К счастью, это очень просто сделать.
 
 Первый способ не требует конфигурации.
-Например, если вы сделали форк репозитория `https://github.com/progit/progit2.git`, то обновить ветку `master` можно следующим образом:
+Например, если вы сделали форк репозитория `https://github.com/progit/progit2.git`, то актуализировать ветку `master` можно следующим образом:
 
 [source,console]
 ----
@@ -510,24 +512,25 @@ $ git pull https://github.com/progit/progit2.git <2>
 $ git push origin master <3>
 ----
 
-<1> Если вы находитесь на другой ветке -- перейти на `master`.
+<1> Если вы находитесь на другой ветке -- перейти на ветку `master`.
 <2> Получить изменения из репозитория `https://github.com/progit/progit2.git` и слить их с веткой `master`.
 <3> Отправить локальную ветку `master` в ваш форк `origin`.
 
 Каждый раз писать URL репозитория для получения изменений достаточно утомительно.
-Этот процесс можно автоматизировать за счёт указания следующей конфигурации:
+Этот процесс можно автоматизировать слегка изменив настройки:
 
 [source,console]
 ----
 $ git remote add progit https://github.com/progit/progit2.git <1>
-$ git branch --set-upstream-to=progit/master master <2>
-$ git config --local remote.pushDefault origin <3>
+$ git fetch progit <2>
+$ git branch --set-upstream-to=progit/master master <3>
+$ git config --local remote.pushDefault origin <4>
 ----
 
-<1> Добавить исходный репозиторий как удалённый с другим именем.
-    Здесь выбрано имя `progit`.
-<2> Настроить локальную ветку `master` на получение изменений из удалённого репозитория `progit`.
-<3> Установить `origin` как репозиторий по умолчанию для отправки.
+<1> Добавить исходный репозиторий как удалённый и назвать его `progit`.
+<2> Получить ветки репозитория `progit`, в частности ветку `master`.
+<3> Настроить локальную ветку `master` на получение изменений из репозитория `progit`.
+<4> Установить `origin` как репозиторий по умолчанию для отправки.
 
 После этого, процесс обновления становится гораздо проще:
 
@@ -538,8 +541,8 @@ $ git pull <2>
 $ git push <3>
 ----
 
-<1> Если вы находитесь на другой ветке -- перейти на `master`.
-<2> Получить изменения из `progit` и слить их с веткой `master`.
+<1> Если вы находитесь на другой ветке -- перейти на ветку `master`.
+<2> Получить изменения из репозитория `progit` и слить их с веткой `master`.
 <3> Отправить локальную ветку `master` в ваш форк `origin`.
 
 Данный подход не лишён недостатков.

book/06-github/sections/4-managing-organization.asc

@@ -58,7 +58,7 @@ image::images/orgs-02-teams.png["Страница команды"]
 Это полезно когда вы хотите привлечь внимание кого-нибудь из команды, но точно не знаете кого спросить.
 
 Пользователь может принадлежать любому числу команд, поэтому не ограничивайте себя командами, разделёнными по уровню доступа.
-Специализированные команды, такие как `ux`, `css` или `refactoring` полезны для вопросов одной тематики, тогда как команды `legal` и `colorblind` - для вопросов другой тематики.
+Специализированные команды, такие как `ux`, `css` или `refactoring` полезны для вопросов одной тематики, тогда как команды `legal` и `colorblind` -- для вопросов другой тематики.
 
 ==== Журнал аудита
 

book/07-git-tools/git-credential-read-only

@@ -22,7 +22,7 @@ end
 
 File.readlines(path).each do |fileline| # <4>
     prot,user,pass,host = fileline.scan(/^(.*?):\/\/(.*?):(.*?)@(.*)$/).first
-    if prot == known['protocol'] and host == known['host'] then
+    if prot == known['protocol'] and host == known['host'] and user == known['username'] then
         puts "protocol=#{prot}"
         puts "host=#{host}"
         puts "username=#{user}"

book/07-git-tools/sections/advanced-merging.asc

@@ -51,7 +51,7 @@ $ git commit -am 'Convert hello.rb to DOS'
  1 file changed, 7 insertions(+), 7 deletions(-)
 
 $ vim hello.rb
-$ git diff -w
+$ git diff -b
 diff --git a/hello.rb b/hello.rb
 index ac51efd..e85207e 100755
 --- a/hello.rb
@@ -144,7 +144,7 @@ $ git status -sb
 
 [source,console]
 ----
-$ git merge -Xignore-all-space whitespace
+$ git merge -Xignore-space-change whitespace
 Auto-merging hello.rb
 Merge made by the 'recursive' strategy.
  hello.rb | 2 +-
@@ -203,7 +203,7 @@ dos2unix: converting file hello.theirs.rb to Unix format ...
 $ git merge-file -p \
     hello.ours.rb hello.common.rb hello.theirs.rb > hello.rb
 
-$ git diff -w
+$ git diff -b
 diff --cc hello.rb
 index 36c06c8,e85207e..0000000
 --- a/hello.rb
@@ -255,7 +255,7 @@ index 36c06c8..44d0a25 100755
 
 [source,console]
 ----
-$ git diff --theirs -w
+$ git diff --theirs -b
 * Unmerged path hello.rb
 diff --git a/hello.rb b/hello.rb
 index e85207e..44d0a25 100755
@@ -274,7 +274,7 @@ index e85207e..44d0a25 100755
 
 [source,console]
 ----
-$ git diff --base -w
+$ git diff --base -b
 * Unmerged path hello.rb
 diff --git a/hello.rb b/hello.rb
 index ac51efd..44d0a25 100755

book/07-git-tools/sections/bundling.asc

@@ -56,7 +56,8 @@ Total 6 (delta 0), reused 0 (delta 0)
 [source,console]
 ----
 $ git clone repo.bundle repo
-Initialized empty Git repository in /private/tmp/bundle/repo/.git/
+Cloning into 'repo'...
+...
 $ cd repo
 $ git log --oneline
 9a466c5 Second commit

book/07-git-tools/sections/credentials.asc

@@ -37,7 +37,7 @@ $ git config --global credential.helper cache
 
 [source,console]
 ----
-$ git config --global credential.helper store --file ~/.my-credentials
+$ git config --global credential.helper 'store --file ~/.my-credentials'
 ----
 
 Git позволяет настраивать сразу несколько помощников.
@@ -194,7 +194,7 @@ password=s3cre7
 
 [source,console]
 ----
-$ git config --global credential.helper read-only --file /mnt/shared/creds
+$ git config --global credential.helper 'read-only --file /mnt/shared/creds'
 ----
 
 Как вы видите, расширять эту систему довольно просто и это позволяет решить некоторые общие проблемы, которые могут возникнуть у вас и вашей команды.

book/07-git-tools/sections/debugging.asc

@@ -9,22 +9,25 @@ Git предоставляет несколько инструментов, ко
 Если вы обнаружили ошибку в вашем коде и хотите знать, когда она была добавлена и почему, то в большинстве случаев аннотация файла будет лучшим инструментом для этого.
 С помощью неё для любого файла можно увидеть, каким коммитом последний раз изменяли каждую из строк.
 Поэтому если вы видите, что некоторый метод в вашем коде работает неправильно, вы можете с помощью команды `git blame` снабдить файл аннотацией, и таким образом увидеть, когда каждая строка метода была изменена последний раз и кем.
-В следующем примере используется опция `-L`, чтобы ограничить вывод строками с 12 по 22:
 
+В следующем примере используется `git blame`, чтобы определить, какой коммит и коммиттер отвечал за строки в Makefile ядра Linux верхнего уровня и, кроме того, использует параметр -L для ограничения вывода аннотации строками с 69 по 82 из этого файла:
 [source,console]
 ----
-$ git blame -L 12,22 simplegit.rb
-^4832fe2 (Scott Chacon  2008-03-15 10:31:28 -0700 12)  def show(tree = 'master')
-^4832fe2 (Scott Chacon  2008-03-15 10:31:28 -0700 13)   command("git show #{tree}")
-^4832fe2 (Scott Chacon  2008-03-15 10:31:28 -0700 14)  end
-^4832fe2 (Scott Chacon  2008-03-15 10:31:28 -0700 15)
-9f6560e4 (Scott Chacon  2008-03-17 21:52:20 -0700 16)  def log(tree = 'master')
-79eaf55d (Scott Chacon  2008-04-06 10:15:08 -0700 17)   command("git log #{tree}")
-9f6560e4 (Scott Chacon  2008-03-17 21:52:20 -0700 18)  end
-9f6560e4 (Scott Chacon  2008-03-17 21:52:20 -0700 19)
-42cf2861 (Magnus Chacon 2008-04-13 10:45:01 -0700 20)  def blame(path)
-42cf2861 (Magnus Chacon 2008-04-13 10:45:01 -0700 21)   command("git blame #{path}")
-42cf2861 (Magnus Chacon 2008-04-13 10:45:01 -0700 22)  end
+$ git blame -L 69,82 Makefile
+b8b0618cf6fab (Cheng Renquan  2009-05-26 16:03:07 +0800 69) ifeq ("$(origin V)", "command line")
+b8b0618cf6fab (Cheng Renquan  2009-05-26 16:03:07 +0800 70)   KBUILD_VERBOSE = $(V)
+^1da177e4c3f4 (Linus Torvalds 2005-04-16 15:20:36 -0700 71) endif
+^1da177e4c3f4 (Linus Torvalds 2005-04-16 15:20:36 -0700 72) ifndef KBUILD_VERBOSE
+^1da177e4c3f4 (Linus Torvalds 2005-04-16 15:20:36 -0700 73)   KBUILD_VERBOSE = 0
+^1da177e4c3f4 (Linus Torvalds 2005-04-16 15:20:36 -0700 74) endif
+^1da177e4c3f4 (Linus Torvalds 2005-04-16 15:20:36 -0700 75)
+066b7ed955808 (Michal Marek   2014-07-04 14:29:30 +0200 76) ifeq ($(KBUILD_VERBOSE),1)
+066b7ed955808 (Michal Marek   2014-07-04 14:29:30 +0200 77)   quiet =
+066b7ed955808 (Michal Marek   2014-07-04 14:29:30 +0200 78)   Q =
+066b7ed955808 (Michal Marek   2014-07-04 14:29:30 +0200 79) else
+066b7ed955808 (Michal Marek   2014-07-04 14:29:30 +0200 80)   quiet=quiet_
+066b7ed955808 (Michal Marek   2014-07-04 14:29:30 +0200 81)   Q = @
+066b7ed955808 (Michal Marek   2014-07-04 14:29:30 +0200 82) endif
 ----
 
 Обратите внимание, что первое поле -- это неполная SHA-1 сумма последнего коммита, который изменял соответствующую строку.

book/07-git-tools/sections/interactive-staging.asc

@@ -5,6 +5,7 @@ Git поставляется вместе со скриптами, которы
 В этом разделе мы рассмотрим несколько интерактивных команд, которые могут упростить создание коммитов, позволяя включать в них только определённый набор файлов и их частей.
 Эти инструменты очень полезны, если вы изменили множество файлов, а затем решили, что хотите чтобы эти изменения были в нескольких маленьких понятных коммитах, а не в одном большом и запутанном.
 Таким способом вы сможете гарантировать, что ваши коммиты представляют логически разделённые изменения и могут быть легко прорецензированы вашими коллегами.
+
 Если вы выполните `git add` с опцией `-i` или `--interactive`, Git перейдёт в интерактивный консольный режим, отобразив что-то подобное:
 
 [source,console]
@@ -16,8 +17,8 @@ $ git add -i
   3:    unchanged        +5/-1 lib/simplegit.rb
 
 *** Commands ***
-  1: status     2: update      3: revert     4: add untracked
-  5: patch      6: diff        7: quit       8: help
+  1: [s]tatus     2: [u]pdate      3: [r]evert     4: [a]dd untracked
+  5: [p]atch      6: [d]iff        7: [q]uit       8: [h]elp
 What now>
 ----
 
@@ -33,7 +34,7 @@ What now>
 
 [source,console]
 ----
-What now> 2
+What now> u
            staged     unstaged path
   1:    unchanged        +0/-1 TODO
   2:    unchanged        +1/-1 index.html
@@ -62,9 +63,9 @@ Update>>
 updated 2 paths
 
 *** Commands ***
-  1: status     2: update      3: revert     4: add untracked
-  5: patch      6: diff        7: quit       8: help
-What now> 1
+  1: [s]tatus     2: [u]pdate      3: [r]evert     4: [a]dd untracked
+  5: [p]atch      6: [d]iff        7: [q]uit       8: [h]elp
+What now> s
            staged     unstaged path
   1:        +0/-1      nothing TODO
   2:        +1/-1      nothing index.html
@@ -77,9 +78,9 @@ What now> 1
 [source,console]
 ----
 *** Commands ***
-  1: status     2: update      3: revert     4: add untracked
-  5: patch      6: diff        7: quit       8: help
-What now> 3
+  1: [s]tatus     2: [u]pdate      3: [r]evert     4: [a]dd untracked
+  5: [p]atch      6: [d]iff        7: [q]uit       8: [h]elp
+What now> r
            staged     unstaged path
   1:        +0/-1      nothing TODO
   2:        +1/-1      nothing index.html
@@ -98,9 +99,9 @@ reverted one path
 [source,console]
 ----
 *** Commands ***
-  1: status     2: update      3: revert     4: add untracked
-  5: patch      6: diff        7: quit       8: help
-What now> 1
+  1: [s]tatus     2: [u]pdate      3: [r]evert     4: [a]dd untracked
+  5: [p]atch      6: [d]iff        7: [q]uit       8: [h]elp
+What now> s
            staged     unstaged path
   1:    unchanged        +0/-1 TODO
   2:        +1/-1      nothing index.html
@@ -114,9 +115,9 @@ What now> 1
 [source,console]
 ----
 *** Commands ***
-  1: status     2: update      3: revert     4: add untracked
-  5: patch      6: diff        7: quit       8: help
-What now> 6
+  1: [s]tatus     2: [u]pdate      3: [r]evert     4: [a]dd untracked
+  5: [p]atch      6: [d]iff        7: [q]uit       8: [h]elp
+What now> d
            staged     unstaged path
   1:        +1/-1      nothing index.html
 Review diff>> 1

book/07-git-tools/sections/rerere.asc

@@ -178,9 +178,8 @@ Patch failed at 0001 i18n one word
 При этом мы получили ожидаемый конфликт слияния, но обратите внимание на строку `Resolved FILE using previous resolution`.
 Если мы посмотрим на содержимое файла, то увидим, что конфликт уже был разрешён, и в файле отсутствуют маркеры конфликта слияния.
 
-[source,console]
+[source,ruby]
 ----
-$ cat hello.rb
 #! /usr/bin/env ruby
 
 def hello