%progeny-entity; ]>
NAME
configlets-druid — GNOME front end to run configlets in a wizard-like manner.
SYNOPSIS
configlets-druid [--ask-only | --commit-only ] [configlet_dir]
DESCRIPTION
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.
OPTIONS
- --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/.
CONFIGURATION
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).
- show_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.
- standard_configlets
-
This item is ignored unless show_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.
FILES
- /usr/share/configlets
-
The location from which all configlets are loaded.
- /etc/configlets-druid.cfg
-
The configuration file.
AUTHORS
Jeff Licquia <[email protected]>
Eric Gillespie, Jr. <[email protected]>