configlets-druid - GNOME front end to run configlets in a wizard-like manner.

configlets-druid [--ask-only | --commit-only ] [configlet_dir]

configlets-druid is a GNOME front end to installed configlets. It provides a druid interface to them, where each appears in a window with a Back and Next button to choose between them.

After the initial welcoming screen, the druid shows a list of the configlets that will be displayed, along with short descriptions of each. Next to each configlet's name is a check box that is checked by default (but see below for information on configuring this); the user may check or uncheck any of the configlets shown. The next screen after this is the first configlet in the list that was checked; the rest of the screens consist of the rest of the checked configlets, followed by a wrap-up screen. If the user uses Back to return to the list and selects a different set of configlets, the newly checked list will be displayed when the user clicks Next to proceed.

See /usr/share/doc/python-configlets/book/book.html or http://hackers.progeny.com/configlets/ for more information.

--ask-only

Run the druid, but do not commit any changes to debconf until later, when run with --commit-only. Intended for use by apt-like tools.

--commit-only

Save earlier recorded values to debconf.

configlet_dir

Location for installed configlets. Defaults to /usr/share/configlets/.

configlets-druid can use a configuration file, located at /etc/configlets-druid.cfg. This file can contain blank lines and comment lines that start with a line, with whitespace separating the item and value. (The value can contain whitespace.) For some items, no value is necessary; in those cases, it can be omitted.

The following configuration items are recognized:

cancelable

Turn on the Cancel button on the druid. The default is to turn the Cancel button off.

debug

Cause the druid and the configlets to print large amounts of debugging information to standard error.

dont_show_required_configlets

If a configlet is listed as required (see the required_configlets item below), then it is displayed with "(mandatory)" added to its description, and its checkbox cannot be unchecked. If this item is specified, then required configlets will not be shown in the first screen at all.

gtkrc

Provides a path to a custom gtkrc for the druid. By default, the gtkrc from the Raleigh theme is used if available, or no gtkrc if it is not.

logo

Provides the path to the logo to load into the druid's logo space. If not specified, this defaults to a Debian logo.

omit_configlets

Configlets whose names appear in this space-separated list are omitted from the druid entirely and are not shown.

required_configlets

Configlets whose names appear in this space-separated list are considered "required". This means that they are displayed with "(mandatory)" added to their descriptions, and their check boxes are checked and set insensitive (so that the user cannot uncheck the box).

how_only_listed_configlets

By default, the druid loads and shows all of the configlets it finds, subject to exceptions. If this item is given, only configlets explicitly mentioned in the configuration file are loaded and shown.

tandard_configlets

This item is ignored unless how_only_listed_configlets is also given. In that case, it consists of a space-separated list of configlets that are to be shown in the normal way.

unchecked_configlets

Configlets whose names appear in this space-separated list are displayed with their check boxes unchecked by default.

/usr/share/configlets

The location from which all configlets are loaded.

/etc/configlets-druid.cfg

The configuration file.

Jeff Licquia <jlicquia@progeny.com>

Eric Gillespie, Jr. <epg@progeny.com>