Import Debian changes 0.0+r4067-3

dfu-util (0.0+r4067-3) unstable; urgency=low
.
  * Add missing autoconf/automake build dependencies (Closes: #468791).
  * I wrote a manpage, as there is none upstream.

4 files changed, 129 insertions, 1 deletions

diff --git a/debian/changelog b/debian/changelog
index a52acbc..9c6aade 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,10 @@
+dfu-util (0.0+r4067-3) unstable; urgency=low
+
+  * Add missing autoconf/automake build dependencies (Closes: #468791).
+  * I wrote a manpage, as there is none upstream.
+
+ -- Uwe Hermann <uwe@debian.org>  Sat, 01 Mar 2008 16:40:04 +0100
+
 dfu-util (0.0+r4067-2) unstable; urgency=low
 
   * Do not install the dfu-util_static binary, it's not needed in Debian.
diff --git a/debian/control b/debian/control
index 5503e2e..bfe96a2 100644
--- a/debian/control
+++ b/debian/control
@@ -2,7 +2,7 @@ Source: dfu-util
 Section: electronics
 Priority: extra
 Maintainer: Uwe Hermann <uwe@debian.org>
-Build-Depends: cdbs, debhelper (>= 5), libusb-dev
+Build-Depends: cdbs, debhelper (>= 5), autoconf, automake, libusb-dev
 Standards-Version: 3.7.3
 Homepage: http://wiki.openmoko.org/wiki/Dfu-util
 
diff --git a/debian/dfu-util.1 b/debian/dfu-util.1
new file mode 100644
index 0000000..3ccf044
--- /dev/null
+++ b/debian/dfu-util.1
@@ -0,0 +1,115 @@
+.TH DFU-UTIL 1 "February 29, 2008"
+.SH NAME
+dfu-util \- Device firmware update (DFU) USB programmer
+.SH SYNOPSIS
+.B dfu-util \fR[\fB\-ldpciatUDRhV\fR]
+.SH DESCRIPTION
+.B dfu-util
+is a program that implements the host (PC) side of the USB DFU
+(Universal Serial Bus Device Firmware Upgrade) protocol.
+.sp
+In the OpenMoko project (for example), this program is used to communicate
+with the specially enhanced u-boot boot loader, which implements the DFU
+device side.
+.SH OPTIONS
+.TP
+.B "\-l, \-\-list"
+List the currently attached DFU capable USB devices.
+.TP
+.BR "\-d, \-\-device" " VENDOR:PRODUCT"
+Specify vendor/product ID of the DFU device. Both
+.B VENDOR
+and
+.B PRODUCT
+are hex-numbers which must start with
+.BR 0x .
+Example:
+.sp
+.B "  $ dfu-util --device 0x1457:0x5119"
+.sp
+If you only have one standards-compliant DFU device attached to your PC,
+this is optional. However, as soon as you have multiple DFU devices,
+dfu-util will detect this and abort, asking you to specify which device
+it shall use.
+.TP
+.BR "\-p, \-\-path" " BUS-PORT. ... .PORT"
+Specify the path to the DFU device.
+.TP
+.BR "\-c, \-\-cfg" " CONFIG-NR"
+Specify the configuration of the DFU device.
+.TP
+.BR "\-i, \-\-intf" " INTF-NR"
+Specify the DFU interface number.
+.TP
+.BR "\-a, \-\-alt" " ALT"
+Specify the altsetting of the DFU interface by name or by number.
+.TP
+.B "\-t, \-\-transfer-size"
+Specify the number of bytes per USB transfer. If you don't supply this
+option, the maximum possible size for your combination of host OS and
+USB device is chosen (for optimal performance).
+.TP
+.BR "\-U, \-\-upload" " FILE"
+Read firmware from device into
+.BR FILE .
+.sp
+.B Note:
+Upload support is currently broken.
+.TP
+.BR "\-D, \-\-download" " FILE"
+Write firmware from
+.B FILE
+into device.
+.TP
+.B "\-R, \-\-reset"
+Issue USB reset signalling once we're finished.
+.TP
+.B "\-h, \-\-help"
+Show a help text and exit.
+.TP
+.B "\-V, \-\-version"
+Show version information and exit.
+.SH EXAMPLES
+Here are some examples for the usage of dfu-util in the OpenMoko project
+(working with the Neo1973 hardware):
+.PP
+Flashing the rootfs:
+.br
+.B "  $ dfu-util -a rootfs -R -D /path/to/openmoko-devel-image.jffs2"
+.PP
+Flashing the kernel:
+.br
+.B "  $ dfu-util -a kernel -R -D /path/to/uImage"
+.PP
+Flashing the bootloader:
+.br
+.B "  $ dfu-util -a u-boot -R -D /path/to/u-boot.bin"
+.PP
+Copying a kernel into RAM:
+.br
+.B "  $ dfu-util -a 0 -R -D /path/to/uImage"
+.sp
+Once this has finished, the kernel will be available at the default load
+address of 0x32000000 in Neo1973 RAM.
+.sp
+.B Note:
+You cannot transfer more than 2MB of data into RAM using this method.
+.SH BUGS
+Please see
+.B http://wiki.openmoko.org/wiki/Dfu-util
+for some limitations and bugs in the current dfu-util code.
+.PP
+Please report any further bugs at
+.B http://bugzilla.openmoko.org
+or on the openmoko-kernel mailing list at
+.BR openmoko-kernel@lists.openmoko.org .
+.SH LICENCE
+.B dfu-util
+is covered by the GNU General Public License (GPL), version 2 or later.
+.SH AUTHORS
+Weston Schmidt <weston_schmidt@yahoo.com>
+.br
+Harald Welte <hwelte@hmw-consulting.de>
+.PP
+This manual page was written by Uwe Hermann <uwe@hermann-uwe.de>.
+It is licensed under the terms of the GNU GPL (version 2 or later).
diff --git a/debian/rules b/debian/rules
index 8bddfcf..dcb249f 100755
--- a/debian/rules
+++ b/debian/rules
@@ -3,9 +3,15 @@
 include /usr/share/cdbs/1/rules/debhelper.mk
 include /usr/share/cdbs/1/class/autotools.mk
 
+DEB_INSTALL_MANPAGES_dfu-util := debian/dfu-util.1
+
 # We must first call ./autogen.sh to generate the autotools stuff.
 post-patches:: debian/stamp-autothings-update
 debian/stamp-autothings-update:
+	@#aclocal
+	@#autoheader
+	@#automake --foreign --add-missing --copy
+	@#autoconf
 	./autogen.sh
 	touch $@