Docs: describe *noconfig* module option
This commit is contained in:
parent
fbb452f9bf
commit
d1f162f92a
@ -54,10 +54,12 @@ Module descriptors for Python and PythonQt modules **must** have the following k
|
||||
- *script* (the name of the Python script to load, nearly always `main.py`)
|
||||
|
||||
Module descriptors **may** have the following keys:
|
||||
- *requiredModules* (a list of modules which are required for this module
|
||||
to operate properly)
|
||||
- *emergency* (a boolean value, set to true to mark the module
|
||||
as an emergency module)
|
||||
- *noconfig* (a boolean value, set to true to state that the module
|
||||
has no configuration file; defaults to false)
|
||||
- *requiredModules* (a list of modules which are required for this module
|
||||
to operate properly)
|
||||
|
||||
### Required Modules
|
||||
|
||||
@ -96,6 +98,12 @@ named `<modulename>.conf`. If such a file is present in the
|
||||
module's directory, it can be shipped as a *default* configuration file.
|
||||
This only happens if the CMake-time option `INSTALL_CONFIG` is on.
|
||||
|
||||
Modules that have *noconfig* set to true will not attempt to
|
||||
read a configuration file, and will not warn that one is missing;
|
||||
conversely if *noconfig* is set to false (or is missing, since
|
||||
the default value is false) if there is no configuration file,
|
||||
a warning is printed during Calamares start-up.
|
||||
|
||||
The sample configuration files may work and may be suitable for
|
||||
your distribution, but no guarantee is given about their stability
|
||||
beyond syntactic correctness.
|
||||
@ -122,7 +130,8 @@ to provide jobs.
|
||||
|
||||
To add a Qt plugin module, put it in a subdirectory and make sure it has
|
||||
a `CMakeLists.txt` with a `calamares_add_plugin` call. It will be picked
|
||||
up automatically by our CMake magic. The `module.desc` file is optional.
|
||||
up automatically by our CMake magic. The `module.desc` file is not recommended:
|
||||
nearly all cases can be described in CMake.
|
||||
|
||||
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user