boolean force_reset

If 'true', discard anything that may be cached and start over from scratch. If 'false', use cached values from the last invocation if there are any.

boolean language_changed

The installation language has changed since the last call of MakeProposal. This is important only if there is a language change mechanism in one of the other submodules. If this parameter is "true", any texts the user can see in the proposal need to be retranslated. The internal translator mechanism will take care of this itself if the corresponding strings are once more put through it (the _("...") function). Only very few submodules that translate any strings internally based on internal maps (e.g., keyboard etc.) need to take more action.

list<string> links

A list of additional hyperlink ids used in summaries returned by this section. All possible values must be included.

Example:

["device_enable", "device_test"]

string preformatted_proposal (optional)

Human readable proposal preformatted in HTML.

	Note
	You can use the HTML:: module for such formatting.

list raw_proposal

(only used if 'preformatted_proposal' is not present in the result map)

Human readable proposal, not formatted yet. The caller will format each list item (string) as a HTML list item ( "<li> ... </li>" ).

The proposal can contain hyperlinks with ids listed in the list links.

The caller will make a HTML unsorted list of this, e.g.:

<ul>
<li>string from list element #1</li>
<li>string from list element #2</li>
<li>string from list element #3</li>
...
</ul>

string warning (optional)

Warning in human readable format without HTML tags other than <br>.

The warning will be embedded in appropriate HTML format specifications according to 'warning_level' below.

symbol warning_level (optional)

Determines the severity and the visual display of the warning. Valid values:

`blocker will prevent the user from continuing the installation. If any proposal contains a `blocker warning, the "accept" button in the proposal dialog will be disabled - the user needs to fix that blocker before continuing.

`fatal is like `blocker but also stops building the proposal

boolean language_changed (optional)

This module just caused a change of the installation language. This is only relevant for the "language" module.

boolean mode_changed (optional)

This module just caused a change of the installation mode. This is only relevant for the "inst mode" module.

boolean rootpart_changed (optional)

This module just caused a change of the root partition. This is only relevant for the "root part" module.

string help (optional)

boolean has_next

Use a "next" button even if the module by itself has only one step, thus would normally have an "OK" button - or would rename the "next" button to something like "finish" or "accept".

string chosen_id

If a section proposal contains hyperlinks and user clicks on one of them, this defines the id of the hyperlink. All hyperlink IDs must be set in the map retuned by Description. If a user didn't click on a proposal hyperlink, this parameter is not defined.

symbol workflow_sequence

boolean language_changed (optional)

This module just caused a change of the installation language. This is only relevant for the "language" module.

string rich_text_title

(Translated) human readable title for this section in the RichText widget without any HTML formatting. This will be embedded in

<h3><a href="???"> ... </a></h3>

so make sure not to add any additional HTML formatting.

Keyboard shortcuts are not (yet?) supported, so don't include any '&' characters.

Example:

"Input devices"

string menu_title

(Translated) human readable menuentry for this section. Must contain a keyboard shortcut ('&'). Should NOT contain trailing periods ('...') - the caller will add them.

Example:

"&Input devices"

string id

Programmer readable unique identifier for this section. This is not auto-generated to keep the log file readable.

Example:

"input_dev"

boolean success

Returns true, if the settings were written successfully.