[Logcheck-commits] Gerfried Fuchs: Added README.source, more or less a plain copy from <http:/ /www.logcheck.org/git.html>

[Gerfried Fuchs]

Module: logcheck
Branch: refs/tags/1.2.67
Commit: ff6ba0c6f64758a54e51f7ca9a449752543553f9
URL:    http://git.debian.org/?p=logcheck/logcheck.git;a=commit;h=ff6ba0c6f64758a54e51f7ca9a449752543553f9

Author: Gerfried Fuchs <rhonda at debian.at>
Date:   Fri Jul  4 10:38:29 2008 +0200

Added README.source, more or less a plain copy from <http://www.logcheck.org/git.html>

---

 debian/README.source |   69 ++++++++++++++++++++++++++++++++++++++++++++++++++
 debian/changelog     |    4 ++-
 2 files changed, 72 insertions(+), 1 deletions(-)

diff --git a/debian/README.source b/debian/README.source
new file mode 100644
index 0000000..d45f0db
--- /dev/null
+++ b/debian/README.source
@@ -0,0 +1,69 @@
+Logcheck - git
+[ transcription of <http://www.logcheck.org/git.html> ]
+
+The logcheck git repository is available via for online browsing:
+<http://git.debian.org/?p=logcheck/logcheck.git;a=summary>
+
+To obtain the source, you clone it:
+
+git clone git://git.debian.org/git/logcheck/logcheck.git
+# or the webpage sources:
+git clone git://git.debian.org/git/logcheck/web.git
+
+To submit patches, please follow this document:
+<http://repo.or.cz/w/git.git?a=blob;f=Documentation/SubmittingPatches;hb=HEAD>
+
+And send your patches via email to the logcheck-devel mailing list:
+<http://lists.alioth.debian.org/mailman/listinfo/logcheck-devel>
+
+First, the setup, which you only have to do once on each machine you work
+with:
+
+# leave out --global if you want to set your identity only for logcheck
+git config --global user.name 'your name'
+git config --global user.email 'your at email.address'
+# the next two are not needed but ensure that git does not send patches to
+# your own email address.
+git config sendemail.signedoffcc false
+git config sendemail.suppressfrom true
+git clone git://git.debian.org/git/logcheck/logcheck.git
+
+To prepare the actual patch, do the following:
+
+git pull
+git checkout -b some-name-identifying-my-work
+while not finished:
+  // if resuming after a while, maybe update your branch:
+  git rebase master
+  // edit files
+  git add files
+  git commit
+  ...
+end
+
+After you've brought your change to a state where you want to submit it,
+please squash it into logical single commits. If you only made one change,
+then this will do:
+
+git checkout -b temp-squash master
+git merge --squash some-name-identifying-my-work
+git commit // ... remove the "Squashed commit of the following:" leader
+git format-patch -M -s master
+// now inspect the files this created in $PWD
+// when you're ready to submit, do:
+git send-email --to your at email.address
+// check that it's okay when it arrives
+git send-email --to logcheck-devel at lists.alioth.debian.org
+
+For multiple logical changes, cherry-pick or squash-merge every commit
+belonging to a change to the integration branch and then commit it.
+
+Also, read the git-send-email manpage in case you're submitting multiple
+logical changes, in case you want to thread them.
+
+The manpage also includes information about adding a prologue message
+explaining your patch, or how to insert it into an existing thread
+(in-reply-to).
+
+Developers with write access to the repository may also push their
+changes, using the ssh transport instead of the git protocol.
diff --git a/debian/changelog b/debian/changelog
index 3e8f342..5fa82a1 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -4,8 +4,10 @@ logcheck (1.2.67) unstable; urgency=low
   * fix ignore.d.server/smbd_audit which had an unescaped | resulting in
     everything ignored (closes: #489009). As this hasn't transitioned yet to
     testing no urgency bump.
+  * Added README.source, more or less a plain copy from
+    <http://www.logcheck.org/git.html>
 
- -- Gerfried Fuchs <rhonda at debian.at>  Thu, 03 Jul 2008 09:36:13 +0200
+ -- Gerfried Fuchs <rhonda at debian.at>  Fri, 04 Jul 2008 10:38:07 +0200
 
 logcheck (1.2.66) unstable; urgency=low