]> git.sur5r.net Git - bacula/docs/commitdiff
Add commit keyword documentation from Eric
authorKern Sibbald <kern@sibbald.com>
Fri, 26 Feb 2010 08:45:51 +0000 (09:45 +0100)
committerKern Sibbald <kern@sibbald.com>
Fri, 26 Feb 2010 08:45:51 +0000 (09:45 +0100)
docs/manuals/en/developers/generaldevel.tex

index 33312af460dfa8999c8311d4e6b3921deab3af8b..d3e8d49690b8c798303cd6b8fd51834afe371892 100644 (file)
@@ -697,10 +697,53 @@ so be conservative in your use of C++ features.
      named bail\_out, and possibly an ok\_out.  See current code
      examples.
 
-\item Malloc and free within a single subroutine.  
+\item malloc and free within a single subroutine.  
 
 \item Comments and global explanations on what your code or  algorithm does. 
 
+\item When committing a fix for a bug, make the comment of the
+following form:
+
+\begin{verbatim}
+Reason for bug fix or other message. Fixes bug #1234 
+\end{verbatim}
+
+It is important to write the {\bf bug #1234} like
+that because our program that automatically pulls messages
+from the git repository to make the ChangeLog looks for that
+pattern.  Obviously the {\bf 1234} should be replaced with
+the number of the bug you actually fixed.
+
+Providing the commit comment line has one of the following
+keywords (or phrases), it will be ignored:
+
+\begin{verbatim}
+  tweak
+  typo
+  cleanup
+  bweb:
+  regress:
+  again
+  .gitignore
+  fix compilation
+  technotes
+  update version
+  update technotes
+  update kernstodo
+  update projects
+  update releasenotes
+  update version
+  update home
+  update release
+  update todo
+  update notes
+  update changelog
+\end{verbatim}
+
+\item Use the following keywords at the beginning of
+a git commit message 
+
+
 \end{itemize}
 
 \subsection{Indenting Standards}