mirrors/pulseaudio
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/pulseaudio/pulseaudio.git synced 2025-11-25 06:59:52 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions
pulseaudio/src/modules/gsettings/org.freedesktop.pulseaudio.gschema.xml

116 lines
3 KiB
XML
Raw Normal View History

module-gsettings: new module to store configuration using gsettings GConf is deprecated, and distributions are removing it. paprefs depends on GConf, so in order to avoid paprefs getting removed as well, paprefs has to be changed to use something else than GConf. GSettings is the easiest alternative to migrate to, although it has the same problems that GConf had: no support for system mode or networking. This patch takes the non-GConf specific code from module-gconf and puts it in stdin-util.[ch], which is then reused by module-gsettings. module-gsettings is designed to be very similar to module-gconf. Migration is expected to happen as follows: Distributions update PulseAudio and paprefs at the same time, or first PulseAudio and then paprefs. paprefs depends on module-gsettings, and module-gsettings conflicts with module-gconf. Therefore module-gconf gets automatically removed during the paprefs update. After the update an old PulseAudio is likely to be running with module-gconf loaded. If the user tries to use paprefs during this period, whatever the user does in paprefs won't have any effect until PulseAudio is restarted (probably by a reboot or relogin). This is not ideal, but will have to do. When module-gsettings is loaded, it runs gsettings-data-convert (implemented in a later patch). That will copy the settings from GConf to GSettings. If gsettings-data-convert is not available (it's part of GConf, so it may have already been uninstalled), then any previous paprefs settings are lost.
2016-07-25 21:58:48 +02:00
<schemalist gettext-domain="pulseaudio">
gsettings: rename "module" to "module-group" It is confusing if there's a thing named "module" which defines up to 10 modules to load. Calling the thing a "module group" instead should make it easier to understand.
2018-04-17 09:07:36 +03:00
<!-- The module-groups object is just an entry point to find the individual
module-group objects. -->
<schema id="org.freedesktop.pulseaudio.module-groups" path="/org/freedesktop/pulseaudio/module-groups/">
<child name="combine" schema="org.freedesktop.pulseaudio.module-group"/>
<child name="remote-access" schema="org.freedesktop.pulseaudio.module-group"/>
<child name="zeroconf-discover" schema="org.freedesktop.pulseaudio.module-group"/>
<child name="raop-discover" schema="org.freedesktop.pulseaudio.module-group"/>
<child name="rtp-recv" schema="org.freedesktop.pulseaudio.module-group"/>
<child name="rtp-send" schema="org.freedesktop.pulseaudio.module-group"/>
<child name="upnp-media-server" schema="org.freedesktop.pulseaudio.module-group"/>
gsettings: add the modules schema to the schema description file Originally the idea was to provide the "modules" schema with paprefs, but since module-gsettings refers to the "modules" schema in its code, that would make module-gsettings depend on paprefs, which is not good. Now all schemas are provided by module-gsettings, so the paprefs dependency is avoided. Unfortunately this means that if paprefs is modified to load some new modules, the schema in pulseaudio needs to be updated as well.
2018-04-17 09:07:34 +03:00
</schema>
gsettings: rename "module" to "module-group" It is confusing if there's a thing named "module" which defines up to 10 modules to load. Calling the thing a "module group" instead should make it easier to understand.
2018-04-17 09:07:36 +03:00
<!-- Paprefs puts related modules into groups that are enabled or disabled as
a whole. One group can contain up to 10 module instances (either of the
same module or different modules). A module-group object defines up to
10 modules to load. The name0..name9 keys contain the module names and
the args0..args9 keys provide the module arguments. -->
<schema id="org.freedesktop.pulseaudio.module-group">
module-gsettings: new module to store configuration using gsettings GConf is deprecated, and distributions are removing it. paprefs depends on GConf, so in order to avoid paprefs getting removed as well, paprefs has to be changed to use something else than GConf. GSettings is the easiest alternative to migrate to, although it has the same problems that GConf had: no support for system mode or networking. This patch takes the non-GConf specific code from module-gconf and puts it in stdin-util.[ch], which is then reused by module-gsettings. module-gsettings is designed to be very similar to module-gconf. Migration is expected to happen as follows: Distributions update PulseAudio and paprefs at the same time, or first PulseAudio and then paprefs. paprefs depends on module-gsettings, and module-gsettings conflicts with module-gconf. Therefore module-gconf gets automatically removed during the paprefs update. After the update an old PulseAudio is likely to be running with module-gconf loaded. If the user tries to use paprefs during this period, whatever the user does in paprefs won't have any effect until PulseAudio is restarted (probably by a reboot or relogin). This is not ideal, but will have to do. When module-gsettings is loaded, it runs gsettings-data-convert (implemented in a later patch). That will copy the settings from GConf to GSettings. If gsettings-data-convert is not available (it's part of GConf, so it may have already been uninstalled), then any previous paprefs settings are lost.
2016-07-25 21:58:48 +02:00
<key name="name" type="s">
<default>''</default>
gsettings: rename "module" to "module-group" It is confusing if there's a thing named "module" which defines up to 10 modules to load. Calling the thing a "module group" instead should make it easier to understand.
2018-04-17 09:07:36 +03:00
<summary>Module group name</summary>
<description>Module group name</description>
module-gsettings: new module to store configuration using gsettings GConf is deprecated, and distributions are removing it. paprefs depends on GConf, so in order to avoid paprefs getting removed as well, paprefs has to be changed to use something else than GConf. GSettings is the easiest alternative to migrate to, although it has the same problems that GConf had: no support for system mode or networking. This patch takes the non-GConf specific code from module-gconf and puts it in stdin-util.[ch], which is then reused by module-gsettings. module-gsettings is designed to be very similar to module-gconf. Migration is expected to happen as follows: Distributions update PulseAudio and paprefs at the same time, or first PulseAudio and then paprefs. paprefs depends on module-gsettings, and module-gsettings conflicts with module-gconf. Therefore module-gconf gets automatically removed during the paprefs update. After the update an old PulseAudio is likely to be running with module-gconf loaded. If the user tries to use paprefs during this period, whatever the user does in paprefs won't have any effect until PulseAudio is restarted (probably by a reboot or relogin). This is not ideal, but will have to do. When module-gsettings is loaded, it runs gsettings-data-convert (implemented in a later patch). That will copy the settings from GConf to GSettings. If gsettings-data-convert is not available (it's part of GConf, so it may have already been uninstalled), then any previous paprefs settings are lost.
2016-07-25 21:58:48 +02:00
</key>
<key name="enabled" type="b">
<default>false</default>
</key>
<key name="locked" type="b">
<default>false</default>
</key>
<key name="args0" type="s">
<default>''</default>
</key>
<key name="args1" type="s">
<default>''</default>
</key>
<key name="args2" type="s">
<default>''</default>
</key>
<key name="args3" type="s">
<default>''</default>
</key>
<key name="args4" type="s">
<default>''</default>
</key>
<key name="args5" type="s">
<default>''</default>
</key>
<key name="args6" type="s">
<default>''</default>
</key>
<key name="args7" type="s">
<default>''</default>
</key>
<key name="args8" type="s">
<default>''</default>
</key>
<key name="args9" type="s">
<default>''</default>
</key>
<key name="name0" type="s">
<default>''</default>
</key>
<key name="name1" type="s">
<default>''</default>
</key>
<key name="name2" type="s">
<default>''</default>
</key>
<key name="name3" type="s">
<default>''</default>
</key>
<key name="name4" type="s">
<default>''</default>
</key>
<key name="name5" type="s">
<default>''</default>
</key>
<key name="name6" type="s">
<default>''</default>
</key>
<key name="name7" type="s">
<default>''</default>
</key>
<key name="name8" type="s">
<default>''</default>
</key>
<key name="name9" type="s">
<default>''</default>
</key>
</schema>
</schemalist>
Reference in a new issue Copy permalink