summaryrefslogtreecommitdiff
path: root/hurd/running/debian/BtsFiling.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'hurd/running/debian/BtsFiling.mdwn')
-rw-r--r--hurd/running/debian/BtsFiling.mdwn52
1 files changed, 52 insertions, 0 deletions
diff --git a/hurd/running/debian/BtsFiling.mdwn b/hurd/running/debian/BtsFiling.mdwn
new file mode 100644
index 00000000..90f451a8
--- /dev/null
+++ b/hurd/running/debian/BtsFiling.mdwn
@@ -0,0 +1,52 @@
+When you encounter any GNU/Hurd related bugs in a Debian package you can fix, please use the Debian BTS (Bug Tracking System) to report them.
+
+Managing Debian packages and using the BTS is quite simple. If you're new to Debian, here's a short guide:
+
+* first of all, check [http://bugs.debian.org/<package>](http://bugs.debian.org) to ensure the problem is not in the BTS already. This is possible for packages and bug numbers. [[TWiki/InterWikis]] is a shorthand way of linking to bugs and packages from this site. i.e. [[DebianBug]]:hurd [[DebianPackage]]:oskit
+* you can fetch package sources with:
+
+ apt-get source <package>
+
+note: this should unpack already
+
+* and unpack with:
+
+ dpkg-source -x <package>x-y_z.dsc
+
+* then get all dependencies:
+
+ apt-get -y build-dep <package>
+
+note: if some dependencies are missing, it most probably means you have to port them first. follow this instructions recursively until done
+
+ :)
+
+* Debian packages have a makefile in debian/rules, with (at least) the following targets: <dl>
+ <dt> build</dt>
+ <dd> Yup, to build </dd>
+ <dt> binary</dt>
+ <dd> Generates deb files in <code>../</code></dd>
+ <dt> clean</dt>
+ <dd> Full clean </dd>
+</dl>
+
+* when you have a patch, send it to the BTS using the reportbug utility (or manually as explained in <http://bugs.debian.org/)>. The following parameters should be used:
+
+ Severity: important (when the package is unbuildable or uninstallable, lower otherwise.)
+ Tags: sid, patch
+
+* be nice to the maintainers. most are friendly and cooperative, and a few could annoy you for months before applying. Be patient.
+
+Read <http://bugs.debian.org/> for extensive documentation on the BTS.
+
+-- [[Main/RobertMillan]] - 10 Jun 2002
+
+----
+
+Wikification &amp; small changes.
+
+-- [[Main/JoachimNilsson]] - 24 Jun 2002
+
+Updates with the new [[TWiki/InterWikis]] rules.
+
+-- [[Main/GrantBow]] - 15 Jan 2003