# Insert Command

Anders
Lund

    anders@alweb.dk

2001-05-15
1.00.00

KDE
kate
insert

# Introduction

The Insert Command plugin allows you to insert shell command output into a document open in &kate;.

## Onscreen Fundamentals

To use the plugin, select Insert Command from the Edit menu, which will present you with a small dialog for entering the command, choosing a working directory and selecting whether to include errors (STDERR output) in the inserted text. You can also have the command string printed above the output.

The Insert Command Dialog

The plugin can remember a number of commands as chosen in the configuration page. These are used for autocompletion, and can be selected from a list in the command entry.

By default, the command will be run in the working directory of the kate process, which is usually your home directory. This can be changed in the configuration page for the plugin.

Note that any shell command that requires user input (for example passwd) or uses a ncurses interface or something similar (for example top) will fail to produce the expected output.

## Configuration

To configure the Insert Command plugin, open the Kate configuration dialog from the Settings menu and choose the Plugins/Insert Command page.

The following configuration options are available:

### Number of commands to remember

This setting is presented as a spinbox which you can set to the number of commands to be remembered. Any number from 0 to 99 is legal.

### Default Working Directory

This setting, presented as a set of radio buttons, allows you to decide how the working directory of a command is chosen. The options are the working directory of the kate process (usually your home directory when kate is started from the K menu), the directory of the document (if any, otherwise the above option is used) or the working directory of the last command run in the plugin.

## Thanks and Acknowledgements

&kate; Plugin Insert Command copyright 2001 Anders Lund anders@alweb.dk.

Documentation copyright 2001 Anders Lund anders@alweb.dk

&underGPL;