Update git doc

diff --git a/docs/manuals/en/developers/git.tex b/docs/manuals/en/developers/git.tex
index 6674441c6f9383b38e4d3c4c2d15c0065b1207ae..9cbeab79f51500a8984e56d5a26d4d6c3a1d110e 100644 (file)
--- a/docs/manuals/en/developers/git.tex
+++ b/docs/manuals/en/developers/git.tex
@@ -165,6 +165,16 @@ a change, then submit your change to the Bacula developers.  What
 would you do?
 
 \begin{itemize}
+\item Tell git who you are:\\
+\begin{verbatim}
+git config --global user.name "First-name Last-name"
+git config --global user.email "email@address.com"
+\end{verbatim}
+
+Where you put your real name and your email address. Since
+this is global, you only need to do it once on any given
+machine regardless of how many git repos you work with.
+
 \item Download the Source code:\\
 \begin{verbatim}
 git clone ssh://<userid>@bacula.git.sourceforge.net/gitroot/bacula/bacula trunk
@@ -189,6 +199,20 @@ make
 test
 \end{verbatim}
 
+Note: if you forget to create a working branch prior to making
+changes, and you make them on master, this is no problem providing
+that you create the working branch before your first commit.
+So assuming that you have edited master instead of your bugfix
+branch, you can simply:
+
+\begin{verbatim}
+git checkout -b bugfix master
+\end{verbatim}
+
+and a new bugfix branch will be created and checked out.
+You can then proceed to committing to your bugfix branch as
+described in the next step.
+
 \item commit your work:
 \begin{verbatim}
 git commit -am "Short comment on what I did"
@@ -239,17 +263,44 @@ git add (name-of-file-no-longer-in-conflict)
 git rebase --continue
 \end{verbatim}
 
-\item When you are ready to send a patch, do the following:\\
+\item If you find that it is impossible to reconcile the two
+      branches or you made a mistake in correcting and adding files,
+before you enter the:
+\begin{verbatim}
+git rebase --continue
+\end{verbatim}
+you can instead enter:
+
+\begin{verbatim}
+git rebase --abort
+\end{verbatim}
+
+      which will essentially cancel the the original git rebase and reset
+      everything to the beginning with no changes to your bugfix branch.
+
+\item When you have completed the rebase and 
+      are ready to send a patch, do the following:\\
 \begin{verbatim}
 git checkout bugfix
 git format-patch -M master
 \end{verbatim}
-Look at the files produced.  They should be numbered 0001-xxx.patch
-where there is one file for each commit you did, number sequentially,
-and the xxx is what you put in the commit comment.
+       Look at the files produced.  They should be numbered 0001-xxx.patch
+       where there is one file for each commit you did, number sequentially,
+       and the xxx is what you put in the commit comment.
 
 \item If the patch files are good, send them by email to the developers
-as attachments.
+      as attachments.
+
+\item Then you can continue working on your code if you want, or
+      start another branch with a new project.
+
+\item If you continue working on your bugfix branch, you should
+      do a {\bf git rebase master} from time to time, and when
+      your changes are committed to the repo, you will be automatically
+      synchronized.  So that the next {\bf git format-patch} will produce
+      only the changes you made since the last format-patch you sent
+      to the developers.
+
 
 \end{itemize}