NAME

arify - execute program with input methods

SYNOPSYS

arify [options] pathname [args]

DESCRIPTION

Executes the program referred to by pathname, passing args as its command-line arguments.

If the program uses a line editor supported by ARIF, it will be provided with the ability to interact with input method engines. The exact behaviour depends on the frontend specified.

OPTIONS

-e engines: Overrides the ARIFY_ENGINES environment variable with engines.

: If multiple -e options are provided, the resulting value is a concatentation of each engines, with an ASCII Space character as separator.

-f frontend: Overrides the ARIFY_FRONTEND environment variable with frontend.
-l log-file: Overrides the ARIFY_LOG_FILE environment variable with log-file.
-n page-size: Overrides the ARIFY_PAGE_SIZE environment variable with page-size.
-p preload-library: Path to the preload library (e.g. "/usr/local/lib/libarify.so").

: Default value depends on the specified install directory when building ARIF.

-V: Prints the version number of ARIF, and then exits.

EXIT STATUS

If an error occurs before pathname is executed, the program exits with status 1. Otherwise, the exit status equals to that program's exit status.

ENVIRONMENT

ARIFY_FRONTEND: The frontend program to use.

: If the variable is unset or empty, value "readline" will be used.

ARIFY_ENGINES: Whitespace-separated list of input method engines to use. At least one engine should be specified.
ARIFY_LOG_FILE: Path to the file where error logs (and debug logs, if enabled) will be written to.

: If the variable is unset or empty, value "/dev/null" will be used.

ARIFY_PAGE_SIZE: Maximum number of candidates per page (at most 99).

: If the variable is unset or empty, value 5 will be used.

NOTES

This manual page only contains part of arify's usage. For anything not covered here, please refer to ARIF's Info entry.

COPYRIGHT

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.

You should have received a copy of the license along with this document. If not, see <https://www.gnu.org/licenses/fdl-1.3.html>.