debian: add support

Author: Grok Compression

.gitignore

@@ -3,6 +3,13 @@ build
 obj-x86_64-linux-gnu
 debian/tmp
 nohup.out
+debian/.debhelper
+debian/debhelper-build-stamp
+debian/files
+debian/libgrokj2k*/
+debian/libgrokj2k*-dev/
+debian/grokj2k-tools/
+*grokj2k*.substvars
 
 #Ignore thumbnails created by Windows
 Thumbs.db

debian/README.md

@@ -0,0 +1,73 @@
+----------------
+Managing Tags
+----------------
+
+Move master tag:
+
+`$ git push origin :refs/tags/v20.2.4 && git tag -fa v20.2.4 && git push origin --tags`
+
+
+Move debian/master tag:
+
+`$ git push origin :refs/tags/v20.2.4.debian && git tag -fa v20.2.4.debian && git push origin --tags`
+
+------------------
+Building a Package
+------------------
+
+Guide to [setting up schroot](https://wiki.debian.org/Packaging/Pre-Requisites)
+
+0. `cd $SOURCE_DIR`
+
+1. First-time chroot setup:
+   `$ apt install git sbuild cmake  devscripts build-essential debhelper help2man libpng-dev liblcms2-dev libtiff-dev libjpeg-dev zlib1g-dev doxygen lintian libimage-exiftool-perl`
+
+2. `sudo schroot -c debian-sid`
+
+3. `$ git archive --format=tar v20.2.4 | gzip > libgrokj2k_20.2.4.orig.tar.gz && mv libgrokj2k_20.2.4.orig.tar.gz ..`
+
+4. `$ dpkg-buildpackage -us -uc`
+
+or, to just check lintian errors:
+
+   `$ dpkg-buildpackage -S`
+
+5. Check for errors / warnings
+
+   `$ lintian -EviIL +pedantic ../*.changes`
+
+
+--------------------
+Other Architectures
+--------------------
+
+[Guide](https://www.antixforum.com/forums/topic/use-sbuild-to-automate-deb-package-building/) to
+creating chroots for other architectures.
+
+------------------
+GPG Key Management
+------------------
+
+https://keyring.debian.org/creating-key.html
+
+https://blog.chapagain.com.np/gpg-remove-keys-from-your-public-keyring/
+
+https://www.linuxbabe.com/security/a-practical-guide-to-gpg-part-1-generate-your-keypair
+
+0. run chroot
+
+1. create gpg key
+
+`$ gpg --full-gen-key`
+
+Choose default RSA key, and choose length of 4096 bits
+
+2. sign `.changes` file
+
+`$ debsign -k AD89FCBE49DCDB2F4DE41D4E9E763CFFF2AC6581 ../*.changes`
+
+3. dupload changes file
+
+`$ dput -f mentors ../*.changes`
+
+Note: to list all gpg keys: `$ gpg --list-keys`

debian/README.source

@@ -0,0 +1,2 @@
+Grok JPEG 2000 for Debian
+-------------------------

debian/changelog

@@ -0,0 +1,137 @@
+libgrokj2k (20.2.4-1) unstable; urgency=medium
+
+    * 3 years worth of bug fixes and speed improvements
+
+ -- Aaron Boxer <boxerab@protonmail.com>  Sun, 29 Mar 2026 8:10:00 +0200
+
+libgrokj2k (10.0.5-1) unstable; urgency=medium
+
+    * Maintenance bug fix release
+    * Fixes an encoder crash : Grok issue #333
+    * Fixes a lintian warning about statically linked lcms2 library
+
+ -- Aaron Boxer <boxerab@protonmail.com>  Thu, 9 Feb 2023 8:10:00 +0200
+
+libgrokj2k (10.0.4-1) unstable; urgency=medium
+
+    * Maintenance bug fix release
+    * Fixes a bug in older macOS build
+    * Fixes bug in Doxyfile.dox.cmake.in file (Closes: #972494)
+
+ -- Aaron Boxer <boxerab@protonmail.com>  Tue, 4 Oct 2022 8:10:00 +0200
+
+libgrokj2k (10.0.3-1) unstable; urgency=medium
+
+    * Maintenance bug fix release
+    * Fixes a few lintian and blhc warnings
+
+ -- Aaron Boxer <boxerab@protonmail.com>  Mon, 19 Sep 2022 8:10:00 +0200
+
+libgrokj2k (10.0.2-1) unstable; urgency=medium
+
+    * Maintenance bug fix release
+    * Fixes Failure to build on mipsel and armel (Closes: #1015014)
+
+ -- Aaron Boxer <boxerab@protonmail.com>  Fri, 16 Sep 2022 8:10:00 +0200
+
+libgrokj2k (10.0.1-1) unstable; urgency=medium
+
+    * Maintenance bug fix release
+    * Fixes Failure to build from source with Perl 5.36 (Closes: #1014290)
+
+ -- Aaron Boxer <boxerab@protonmail.com>  Tue, 13 Sep 2022 8:10:00 +0200
+
+libgrokj2k (10.0.0-1) unstable; urgency=medium
+
+    * Majour release
+    * Simplification of the library API
+    * Examples showing API usage
+    * Added libgrokj2kcodec library encompassing all codec functionality
+    * Support for WASM build
+    * Concurrent parsing of packets when PLT marker is present
+    * Efficient skipping of non-relevant tiles when TLM marker is present
+    * Significant perf improvements when decompressing single-tile mono images
+    * many memory leak and other bug fixes
+
+ -- Aaron Boxer <boxerab@protonmail.com>  Sun, 4 Sep 2022 11:10:00 +0200
+
+libgrokj2k (9.7.5-1) unstable; urgency=medium
+
+    * Maintenance bug fix release
+
+ -- Aaron Boxer <boxerab@protonmail.com>  Sun, 10 Apr 2022 11:10:00 +0200
+
+libgrokj2k (9.5.0-1) unstable; urgency=medium
+
+    * Maintenance bug fix release
+    * Fixes GCC 11 build failure (Closes: #984111)
+
+ -- Aaron Boxer <boxerab@protonmail.com>  Wed, 20 Oct 2021 11:10:00 +0200
+
+libgrokj2k (9.2.0-1) unstable; urgency=high
+
+    * Majour release
+    * Fixes CVE-2021-36089 (Closes: #990525)
+
+ -- Aaron Boxer <boxerab@gmail.com>  Sat, 22 May 2021 11:10:00 +0200
+
+libgrokj2k (7.6.6-3) unstable; urgency=high
+
+    * Fix GCC poison error by removing one poison directive (Closes: #985116)
+
+ -- Aaron Boxer <boxerab@gmail.com>  Tue, 16 Mar 2021 11:10:00 +0200
+
+libgrokj2k (7.6.6-2) unstable; urgency=high
+
+    * Add -latomic to fix FTBFS on armel/mipsel (Closes: #983773)
+    * Drop -mavx2 -mbmi2 to avoid baseline violation on x86 (Closes: #983775)
+
+ -- Aaron Boxer <boxerab@gmail.com>  Wed, 10 Mar 2021 11:10:00 +0200
+
+libgrokj2k (7.6.6-1) unstable; urgency=high
+
+    * Fix severe bug in encoder
+
+ -- Aaron Boxer <boxerab@gmail.com>  Tue, 2 Feb 2021 11:10:00 +0200
+
+libgrokj2k (7.6.5-1) unstable; urgency=medium
+
+    * Maintenance bug release
+
+ -- Aaron Boxer <boxerab@gmail.com>  Wed, 13 Jan 2021 11:10:00 +0200
+
+libgrokj2k (7.6.3-1) unstable; urgency=medium
+
+    * Maintenance bug release
+
+ -- Aaron Boxer <boxerab@gmail.com>  Fri, 1 Jan 2021 11:10:00 +0200
+
+libgrokj2k (7.6.2-1) unstable; urgency=medium
+
+    * Maintenance bug release
+
+ -- Aaron Boxer <boxerab@gmail.com>  Tue, 22 Dec 2020 21:10:00 +0200
+
+libgrokj2k (7.6.1-1) unstable; urgency=medium
+
+    * Maintenance bug release
+
+ -- Aaron Boxer <boxerab@gmail.com>  Thu, 01 Oct 2020 21:10:00 +0200
+
+libgrokj2k (7.6.0-1) unstable; urgency=medium
+
+    * Maintenance bug release
+
+ -- Aaron Boxer <boxerab@gmail.com>  Fri, 14 Aug 2020 21:10:00 +0200
+
+libgrokj2k (7.3.0-1) unstable; urgency=medium
+
+    * Maintenance bug release
+
+ -- Aaron Boxer <boxerab@gmail.com>  Fri, 29 May 2020 21:10:00 +0200
+
+libgrokj2k (7.2.0-1) unstable; urgency=medium
+
+  * Initial release. Closes: #954265
+
+ -- Aaron Boxer <boxerab@gmail.com>  Sun, 17 May 2020 21:10:00 +0200

debian/control

@@ -0,0 +1,74 @@
+Source: libgrokj2k
+Priority: optional
+Maintainer: Aaron Boxer <boxerab@protonmail.com>
+Homepage: https://github.com/GrokImageCompression/grok
+Build-Depends: cmake (>= 3.20.0),
+               debhelper-compat (= 13),
+               help2man,
+               liblcms2-dev,
+               libpng-dev,
+               libtiff-dev,
+               libjpeg-dev,
+               zlib1g-dev,
+               libimage-exiftool-perl,
+Build-Depends-Indep: doxygen
+Standards-Version: 4.6.1.0
+Section: libs
+Vcs-Browser: https://github.com/GrokImageCompression/grok
+Vcs-Git: https://github.com/GrokImageCompression/grok.git -b debian/master
+Rules-Requires-Root: no
+
+Package: libgrokj2k1
+Architecture: any
+Multi-Arch: same
+Pre-Depends: ${misc:Pre-Depends}
+Depends: ${misc:Depends}, ${shlibs:Depends}
+Description: JPEG 2000 image compression/decompression library
+ Grok is a library for handling the JPEG 2000 image compression format.
+ JPEG 2000 is a wavelet-based image compression standard that permits
+ progressive decoding by pixel and resolution accuracy.
+ It supports lossless and lossy compression and is resilient to image errors.
+ .
+ This package contains the runtime files for Grok.
+
+Package: libgrokj2k1-dev
+Section: libdevel
+Architecture: any
+Multi-Arch: same
+Depends: libgrokj2k1 (= ${binary:Version}), ${misc:Depends}
+Recommends: libgrokj2k1-doc (= ${source:Version})
+Description: development files for Grok, a JPEG 2000 image library
+ Grok is a library for handling the JPEG 2000 image compression format.
+ JPEG 2000 is a wavelet-based image compression standard that permits
+ progressive decoding by pixel and resolution accuracy.
+ It supports lossless and lossy compression and is resilient to image errors.
+ .
+ This package contains the development files for Grok.
+
+Package: grokj2k-tools
+Section: graphics
+Architecture: any
+Multi-Arch: foreign
+Depends: ${misc:Depends}, ${shlibs:Depends}
+Description: command-line tools for the Grok JPEG 2000 library
+ This package provides command-line tools for conversions between
+ several image formats:
+ .
+  - grk_decompress: decompress j2k or jp2 file to pgm, ppm, pnm, pam,
+                  pgx, tif, bmp, raw, rawl, jpeg or png.
+  - grk_compress: encode pgm, ppm, pnm, pam, pgx, tif, bmp, raw, rawl,
+                  jpeg or png file to j2k or jp2 file.
+  - grk_dump: dump information contained in a j2k or jp2 file.
+
+Package: libgrokj2k1-doc
+Section: doc
+Architecture: all
+Multi-Arch: foreign
+Depends: ${misc:Depends}
+Description: documentation for the Grok JPEG 2000 library
+ Grok is a library for handling the JPEG 2000 image compression format.
+ JPEG 2000 is a wavelet-based image compression standard that permits
+ progressive decoding by pixel and resolution accuracy.
+ It supports lossless and lossy compression and is resilient to image errors.
+ .
+ This package contains the documentation for Grok.