.\" This file is distributed under the same license as the ibus

.\" package.

.\" Copyright (C) Takao Fujiwara <takao.fujiwara1@gmail.com>, 2013-2017.

.\" Copyright (c) Peng Huang <shawn.p.huang@gmail.com>, 2013.

.\"

.TH "IBUS" 1 "May 2017" "@VERSION@" "User Commands"

.SH NAME

.B ibus

\- command line utility for ibus

.SH "SYNOPSIS"

.B ibus

\fICOMMAND\fR [\fIOPTION\fR]...

.SH "DESCRIPTION"

.PP

IBus is an Intelligent Input Bus. It is a new input framework for Linux

OS. It provides full featured and user friendly input method user

interface.  It also may help developers to develop input method easily.  

.PP

.B ibus

is a command line utility which can restart or exit ibus-daemon,

get or set the current ibus engine or list the ibus engines.

.PP

Homepage: https://github.com/ibus/ibus/wiki

.SH "COMMAND"

.TP

\fBhelp\fR

Show the commands list.

.TP

\fBengine\fR [\fBENGINE_NAME\fR]

Show the curent ibus engine when

.B ENGINE_NAME

is not given. Set 

.B ENGINE_NAME

to the current ibus engine.

.TP

\fBexit\fR

Exit ibus-daemon.

.TP

\fBlist-engine\fR

Show ibus engines list.

.TP

\fBrestart\fR

Restart ibus-daemon.

.TP

\fBversion\fR

Show the ibus version.

.TP

\fBread\-cache\fR [\fB\-\-system|\-\-file=FILE\fR]

Show the content of the user registry cache if

.B \-\-system

is not given.

Show the content of the system registry cache if

.B \-\-system

is given.

Show the content of the custom registry cache 

.B FILE

if

.B \-\-file=FILE

is given.

.TP

\fBwrite\-cache\fR [\fB\-\-system|\-\-file=FILE\fR]

Save the user registry cache if

.B \-\-system

is not given.

Save the system registry cache if

.B \-\-system

is given.

Save the custom registry cache

.B FILE

if

.B \-\-file=FILE

is given.

By default, it reads the component XML files from the standard

component directory (\fI/usr/share/ibus/component\fP), you can set

\fIIBUS_COMPONENT_PATH\fP environment variable for custom component

directories, separated by ':'.

.TP

\fBaddress\fR

Show the D-Bus address of ibus-daemon.

.TP

\fBread\-config\fR

Print the setting values in a gsettings configuration file.

.TP

\fBreset\-config\fR

Reset the user setting values to the default ones in a gsettings

configuration file.

.TP

\fBwatch\fR

Under construction.

.TP

\fBemoji\fR [\fB\-\-font=FONT|\-\-lang=LANG|\-\-help|\-\-partial\-match\fR]

Launch IBus Emojier (

.B ibus\-emoji (1)

) and save the selected emoji to your clipboard. Can choose an emoji font with

.B \-\-font

option. Can choose a language of emoji annotations with

.B \-\-lang

option. If LANG="en", IBus Emojier loads /usr/share/ibus/dicts/emoji-en.dict .

.B \-\-partial\-match

option enables to match annotations with a partial string. These settings

are avaiable with

.B ibus\-setup (1)

utility.

.SH BUGS

If you find a bug, please report it at https://github.com/ibus/ibus/issues

.SH "SEE ALSO"

.BR ibus-emoji (7)