bump year + add manpage + makefile: rationale

Signed-off-by: Mattias Andrée <maandree@operamail.com>

3 files changed, 75 insertions, 2 deletions

diff --git a/COPYING b/COPYING
index 9736bfc..a8fc716 100644
--- a/COPYING
+++ b/COPYING
@@ -1,5 +1,5 @@
 crt-calibrator – Calibration utility for CRT monitors
-Copyright © 2014  Mattias Andrée (maandree@member.fsf.org)
+Copyright © 2014, 2015  Mattias Andrée (maandree@member.fsf.org)
 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
diff --git a/README b/README
index be33336..7a75efd 100644
--- a/README
+++ b/README
@@ -7,7 +7,7 @@ SYNOPSIS
 DESCRIPTION
 	crt-calibrator is an interactive tool that guides you through
 	calibrating your CRT monitors. When done, the program will
-	print colour ramps information that is useful when setting
+	print gamma-ramp information that is useful when setting
 	the calibrations automatically. If FILE is specified, this
 	information is stored to that the file named FILE.
 
@@ -20,6 +20,21 @@ NOTES
 	used to calibrate monitors with nice gamma-curves, such as
 	CRT monitors. Not monitors with sigmoid-curves.
 
+RATIONALE
+	Few users have calibration hardware, and CRT monitors can
+	be sufficiently calibrated manually without them. However,
+	before crt-calibrator the best way to calibrator CRT monitors
+	was to have specialised test images, with colour bars and
+	samples. But this requires expertise, the common user will
+	know how to contruct these images or the best procedure for
+	applying the corrections. And it is tedious if you do not
+	find any interactive tool for change changing the settings.
+	The alternative why was to use test pictures that relied on
+	you deciding what looked most realistic rather than the
+	image itself telling you. But that's not all, to my knowledge,
+	this is actually the first program that runs outside a
+	display server.
+
 SEE ALSO
 	analyse-gamma(1), blueshift(1)
 
diff --git a/doc/man/crt-calibrator.1 b/doc/man/crt-calibrator.1
new file mode 100644
index 0000000..f2d3ba2
--- /dev/null
+++ b/doc/man/crt-calibrator.1
@@ -0,0 +1,58 @@
+.TH CRT-CALIBRATOR 1 CRT-CALIBRATOR
+.SH NAME
+crt-calibrator - CRT monitor calibrator utility for Linux VT
+.SH SYNOPSIS
+.BR crt-calibrator
+.RI [ FILE ]
+.SH DESCRIPTION
+.B crt-calibrator
+is an interactive tool that guides you through calibrating your
+CRT monitors. When done, the program will print gamma-ramp
+information that is useful when setting the calibrations
+automatically. If
+.B FILE
+is specified, this information is stored to that the file named
+.BR FILE .
+.PP
+The program cannot be run from inside
+.BR X ,
+it is required that it is run from the
+.BR Linux\ VT ,
+otherwise known as the TTY.
+.SH NOTES
+.B crt-calibrator
+should not be used to calibrate LCD (neither LED or TFT), plasma
+monitors, or OLED. It should only be used to calibrate monitors
+with nice gamma-curves, such as CRT monitors. Not monitors with
+sigmoid-curves.
+.SH RATIONALE
+Few users have calibration hardware, and CRT monitors can be
+sufficiently calibrated manually without them. However, before
+.B crt-calibrator
+the best way to calibrator CRT monitors was to have specialised
+test images, with colour bars and samples. But this requires
+expertise, the common user will know how to contruct these
+images or the best procedure for applying the corrections. And
+it is tedious if you do not find any interactive tool for change
+changing the settings. The alternative why was to use test
+pictures that relied on you deciding what looked most realistic
+rather than the image itself telling you. But that's not all,
+to my knowledge, this is actually the first program that runs
+outside a display server.
+.SH "SEE ALSO"
+.BR analyse-gamma (1),
+.BR blueshift (1)
+.SH AUTHORS
+Principal author, Mattias Andrée. See the COPYING file for the full
+list of authors.
+.SH LICENSE
+Copyright \(co 2014  Mattias Andrée
+.br
+License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
+.br
+This is free software: you are free to change and redistribute it.
+.br
+There is NO WARRANTY, to the extent permitted by law.
+.SH BUGS
+Please report bugs to https://github.com/maandree/crt-calibrator/issues
+or to maandree@member.fsf.org