# Command Reference

## The &kbabel; menu

### The File Menu

&Ctrl;O File Open

- Opens a PO file. If the current file is modified you will be prompted to save it first.

File Open Recent

- Opens a recently edited PO file from the recently-used documents menu

&Ctrl;S File Save

- Saves the current PO file. If it is not modified no action is taken.

File Save As

- Saves the current PO file under a new name

File Save Special

- Displays the Save Settings dialogue and then saves the current PO file under a new name

File Revert

- Loads the last saved version of the current PO file

File Mail

- Prompts for an archive filename in which to store the current PO file then opens an email composer window with the archive as an attachment

File New View

- Opens a new window with the currently loaded file. Very useful if you have to translate large files and need to refer back to some strings.

File New Window

- Opens a new empty window

&Ctrl;Q File Quit

- Quits &kbabel; editor

### The Edit Menu

&Ctrl;Z Edit Undo

- Undoes the last edit action in the translation edit box

&Ctrl;&Shift;Z Edit Redo

- Redoes the last undone edit action in the translation edit box

&Ctrl;X Edit Cut

- Cuts the selected text and moves it to the clipboard

&Ctrl;C Edit Copy

- Copies the selected text to the clipboard

&Ctrl;V Edit Paste

- Pastes the contents of the clipboard at the current cursor position in the translation edit box.

Edit Select All

- Selects all text in the translation edit box

&Ctrl;F Edit Find...

- Opens a Find dialogue for searching for strings in the current PO file

F3 Edit Find Next

- Finds the next occurrence of a string from the previous search action

&Ctrl;R Edit Replace...

- Opens the Replace dialogue to search for and replace strings in the current PO file

&Ctrl;Delete Edit Clear

- Clears the translation for the current msgid

&Ctrl;Space Edit Copy msgid to msgstr

- Copies the original English string into the translation edit box. This is useful when you do not need to make any changes (or only minor changes) to the original English text (msgstr).

&Ctrl;&Alt;Space Edit Copy search result to msgstr

- Copies a string found after a translation search into the msgstr edit box. This is very useful if you do not want to keep re-translating the same message again and again.

&Ctrl;U Edit Toggle Fuzzy Status

- Toggles the fuzzy status for the current entry. It can be useful to turn fuzzy on, ⪚ to mark the translation for another review.

&Ctrl;&Alt;N Edit Insert Next Tag

- Inserts the next tag found in the msgid into the translation, if the original English string contains markup tags

&Ctrl;&Alt;N Edit Insert Tag

- This submenu contains all markup tags found in the original English string. By selecting one of them you can insert at the current position of cursor in translated text. translation.

Edit Edit Header...

- Edits the PO file header. Actually there are many header lines, which keep the last translated date, translator name and email, language and translated text encoding &etc;.

### The Go Menu

Page Up Go Previous

- Skips to the previous entry in the PO file.

Page Down Go Next

- Skips to the next entry in the PO file.

Go Go to...

- Opens a dialogue to jump to a specific entry number within the PO file.

Go First Entry

- Jumps to the first entry in the PO file.

Go Last Entry

- Jumps to the last entry in the PO file.

&Ctrl;&Shift;Page Up Go Previous fuzzy or untranslated

- Jumps to the entry previous to the current one that is untranslated or marked as fuzzy.

&Ctrl;&Shift;Page Down Go Next fuzzy or untranslated

- Jumps to the next entry after the current one which is untranslated or marked as fuzzy.

&Ctrl;PgUp Go Previous fuzzy

- Jumps to the entry previous to the current one that is marked as fuzzy.

&Ctrl;Page Down Go Next fuzzy

- Jumps to the next entry after the current one that is marked as fuzzy.

&Alt;Page Up Go Previous untranslated

- Jumps to the entry previous to the current one that is untranslated.

&Alt;Page Down Go Next untranslated

- Jumps to the next entry after the current one that is untranslated.

&Shift;Page Up Go Previous error

- Jumps to the previous entry that has an error. This is usually when double-quotes are not escaped or the original string ends with a "newline" (\n) character and the translated string does not (and vice versa).

&Shift;Page Down Go Next error

- Jumps to the next entry with an error.

&Alt;Left Arrow Go Back

- Jump to last visited entry in PO file.

&Alt;Right Arrow Go Forward

- Jump to previous visited entry in PO file.

### The Dictionaries Menu

Note that this menu is dynamic: it depends on the installed dictionaries plugins. By default are three of them.

Dictionaries Search Text KDE Database Search Engine

- Start searching translation for current original English message using &kde; Database Search Engine.

