This document represents a proposed Change. As part of the Changes
process, proposals are publicly announced in order to receive
community feedback. This proposal will only be implemented if approved
by the Fedora Engineering Steering Committee.
== Summary ==
In IBus 1.5.27, `ibus restart` subcommand will be enhanced to be able
to restart ibus-daemon in GNOME desktop, `ibus im-module` subcommand
will be added to get internal gtk-im-module value in an GTK instance,
ibus-setup will provides custom themes for the IBus candidate window.
== Owner ==
* Name: [[User:Fujiwara|Takao Fujiwara]]
* Email: fujiwara [at] redhat [dot] com
== Detailed Description ==
* `ibus restart` subcommand will be enhanced to be able to restart
ibus-daemon via systemd for GNOME desktop. ibus-daemon is launched via
systemd in GNOME desktop. `ibus restart` will restart ibus-daemon with
systemd at first and with an IBus API directly at second and it also
provides `--help` option to get other option arguments for the
subcommand and `--type=direct` and `--type=systemd` subcommands are
available.
* `ibus im-module` subcommand will be added to get an internal
gtk-im-module value from an instance of an GTK instance. Some users
would fail to setup IBus and this subcommand will help them to check
whether "ibus" is set to the gtk-im-module in the actual process.
* ibus-setup will provides custom themes in the "Advanced" tab for
IBus candidate window. IBus candidate window is composed by GTK and If
the current desktop is composed by GTK likes GNOME, the desktop
provides a utility to customize the themes. But if not, this feature
is useful for the users.
== Benefit to Fedora ==
Users can restart ibus-daemon with `ibus restart`. When users install
new IBus engines, ibus-daemon has to be restarted to load the new
engine lists, If users might encounter a bug, users would like to
restart ibus-daemon. IM developers also sometimes restart ibus-daemon
to debug IBus or the engines. `ibus im-module` subcommand is also
useful when a users failed to setup IBus. Providing IBus custom themes
is useful for Plasma desktop which theme utility does not change GTK
themes.
== Scope ==
* Proposal owners: ibus
* Other developers: NONE
* Release engineering:
* Policies and guidelines: N/A
* Trademark approval: N/A
* Alignment with Objectives:
== Upgrade/compatibility impact ==
`ibus restart` should not have any regressions in any desktops.
== How To Test ==
* IBus restart
** Log into GNOME desktop session
** Run `ibus restart` and then ibus-daemon PID is changed.
* IBus im-module
** Run `ibus im-module` and get "ibus"
* IBus custom theme
** Log into Plasma desktop session
** Run ibus-setup and configure IM engines in "Input Method" tab, who
can show the candidate window likes ibus-libpinyin, ibus-anthy.
** Run ibus-setup and configure custom themes in "Advanced" tab and
confirme the theme of the candidate window is changed.
== User Experience ==
`ibus restart` command line interface is available to restart the
input method features and ibus-setup provides custom themes for ithe
appearance of the input method candidate window.
== Dependencies ==
`ibus restart --type=systemd` requires systemd.
`ibus im-module` subcommand requires gtk4 or gtk3 or gtk2.
== Contingency Plan ==
* Contingency mechanism: Revert the change to IBus.
* Contingency deadline: Beta release
* Blocks release? No
== Documentation ==
TBD
== Release Notes ==
TBD
--
Vipul Siddharth
He/His/Him
FPgM team member