Merge pull request #53 from troglobit/packaging

ChangeLog updates, Debian packaging support

.gitignore

@@ -19,4 +19,4 @@ install-sh
 missing
 stamp-h1
 Makefile
-Makefile.in
+Makefile.in

CHANGELOG

@@ -1,13 +0,0 @@
-0.9
-  * Complete rewrite of program (Every single byte)
-  * Cleaner, safer code
-  * Completely new intuitive usage (Sorry, it was needed)
-  * Added functionality:
-    * Ability to set/get minimum brightness directly from commandline
-    * Ability to specify the backlight controller to use directly from commandline
-    * Better verbosity
-
-  * Probably missed some stuff
-
-0.7
-  * Ported bash script to C.

ChangeLog.md

@@ -0,0 +1,113 @@
+Change Log
+==========
+
+All relevant changes to the project are documented in this file.
+
+
+[v1.2][UNRELEASED] - 2018-08-xx
+-------------------------------
+
+### Changes
+- Convert to GNU configure & build system
+- Add support for installing non-SUID root using an udev rule
+  enabled `--with-udev` to the new configure script
+- Migrate to use `~/.cache/light` instead of `/etc/light` for
+  unpriviliged operation
+- Add proper light.1 man page, remvoes help2man dependency
+- Simplify presentation of commands and options in built-in help text,
+  as well as in the README and man page
+- Change to Linux coding style
+- Add Fedora installation instructions
+
+
+[v1.1.2][] - 2018-06-20
+-----------------------
+
+Panic release to fix save/restore.
+
+### Changes
+- Add help2man dependency in README
+- Better Support for Overriding Install Prefix
+- Restore DESTDIR support
+
+### Fixes
+- Issue #29: Fix save and restore arguments
+- Issue #27: Use the install command instead of raw cp/mv/chmod.
+
+
+[v1.1][] - 2017-11-23
+---------------------
+
+Various fixes and improvements.  Credits to Abdullah ibn Nadjo
+
+### Changes
+- Add `-k` flag for keyboard backlight support
+- Cache max brightness data from automatic controller detection
+- Improve overall logging
+- Logging of clamps, saves and restores
+- Support for save, restore, get [max] brightness etc. for both screen
+  and keyboard controllers
+
+### Fixes
+- Avoid checking for write permission if just getting value
+- Check if controller is accessible before getting value
+- Avoid redondant checking
+- Don't truncate file contents when checking if file is writable
+- Fix `light_controllerAccessible()` and `light_getBrightness()` this
+  functions were:
+   - Reading values from the controller
+   - Checking write permission even when we just want reading values
+   - Checking the mincap file instead of the actual controller
+- Don't try to read brightness values when only targetting max bright
+- Fix issues with string buffers and pointers
+  - Use `NAME_MAX` and `PATH_MAX` instead of hardcoded values
+  - Allow paths to be longer than 256 chars
+  - Check pointers everywhere
+  - Use `strncpy()`/`snprintf()` instead of `strcpy()`/`sprintf()`
+  - Validate controllers' name (`-s` flag + a very long name = bad
+    things happening)
+  - Get rid of globals for dir iteration
+
+
+[v1.0][] - 2016-05-10
+---------------------
+
+First major release.  Light has been around for a while now and seems to
+make some people happy.  Also someone wanted a new release, so here you
+go!
+
+### Changes
+- Added save/restore functionality
+- Generate man page on `make install`
+
+### Fixes
+- Issue #5: Can't increase brightness on ATI propietary driver
+- Issue #10: Honor `$DESTDIR` on man page installation
+
+
+[v0.9][] - 2014-06-08
+---------------------
+
+### Changes
+- Complete rewrite of program (Every single byte)
+- Cleaner, safer code
+- Completely new intuitive usage (Sorry, it was needed)
+- Added functionality:
+  - Ability to set/get minimum brightness directly from commandline
+  - Ability to specify the backlight controller to use directly from commandline
+  - Better verbosity
+- Probably missed some stuff
+
+
+v0.7 - 2012-11-18
+-----------------
+
+### Changes
+- Ported bash script to C
+
+
+[UNRELEASED]: https://github.com/haikarainen/light/compare/v1.1.2...HEAD
+[v1.1.2]:     https://github.com/haikarainen/light/compare/v1.1...v1.1.2
+[v1.1]:       https://github.com/haikarainen/light/compare/v1.0...v1.1
+[v1.0]:       https://github.com/haikarainen/light/compare/v0.9...v1.0
+[v0.9]:       https://github.com/haikarainen/light/compare/v0.7...v0.9

Makefile.am

@@ -1,17 +1,21 @@
 SUBDIRS        = src
 dist_man1_MANS = light.1
-doc_DATA       = README.md LICENSE CHANGELOG
-EXTRA_DIST     = README.md LICENSE CHANGELOG
+doc_DATA       = README.md COPYING ChangeLog.md
+EXTRA_DIST     = README.md COPYING ChangeLog.md
 
 if UDEV
 udev_DATA      = 90-backlight.rules
 EXTRA_DIST    += $(top_srcdir)/90-backlight.rules
 endif
 
