revise information about Git commit logs and changelog.

Information about committing and Changelog maintenance in pbuilder was outdated.

1 files changed, 4 insertions, 15 deletions

diff --git a/Documentation/pbuilder-doc.xml b/Documentation/pbuilder-doc.xml
index 527baa3..aa2ee3d 100644
--- a/Documentation/pbuilder-doc.xml
+++ b/Documentation/pbuilder-doc.xml
@@ -1369,21 +1369,10 @@ git-clone ssh://git.debian.org/git/pbuilder/pbuilder.git
 	</tgroup>
       </table>
       <para>
-	When making changes, a description of the change targeted at
-	developers should be documented in
-	<filename>ChangeLog</filename><footnote>
-	  <para>ChangeLog is edited using emacs ChangeLog mode.</para>
-	</footnote>, and committed.  A brief
-	summary of the change targeting end users should be documented
-	in <filename>debian/changelog</filename>, so that users can
-	see them.  
-	
-	It is important to note that the description of
-	<filename>debian/changelog</filename> is targeted at users,
-	and <filename>ChangeLog</filename> is targeted at developers.
-
-	For git commit messages, a cut-n-paste of
-	<filename>ChangeLog</filename> diff should be enough.
+	When making changes, changes should be documented in the Git
+	commit log.  git-dch will generate debian/changelog from the
+	commit log. Make the first line of your commit log meaningful,
+	and add any bug-closing information available.	
       </para>
       <para>
 	A TODO file is available in <filename>debian/TODO</filename>.