From 1261ae9632db798188ec8b7f76d032c690198525 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Sun, 29 Nov 2015 15:45:37 +0100 Subject: bump year + add manpage + makefile: rationale MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- COPYING | 2 +- README | 17 +++++++++++++- doc/man/crt-calibrator.1 | 58 ++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 75 insertions(+), 2 deletions(-) create mode 100644 doc/man/crt-calibrator.1 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 . +.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 -- cgit v1.2.3-70-g09d2