[arachne-pnr] 01/03: Updated rules, added man page

[Ruben Undheim]

This is an automated email from the git hooks/post-receive script.

rubund-guest pushed a commit to branch master
in repository arachne-pnr.

commit 27ad973bde5269120709f569d7d519f65c75308d
Author: Ruben Undheim <ruben.undheim at gmail.com>
Date:   Wed Oct 14 16:14:51 2015 +0200

    Updated rules, added man page
---
 debian/man/arachne-pnr.txt | 48 ++++++++++++++++++++++++++++++++++++++++++++++
 debian/man/genmanpages.sh  |  4 ++++
 debian/rules               | 12 ++++++++++++
 3 files changed, 64 insertions(+)

diff --git a/debian/man/arachne-pnr.txt b/debian/man/arachne-pnr.txt
new file mode 100644
index 0000000..962d7f4
--- /dev/null
+++ b/debian/man/arachne-pnr.txt
@@ -0,0 +1,48 @@
+NAME
+  iceprog - simple programming tool for FTDI-based Lattice iCE programmers
+
+SYNOPSIS
+  iceprog [options] <filename>
+
+DESCRIPTION
+
+Notes for iCEstick (iCE40HX-1k devel board):
+
+  An unmodified iCEstick can only be programmed via the serial flash.
+  Direct programming of the SRAM is not supported. For direct SRAM
+  programming the flash chip and one zero ohm resistor must be desoldered
+  and the FT2232H SI pin must be connected to the iCE SPI_SI pin, as shown
+  in this picture: http://www.clifford.at/gallery/2014-elektronik/IMG_20141115_183838
+
+
+Notes for the iCE40-HX8K Breakout Board:
+
+  Make sure that the jumper settings on the board match the selected
+  mode (SRAM or FLASH). See the iCE40-HX8K user manual for details.
+
+
+OPTIONS
+
+    -d <device-string>  use the specified USB device:
+            d:<devicenode>                (e.g. d:002/005)
+            i:<vendor>:<product>          (e.g. i:0x0403:0x6010)
+            i:<vendor>:<product>:<index>  (e.g. i:0x0403:0x6010:0)
+            s:<vendor>:<product>:<serial-string>
+    -I [ABCD]  connect to the specified interface on the FTDI chip
+    -r  read entire flash (32Mb / 4MB) and write to file
+    -R  read first 256 kB from flash and write to file
+    -c  do not write flash, only verify (check)
+    -b  bulk erase entire flash before writing
+    -n  do not erase flash before writing
+    -S  perform SRAM programming
+    -t  just read the flash ID sequence
+    -v  verbose output
+
+ 
+
+
+AUTHOR
+  This manual page was written by Ruben Undheim <ruben.undheim at gmail.com> for the Debian project (and may be used by others).
+
+
+
diff --git a/debian/man/genmanpages.sh b/debian/man/genmanpages.sh
new file mode 100755
index 0000000..de8bbe5
--- /dev/null
+++ b/debian/man/genmanpages.sh
@@ -0,0 +1,4 @@
+#!/bin/bash
+
+
+txt2man -d "${CHANGELOG_DATE}" -t ARACHNE-PNR            -s 1 arachne-pnr.txt          > arachne-pnr.1
diff --git a/debian/rules b/debian/rules
index 885f378..1325da1 100755
--- a/debian/rules
+++ b/debian/rules
@@ -1,8 +1,20 @@
 #!/usr/bin/make -f
 #export DH_VERBOSE = 1
 
+export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed
+
+export DEB_BUILD_MAINT_OPTIONS = hardening=+all
+
+CHANGELOG_DATE ?= $(shell date -d "`dpkg-parsechangelog --show-field Date`" +"%d %B %Y")
+
 %:
 	dh $@ 
 
+override_dh_auto_clean:
+	dh_auto_clean
+	$(RM) debian/man/*.1
 
+override_dh_installman:
+	cd debian/man ; CHANGELOG_DATE="$(CHANGELOG_DATE)" ./genmanpages.sh
+	dh_installman
 

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debian-science/packages/arachne-pnr.git