Dictionaries Search Text PO Auxiliary

- Start searching translation for current original English message in PO file defined by user.

Dictionaries Search Text PO Compendium

- Start searching translation for current original English message in compendium file (made by merging all translated messages for one language).

Dictionaries Search Selected Text KDE Database Search Engine

- Start searching selected text using &kde; Database Search Engine.

Dictionaries Search Selected Text PO Auxiliary

- Start searching selected text using file defined by user.

Dictionaries Search Selected Text PO Compendium

- Start searching selected text using compendium file with all language translated messages.

Dictionaries Edit Dictionary

- Allow you to edit content of current dictionary. Useful if you found errors in dictionary and do not want errors to be reported when searching and replacing strings. (Not implemented yet)

### The Tools Menu

Tools Spelling Spell check...

- Display the spell-check configuration dialogue. After you have chosen the desired options, hit OK and the normal spell-checking dialogue will appear.

Tools Spelling Check All...

- Start spell-checking all words for an opened PO file.

Tools Spelling Check From Cursor Position...

- Start spell-checking from current cursor position.

Tools Spelling Check Current...

- Spell-check only current entry from PO file.

Tools Spelling Check Marked Text...

- Spell-check only selected text in MsgStr editbox.

&Ctrl;T Tools Validation Check Syntax

- Check syntax for current PO file. Errors may appear from CVS merging or users' mistakes when the translating process is performed by hand.

&Ctrl;D Tools Validation Check Arguments

- When this option is selected, C-format strings in the original message and the translation are checked to ensure the number of format sequences and the order are consistent.

&Ctrl;H Tools Validation Check Accelerators

- When this option is selected, &kbabel; checks if the number of accelerator characters is identical in both the original and the translated string. Note that accelerator marker is & in &kde; (but not in every programming toolkit). See the Miscellaneous section below to find out how to change a keyboard accelerator.

&Ctrl;K Tools Validation Look for Translated Context Info

- Some original messages are marked with context information to mark them as being unique even if they represent same word. This is because many simple words, such as Save, are translated into many languages. Context information is marked with `_:`. Many unexperienced translators translate the context information and fill their PO files with garbage. Check this box to make sure you will be warned about these errors in a file.

Tools Validation Check Plural Forms (KDE only)

- Check if the PO file contains the correct number of translations for each &kde;-specific plural form message.

&Ctrl;J Tools Validation Check Equations

- Check whether the left side of the translated string is the same as the left side of the original string. Sides are delimited by an equals-sign character.

F5 Tools Diff Show Diff

- Show difference found to the original translated message.

F6 Tools Diff Show Original Text

- Hide difference markings and show msgid only.

Tools Diff Open File for Diff

- Open file to be used for difference lookup.

Tools Diff Diffmode

- Toggle difference mode.

Tools Rough Translation...

- Invoke rough-translation dialogue for automated translation.

Tools Catalogue Manager...

- Open &catalogmanager;. Read &catalogmanager; section for more details.

### The Settings Menu

Settings Show Toolbar

- When checked, the standard toolbar is displayed.

Settings Show Statusbar

- When checked, the bottom statusbar is displayed.

Settings Show Navigation Bar

- When checked, the navigation bar is displayed.

Settings Show Comments

- When checked, the upper-right part of main window, which contains current entry's comments, will be displayed.

Settings Show Tools

- When checked, the bottom-right part of main window, which contain search results through the dictionary, will be displayed.

Settings Configure Key Bindings...

- Opens a configure dialogue for binding keys to actions. This will let you to customise the default key bindings to suite your needs.

Settings Configure Toolbars...

- Standard toolbar-configuration dialogue will open. You can choose which actions will go in which toolbars and what toolbar to customise.

Settings Configure Kbabel...

- All &kbabel;-specific settings go here. Please read the Preferences section for specific topics.

Settings Configure Dictionary KDE Database Search Engine

- Open dialogue for &kde; Database Search Engine configuration.

Settings Configure Dictionary PO Auxiliary

- Open dialogue for PO auxiliary file configuration.

Settings Configure Dictionary PO Compendium

- Open dialogue for PO compendium file configuration.

### The Help Menu

F1 Help Contents

- Open the &kbabel; handbook. It is what you are reading now.

&Shift;F1 Help What's This?

- Cursor change to arrow with question mark and you can click with it on various elements on main window. A quick help window will open.

Help Gettext Info

- Open the gettext manual page in the &kde; Help Centre. This package of tools helps the in process of handling POT and PO files.

Help Report Bug...

