irfanview dpkg: add help docs

   This includes man pages, and suggests: xchm. Also suppress some
   lintian warnings.

10 files changed, 75 insertions, 1 deletions

diff --git a/irfanview/debian/control b/irfanview/debian/control
index 0070ef4..a74f12b 100644
--- a/irfanview/debian/control
+++ b/irfanview/debian/control
@@ -2,7 +2,9 @@ Source: irfanview
 Section: graphics
 Priority: optional
 Maintainer: B Stack <bgstack15@gmail.com>
-Build-Depends: debhelper (>=11~),
+Build-Depends: debhelper (>=12~),
+# bgscripts for txtman-wrapper
+	bgscripts (>=1.5.0),
 	imagemagick,
    librsvg2-bin
 Standards-Version: 4.1.4
@@ -33,6 +35,7 @@ Multi-Arch: foreign
 Depends: ${misc:Depends}, ${shlibs:Depends},
 	wine64 | wine-staging | winehq | winehq-staging | wine-stable,
    irfanview-common
+Suggests: xchm
 Provides: irfanview, x-graphics-viewer
 Description: graphics viewer from a non-free OS
  The 64-bit release
diff --git a/irfanview/debian/irfanview-bin32.lintian-overrides b/irfanview/debian/irfanview-bin32.lintian-overrides
new file mode 100644
index 0000000..62aa1bd
--- /dev/null
+++ b/irfanview/debian/irfanview-bin32.lintian-overrides
@@ -0,0 +1,4 @@
+copyright-has-url-from-dh_make-boilerplate
+copyright-without-copyright-notice
+file-in-usr-marked-as-conffile usr/share/irfanview32/i_view32.ini
+non-standard-file-perm usr/share/irfanview32/i_view32.ini *
diff --git a/irfanview/debian/irfanview-bin32.manpages b/irfanview/debian/irfanview-bin32.manpages
new file mode 100644
index 0000000..fd31f1b
--- /dev/null
+++ b/irfanview/debian/irfanview-bin32.manpages
@@ -0,0 +1 @@
+debian/irfanview-bin32/usr/share/man/man1/*
diff --git a/irfanview/debian/irfanview-bin64.lintian-overrides b/irfanview/debian/irfanview-bin64.lintian-overrides
new file mode 100644
index 0000000..0bae588
--- /dev/null
+++ b/irfanview/debian/irfanview-bin64.lintian-overrides
@@ -0,0 +1,4 @@
+copyright-has-url-from-dh_make-boilerplate
+copyright-without-copyright-notice
+file-in-usr-marked-as-conffile usr/share/irfanview64/i_view64.ini
+non-standard-file-perm usr/share/irfanview64/i_view64.ini *
diff --git a/irfanview/debian/irfanview-bin64.manpages b/irfanview/debian/irfanview-bin64.manpages
new file mode 100644
index 0000000..ba0ebda
--- /dev/null
+++ b/irfanview/debian/irfanview-bin64.manpages
@@ -0,0 +1 @@
+debian/irfanview-bin64/usr/share/man/man1/*
diff --git a/irfanview/debian/irfanview-common.lintian-overrides b/irfanview/debian/irfanview-common.lintian-overrides
new file mode 100644
index 0000000..d5a5720
--- /dev/null
+++ b/irfanview/debian/irfanview-common.lintian-overrides
@@ -0,0 +1,4 @@
+binary-without-manpage
+copyright-has-url-from-dh_make-boilerplate
+copyright-without-copyright-notice
+desktop-command-not-in-package
diff --git a/irfanview/debian/irfanview32.1.txt b/irfanview/debian/irfanview32.1.txt
new file mode 100644
index 0000000..f2193da
--- /dev/null
+++ b/irfanview/debian/irfanview32.1.txt
@@ -0,0 +1,23 @@
+title irfanview-bin32
+section 1
+project irfanview
+volume General Commands Manual
+date June 2020
+=====
+NAME
+  irfanview-bin32 - graphics viewer that runs via wine, 32-bit version
+SYNOPSIS
+  irfanview [FILE1 [FILE2...]]
+DESCRIPTION
+  Run a graphics viewer from a non-free operating system.
+ENVIRONMENT
+* IV_WINEPREFIX = ~/.wine
+* IV_EXEC_PATH = /usr/share/irfanview32/i_view32.exe
+AUTHOR
+  bgstack15@gmail.com
+COPYRIGHT
+  CC-BY-SA 4.0
+BUGS
+  The invocation of i_view32.exe with filenames can get messed up, usually due to spaces.
+SEE ALSO
+  `/usr/share/irfanview32/i_view32.chm`
diff --git a/irfanview/debian/irfanview64.1.txt b/irfanview/debian/irfanview64.1.txt
new file mode 100644
index 0000000..6d93e63
--- /dev/null
+++ b/irfanview/debian/irfanview64.1.txt
@@ -0,0 +1,23 @@
+title irfanview-bin64
+section 1
+project irfanview
+volume General Commands Manual
+date June 2020
+=====
+NAME
+  irfanview-bin64 - graphics viewer that runs via wine, 64-bit version
+SYNOPSIS
+  irfanview [FILE1 [FILE2...]]
+DESCRIPTION
+  Run a graphics viewer from a non-free operating system.
+ENVIRONMENT
+* IV_WINEPREFIX = ~/.wine
+* IV_EXEC_PATH = /usr/share/irfanview64/i_view64.exe
+AUTHOR
+  bgstack15@gmail.com
+COPYRIGHT
+  CC-BY-SA 4.0
+BUGS
+  The invocation of i_view64.exe with filenames can get messed up, usually due to spaces.
+SEE ALSO
+  `/usr/share/irfanview64/i_view32.chm`
diff --git a/irfanview/debian/rules b/irfanview/debian/rules
index c05c160..32f82d8 100755
--- a/irfanview/debian/rules
+++ b/irfanview/debian/rules
@@ -7,6 +7,7 @@
 
 export _prefix=/usr
 export _datadir="${_prefix}/share"
+export _mandir="${_datadir}/man"
 export appname=irfanview
 export appname_32=irfanview-bin32
 export appname_64=irfanview-bin64
@@ -53,6 +54,11 @@ override_dh_auto_install:
 	cp -p irfanview-circle.svg ${buildroot_common}${_datadir}/icons/hicolor/scalable/apps/${appname}.svg
 	rm -f ./irfanview-circle.svg || :
 
+	@# man pages
+	mkdir -p ${buildroot_32}/${_mandir}/man1 ${buildroot_64}/${_mandir}/man1
+	txt2man-wrapper - < ${debuilddir}/irfanview32.1.txt | gzip > ${buildroot_32}/${_mandir}/man1/irfanview32.1.gz
+	txt2man-wrapper - < ${debuilddir}/irfanview64.1.txt | gzip > ${buildroot_64}/${_mandir}/man1/irfanview64.1.gz
+
 override_dh_auto_clean:
 	dh_auto_clean
 	rm -rf ./irfanview-circle.svg || :
diff --git a/irfanview/debian/source/lintian-overrides b/irfanview/debian/source/lintian-overrides
new file mode 100644
index 0000000..999c2a5
--- /dev/null
+++ b/irfanview/debian/source/lintian-overrides
@@ -0,0 +1,5 @@
+file-without-copyright-information
+maintainer-script-lacks-debhelper-token
+missing-license-paragraph-in-dep5-copyright
+source-contains-prebuilt-ms-help-file
+source-contains-prebuilt-windows-binary