#681578 Manpage reports different config file to that used by the package

Package:
i8kutils
Source:
i8kutils
Description:
Fan control for Dell laptops
Submitter:
Karta Kooner
Date:
2015-01-05 19:33:05 UTC
Severity:
minor
#681578#5
Date:
2012-07-14 12:30:14 UTC
From:
To:
Hi

Very minor bug (in the documentation) but it could cause problems,
especially in derived distros that hide the boot messages: usage of the
system config file is inconsistent between i8kmon and the documentation.

* i8kmon     - script uses /etc/i8kmon.conf
* i8kmon.1  - manpage suggests that this config file is
/etc/default/i8kmon (several times)

The example init scripts, however, use /etc/default/i8kmon as a config
file to be used by the init system:

* debian/i8kutils.i8kmon.init  - sources /etc/default/i8kmon and so
expects sh commands
* debian/i8kutils.i8kmon.default  - comment suggests that it should be
called /etc/default/i8kmon

So anyone reading the i8kmon manpage will add instructions like "set
config(...)..." to /etc/default/i8kmon, which will cause the init script
to error.

#681578#10
Date:
2013-05-18 18:40:28 UTC
From:
To:
Dear Maintainer,

this release correct the global configuration filename ('/etc/i8kmon.conf') in the i8kmon manpage and in the i8kmon.conf example file itself. And also correct some lintian warnings. The actions are below in the changelog.


*** /tmp/tmpMiE5HK/bug_body
In Ubuntu, the attached patch was applied to achieve the following:


  * Correct global configuration filename to '/etc/i8kmon.conf'. LP: #799144.
    - Correct i8kmon.1 and i8kmon.conf.
  * Correct lintian warnings.
    - Update Standards-Version to 3.9.3
    - Upgrade compat version to 8 and debhelper Build-Depends.
  * QA (group) upload.


Thanks for considering the patch.

#681578#15
Date:
2014-12-08 13:54:13 UTC
From:
To:
Hello,

I have also got tricked by documentation. It mentions /etc/default/i8kmon
and /etc/i8kmon, while actually daemon uses /etc/i8kmon.conf !

Any progress in fixing this?

Also, shouldn't there be a default /etc/i8kmon.conf created? It is not, at
least in Wheezy i8kutils 1.33.

#681578#20
Date:
2015-01-05 19:28:33 UTC
From:
To:
Hello.

The incorrect filename is already corrected on release 1.42. The
release is available at i8kutils launchpad page for download as a
source package. Soon I expect it to be available on Debian as a binary
package.

I see a "/etc/i8kmon.conf" config file as for tweaking the i8kmon
behavior. And, now, it is not necessary for the majority of Dell
notebook models. Puting one file enables user modifying values if
something goes wrong when in most cases the problem is not solved
tweaking. That is why I did not included one. But I'll consider your
suggestion for the next release. Perhaps, a small subset of variables
is not bad to be available.

All in all, if you are facing a problem or want to try change some
parameters values, the possible parameters to be changed are listed on
the i8kmon manpage. It is just to create the file "/etc/i8kmon.conf"
and fill it with desired options.