- This will open a standard error-reporting dialogue for &kde; It is useful if you experience abnormal behaviour of &kbabel;. &kbabel;'s developer will be glad to receive any comments, wishes, and bug reports.

Help About KBabel...

- Open a message box which inform you about &kbabel;'s version, developer name, and e-mail address.

Help About KDE...

- Open a message box which informs you about the &kde; project, contact information and how you can report bugs and wishes.

Help About Dictionary KDE Database Search Engine

- Display a message box with information about the people who made the &kde; Database Search Engine.

Help About Dictionary PO Auxiliary

- Display a message box with information about the people who made searching in auxiliary file possible.

Help About Dictionary PO Compendium

- Display a message box with information about people who made searching in compendium file possible.

## The &kbabel; toolbars

### Standard Toolbar

Open

- Load PO file in &kbabel; for editing.

Save

- Save current PO file if it is modified.

Undo

- Undo last operation.

Redo

- Redo last operation.

Cut

- Cut selected text and move it to the clipboard.

Copy

- Copy selected text to the clipboard.

Paste

- Paste text from clipboard at the current cursor position.

Find

- Find specified string in current PO-file.

Previous

- Skip to previous entry in PO-file.

Next

- Skip to next entry in PO file.

Copy msgid to msgstr

- Copy original string to translated string edit box.

Search Translations

- Drop-down toolbar for searching selected text using: &kde; Database Search Engine, PO auxiliary file, PO compendium file and other dictionary plugins if available.

Stop

- Stop current search-in-progress.

Catalogue Manager

- Open Catalogue Manager window.

### Navigation Toolbar

Previous

- Skip to previous entry in PO file.

Next

- Skip to next entry in PO file.

First Entry

- Jump to first entry in PO file.

Last Entry

- Jump to last entry in PO file.

Previous fuzzy or untranslated

- Jump to previous fuzzy or untranslated entry in PO file.

Next fuzzy or untranslated

- Jump to next fuzzy or untranslated entry in PO file.

Previous fuzzy

- Jump to previous fuzzy entry in PO file.

Next fuzzy

- Jump to next fuzzy entry in PO file.

Previous untranslated

- Jump to previous untranslated entry in PO file.

Next untranslated

- Jump to next untranslated entry in PO file.

Previous error

- Jump to previous error in PO file.

Next error

- Jump to next error in PO file.

Back

- Jump to last visited entry in PO file.

Forward

- Jump to previous visited entry in PO file.

### Status Bar

Current

- Current message in edited PO file.

Total

- Total number of messages in PO file.

Fuzzy

- Number of messages marked as fuzzy. They should be revised and translated if needed.

Untranslated

- Number of yet untranslated messages.

Editor status

- INS - insert, and OVR - overwrite. Same meaning like in every ordinary text editor.

PO-file status

- RO - read-only file, RW - read-write access on file. When a file is read-only you cannot modify entries in editor.

Progress bar

- Usually, this bar is hidden; it is displayed only when saving is being done, or if you are searching for messages in a PO-file, compendium or elsewhere.

## The &catalogmanager; menu

### The File Menu

&Ctrl;Q File Quit

- Quits &catalogmanager;

### The Edit Menu

&Ctrl;F Edit Find in Files...

- Open Find dialogue for searching for strings in a set of PO files.

&Ctrl;R Edit Replace in Files...

- Open Replace dialogue for searching for and replacing strings in a set of PO files.

Escape Edit Stop Searching

- Stop currently running find/replace operation.

&Ctrl;M Edit Toggle Marking

- Toggle mark for the selected file.

Edit Remove Marking

- Removes mark for the selected file or folder.

Edit Toggle All Markings

- Toggles marks for the selected file or folder (recursively).

Edit Remove All Markings

- Remove marks for the selected file or folder (recursively).

### The Tools Menu

&Ctrl;S Tools Statistics

- Show statistics about number of translated/untranslated/fuzzy messages for the selected file or subtree.

&Ctrl;Y Tools Check Syntax

- Check syntax for the selected file or subtree using msgfmt.

### The Settings Menu

Settings Show Toolbar

- When checked, standard toolbar is displayed.

Settings Show Statusbar

- When checked, bottom statusbar is displayed.

Settings Configure Key Bindings...

- Opens a configure dialogue for binding keys to actions. This will let you to customise the default key bindings to suite your needs.

Settings Configure Toolbars...

- Standard toolbar-configuration dialogue will open. You can choose which actions will go in which toolbars and what toolbar to customise.

Settings Configure KBabel - Catalogue Manager...

- All &catalogmanager; specific settings go here. Please read Preferences section for specific topics.

### The Help Menu

&help.menu.documentation;