Debian Bug report logs - #713957
manpage: make conffile variable usage more detailed

version graph

Package: live-config; Maintainer for live-config is Live Systems Maintainers <debian-live@lists.debian.org>; Source for live-config is src:live-config.

Reported by: intrigeri@debian.org

Date: Mon, 24 Jun 2013 09:45:01 UTC

Severity: wishlist

Tags: moreinfo

Found in version live-config/3.0.23-1

Done: Daniel Baumann <daniel.baumann@progress-technologies.net>

Bug is archived. No further changes may be made.

Toggle useless messages

View this report as an mbox folder, status mbox, maintainer mbox


Report forwarded to debian-bugs-dist@lists.debian.org, tails-dev@boum.org, Live Systems Maintainers <debian-live@lists.debian.org>:
Bug#713957; Package live-config. (Mon, 24 Jun 2013 09:45:05 GMT) Full text and rfc822 format available.

Acknowledgement sent to intrigeri@debian.org:
New Bug report received and forwarded. Copy sent to tails-dev@boum.org, Live Systems Maintainers <debian-live@lists.debian.org>. (Mon, 24 Jun 2013 09:45:05 GMT) Full text and rfc822 format available.

Message #5 received at submit@bugs.debian.org (full text, mbox):

From: intrigeri@debian.org
To: Debian Bug Tracking System <submit@bugs.debian.org>
Subject: live-config: manpage is wrong about LIVE_NOCONFIGS usage
Date: Mon, 24 Jun 2013 11:42:24 +0200
Package: live-config
Severity: normal
Version: 3.0.23-1
X-Debbugs-Cc: tails-dev@boum.org

Hi,

TL;DR: live-config(7) pretends that LIVE_NOCONFIGS equals
live-noconfig=, which is not the case.

As explained in message #45 on #712232, live-config(7) gives these
directions about LIVE_NOCONFIGS usage:

   Everything but the shortcuts that can be configured with a boot
   parameter can be alternatively also be configured through one or
   more files.
   [...]
   LIVE_NOCONFIGS=SCRIPT1,SCRIPT2, ... SCRIPTn
       This variable equals the 'live-noconfig=SCRIPT1,SCRIPT2, ...
       SCRIPTn' parameter.
   [...]
   Removing existing config scripts
       [...]
       To avoid to always need specifing disabled scripts through
       the boot parameter, a configuration file should be used, see above.

These directions don't work, which is kind of expected (at least for
those who wrote the code) as it completely contradict the intended
behavior that Daniel was kind enough to explain in message #40 on that
same bug report:

  if you want to have all scripts run except a few, and doing that
  with variables, then you need to specify both LIVE_NOCONFIGS and
  LIVE_CONFIG_SCRIPTS in your config file, see the
  'live-noconfig=*|noconfig=*)' case in /lib/live/config.sh.

Note that the manpage has no mention of _SCRIPTS (LIVE_CONFIG_SCRIPTS'
name in 3.0.x), so there's no way one can guess they should set it,
just by reading the manpage.

In earlier versions of live-config, the documentation previously used
to match the actual behavior of the program (I believe the
documentation update was forgotten when the behavior changed in commit
b018878). So, this is a regression in the documentation, which is why
I dare setting "normal" severity.

Cheers,
--
  intrigeri
  | GnuPG key @ https://gaffer.ptitcanardnoir.org/intrigeri/intrigeri.asc
  | OTR fingerprint @ https://gaffer.ptitcanardnoir.org/intrigeri/otr.asc



Information forwarded to debian-bugs-dist@lists.debian.org, Live Systems Maintainers <debian-live@lists.debian.org>:
Bug#713957; Package live-config. (Mon, 24 Jun 2013 09:54:13 GMT) Full text and rfc822 format available.

Acknowledgement sent to daniel.baumann@progress-technologies.net:
Extra info received and forwarded to list. Copy sent to Live Systems Maintainers <debian-live@lists.debian.org>. (Mon, 24 Jun 2013 09:54:13 GMT) Full text and rfc822 format available.

Message #10 received at 713957@bugs.debian.org (full text, mbox):

From: Daniel Baumann <daniel.baumann@progress-technologies.net>
To: intrigeri@debian.org
Cc: 713957@bugs.debian.org
Subject: Re: Bug#713957: live-config: manpage is wrong about LIVE_NOCONFIGS usage
Date: Mon, 24 Jun 2013 11:51:44 +0200
severity 713957 wishlist
retitle 713957 manpage: make conffile variable usage more detailed
tag 713957 moreinfo
thanks

On 06/24/2013 11:42 AM, intrigeri@debian.org wrote:
> Note that the manpage has no mention of _SCRIPTS (LIVE_CONFIG_SCRIPTS'
> name in 3.0.x), so there's no way one can guess they should set it,
> just by reading the manpage.

as said, the manpage is not wrong, just not spelling everything out as
detailed as you like it. please send some additional text to be added to
the manpage.

-- 
Address:        Daniel Baumann, Donnerbuehlweg 3, CH-3012 Bern
Email:          daniel.baumann@progress-technologies.net
Internet:       http://people.progress-technologies.net/~daniel.baumann/



Severity set to 'wishlist' from 'normal' Request was from Daniel Baumann <daniel.baumann@progress-technologies.net> to control@bugs.debian.org. (Mon, 24 Jun 2013 09:54:16 GMT) Full text and rfc822 format available.

Changed Bug title to 'manpage: make conffile variable usage more detailed' from 'live-config: manpage is wrong about LIVE_NOCONFIGS usage' Request was from Daniel Baumann <daniel.baumann@progress-technologies.net> to control@bugs.debian.org. (Mon, 24 Jun 2013 09:54:17 GMT) Full text and rfc822 format available.

Added tag(s) moreinfo. Request was from Daniel Baumann <daniel.baumann@progress-technologies.net> to control@bugs.debian.org. (Mon, 24 Jun 2013 09:54:18 GMT) Full text and rfc822 format available.

Reply sent to daniel.baumann@progress-technologies.net:
You have taken responsibility. (Mon, 24 Jun 2013 11:57:22 GMT) Full text and rfc822 format available.

Notification sent to intrigeri@debian.org:
Bug acknowledged by developer. (Mon, 24 Jun 2013 11:57:22 GMT) Full text and rfc822 format available.

Message #21 received at 713957-done@bugs.debian.org (full text, mbox):

From: Daniel Baumann <daniel.baumann@progress-technologies.net>
To: 713957-done@bugs.debian.org
Subject: Re: Bug#713957: live-config: manpage is wrong about LIVE_NOCONFIGS usage
Date: Mon, 24 Jun 2013 13:52:55 +0200
close 713957 4.0~a23-1
thanks

On 06/24/2013 11:51 AM, Daniel Baumann wrote:
> please send some additional text to be added to the manpage.

not needed, above version initializes LIVE_CONFIG_SCRIPTS automatically.

-- 
Address:        Daniel Baumann, Donnerbuehlweg 3, CH-3012 Bern
Email:          daniel.baumann@progress-technologies.net
Internet:       http://people.progress-technologies.net/~daniel.baumann/



Bug archived. Request was from Debbugs Internal Request <owner@bugs.debian.org> to internal_control@bugs.debian.org. (Tue, 23 Jul 2013 07:33:14 GMT) Full text and rfc822 format available.

Send a report that this bug log contains spam.


Debian bug tracking system administrator <owner@bugs.debian.org>. Last modified: Wed Apr 23 18:25:35 2014; Machine Name: beach.debian.org

Debian Bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.