+# lintian --profile debian -i -I --show-overrides ../$PKG.changes
+package:
+	dpkg-buildpackage -uc -us -B
+
 #
 # Target to run when building a release
 #
-release: distcheck
+release: distcheck package
 	@for file in $(DIST_ARCHIVES); do	\
 		md5sum $$file > ../$$file.md5;	\
 	done
@@ -20,6 +24,9 @@ release: distcheck
 	@echo "Resulting release files:"
 	@echo "================================================================="
 	@for file in $(DIST_ARCHIVES); do					\
-		printf "$$file    \tDistribution tarball\n";			\
-		printf "$$file.md5\t"; cat ../$$file.md5 | cut -f1 -d' ';	\
+		printf "%-32s Distribution tarball\n" $$file;			\
+		printf "%-32s " $$file.md5; cat ../$$file.md5 | cut -f1 -d' ';	\
+	done
+	@for file in `cd ..; ls $(PACKAGE)_$(VERSION)*`; do			\
+		printf "%-32s Debian/Ubuntu file\n" $$file;			\
 	done

README.md

@@ -189,7 +189,7 @@ configure script to enable this mode of operation:
     ./configure --with-udev && make
     sudo make install
 
-This installs the file `90-backlight.rules` into `/lib/udev/rules.d/`.
+This installs the `90-backlight.rules` into `/usr/lib/udev/rules.d/`.
 If your udev rules are located elsewhere, use `--with-udev=PATH`.
 
 Note, in this mode `light` runs unpriviliged, so the `/etc/light`

debian/.gitignore

@@ -0,0 +1,3 @@
+files
+light.debhelper.log
+light.substvars

debian/changelog

@@ -0,0 +1,6 @@
+light (1.2) unstable; urgency=low
+
+  * Initial Debian Release (Closes: #47)
+
+ -- Joachim Nilsson <troglobit@gmail.com>  Sun, 12 Aug 2018 22:15:00 +0100
+

debian/compat

@@ -0,0 +1 @@
+9

debian/control

@@ -0,0 +1,14 @@
+Source: light
+Section: x11
+Priority: optional
+Maintainer: Joachim Nilsson <troglobit@gmail.com>
+Homepage: https://github.com/haikarainen/light
+Build-Depends: debhelper (>= 9~), autoconf
+Vcs-Git: https://github.com/haikarainen/light.git
+Vcs-Browser: https://github.com/haikarainen/light/commits/
+Standards-Version: 3.9.3
+
+Package: light
+Architecture: any
+Depends: ${shlibs:Depends}, ${misc:Depends}
+Description: a program to control backlight controllers under GNU/Linux

debian/copyright

@@ -0,0 +1,31 @@
+Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: light
+Source: https://github.com/haikarainen/light
+
+Files: *
+Copyright: Copyright 2012-2018  Fredrik Haikarainen <fredrik.haikarainen@gmail.com>
+License: GPL-3
+
+Files: debian/*
+Copyright: Copyright 2018  Joachim Nilsson <troglobit@gmail.com>
+License: GPL-3
+
+License: GPL-3
+ Indicator Weather is free software; you can redistribute it
+ and/or modify it under the terms of the GNU General Public
+ License version 3 as published by the Free Software Foundation.
+ .
+ Indicator Weather is distributed in the hope that it will be
+ useful, but WITHOUT ANY WARRANTY; without even the implied
+ warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
+ PURPOSE.  See the GNU General Public License for more
+ details. http://www.gnu.org/licenses/
+ .
+ You should have received a copy of the GNU General Public
+ License along with this package; if not, write to the Free
+ Software Foundation, Inc., 51 Franklin St, Fifth Floor,
+ Boston, MA  02110-1301 USA
+ .
+ On Debian systems, the full text of the GNU General Public
+ License version 3 can be found in the file
+`/usr/share/common-licenses/GPL-3'.

debian/docs

@@ -0,0 +1 @@
+README.md

debian/rules

@@ -0,0 +1,17 @@
+#!/usr/bin/make -f
+# export DH_VERBOSE=1
+export DEB_BUILD_MAINT_OPTIONS = hardening=+all
+
+%:
+	dh $@
+
+override_dh_auto_configure:
+	dh_auto_configure -- --with-udev
+
+override_dh_installchangelogs:
+	dh_installchangelogs ChangeLog.md
+
+override_dh_auto_install:
+	dh_auto_install
+	rm -f debian/light/usr/share/doc/light/COPYING
+	rm -f debian/light/usr/share/doc/light/ChangeLog.md

debian/source/format

@@ -0,0 +1 @@
+3.0 (native)

debian/source/options

@@ -0,0 +1 @@
+compression=xz

debian/watch

@@ -0,0 +1,3 @@
+version=3
+opts=filenamemangle=s/.+\/v?(\d\S*)\.tar\.gz/light-$1\.tar\.gz/ \
+  https://github.com/haikarainen/light/releases .*/light-?(\d\S*)\.tar\.gz