# Command Reference

## The &kbabel; menu

### The File Menu

&Ctrl;O File Open

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

File Open Recent

  The recently-used documents list menu is displayed, allowing you to open recently edited PO files.

&Ctrl;S File Save

  Saves current POfile. If it's not modified no action is taken.

File Save As

  Saves current PO file under new name.

File Revert

  Load the last saved version of the current PO file.

File New View

  Open a new window with current file loaded. Very useful if you have to translate large files and you need to keep an eye back to some strings.

File New Window

  Open a new empty window.

&Ctrl;Q File Quit

  Quits &kbabel;

### The Edit Menu

&Ctrl;Z Edit Undo

  Undo the last edit action in the translation edit box.

&Ctrl;Shift Z Edit Redo

  Redo last undoedne edit action in translation edit box.

&Ctrl;X Edit Cut

  Cut the selected text and move it in clipboard.

&Ctrl;C Edit Copy

  Copy the selected text to the clipboard.

&Ctrl;V Edit Paste

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

Edit Select All

  Select all text from translation edit box.

&Ctrl;F Edit Find...

  Open Find dialog for searching strings in current PO file.

F3 Edit Find Next

  Find next occurrence of string from previous search action.

&Ctrl;R Edit Replace...

  Open the Replace dialog for searching and replacing strings in current PO-file.

&Ctrl;Delete Edit Clear

  Clears the translation for current msgid.

&Ctrl;Space Edit Copy msgid to msgstr

  The original English string is copied into the translation edit box. This useful when you need to make from no adjustment to minor changes in the original English text (msgstr).

&Ctrl;Alt Space Edit Copy search result to msgstr

  String found after translation searching is copied in msgstr edit box. This is very useful if you don't want to work on retranslating the same message again and again.

&Ctrl;U Edit Toggle Fuzzy Status

  Toggles fuzzy status for currenty entry. It can be useful to turn fuzzy on, e.g. to mark the translation for another review.

&Ctrl;Alt N Edit Insert Next Tag

  If original english string contains markup tags, this inserts next tag found in msgid to the translation.

&Ctrl;Alt N Edit Insert Tag

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

Edit Edit Header...

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

### The Go Menu

PgUp Go Previous

  Skip to previous entry in PO file.

PgDown Go Next

  Skip to next entry in PO file.

Go Go to...

  Open dialog to jump to specified entry number from PO file.

Go First Entry

  Jump to first entry in PO file.

Go Last Entry

  Jump to last entry in PO file.

&Ctrl;Shift PgUp Go Previous fuzzy or untranslated

  Jump to first previous entry which is untranslated or marked as fuzzy.

&Ctrl;Shift PgDown Go Next fuzzy or untranslated

  Jump to first next entry which is untranslated or marked as fuzzy.

&Ctrl;PgUp Go Previous fuzzy

  Jump to first previous fuzzy entry.

&Ctrl;PgDown Go Next fuzzy

  Jump to first next fuzzy entry.

&Alt;PgUp Go Previous untranslated

  Jump to first previous untranslated entry.

&Alt;PgDown Go Next untranslated

  Jump to first next untranslated entry.

Shift PgUp Go Previous error

  Jump to previous entry with error. It's likely to happen when you forget to escape doublequotes or original string end in "return" (\n) char and translated string don't (and vice versa).

Shift PgDown Go Next error

  Jump to next entry with error. It's likely to happen when you forget to escape doublequotes or original string end in "return" (\n) char and translated string don't (and vice versa).

&Alt;Left Go Back

  Jump to last visited entry in PO file.

&Alt;Right Go Forward

  Jump to previous visited entry in PO file.

### The Dictionaries Menu

Note that this menu is dynamic. It depend on 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. Usefull if you found errors in dictionary and want to not be bored by errors when searching and replacing strings. (Not implemented yet)

### The Tools Menu

Tools Spelling Spell check...

  Bring up spell check configuration dialog. After you select desired options hit OK and the normal spell checking dialog will appear.

Tools Spelling Check All...

  Start spell checking all words for opened PO file.

Tools Spelling Check From Curson 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 translating process is made by hand.

&Ctrl;D Tools Validation Check Arguments

  When this option is selected C-format strings in the original 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 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 PO file contains right number of translation for each &kde;-specific plural form messages.

&Ctrl;J Tools Validation Check Equations

  Check if left side from translated string is same with left side from original string. Sides are delimited by equal sign character.

F5 Tools Diff Show Diff

  Show difference found to the original translated message.

F6 Tools Diff Show Original Tex

  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 dialog for automated translation.

Tools Catalog Manager...

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

### The Settings Menu

Settings Show Toolbar

  When checked, standard toolbar is displayed.

Settings Show Statusbar

  When checked, bottom statusbar is displayed.

Settings Show Navigationbar

  When checked, navigationbar is displayed.

Settings Show Comments

  When checked, upper right part of main window which contain current entry comments will be displayed.

Settings Show Tools

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

Settings Configure Key Bindings...

  Open configure dialog for keys bindings to actions. This will let you to customize default key bindings to suite your needs.

Settings Configure Toolbars...

  Standard toolbars configuration dialog will open. You can choose which actions will go in toolbars and what toolbar you customize.

Settings Configure Kbabel...

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

Settings Configure Dictionary KDE Database Search Engine

  Open dialog for &kde; Database Search Engine configuration.

Settings Configure Dictionary PO Auxiliary

  Open dialog for PO auxiliary file configuration.

Settings Configure Dictionary PO Compendium

  Open dialog for PO compendium file configuration.

### The Help Menu

F1 Help Contents

  Open the &kbabel; handbook. It's what you read 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 &kde; Help Center. This package of tools help in process of POT and PO files handling.

Help Report Bug...

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

Help About KBabel...

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

Help About KDE...

  Open message box which inform you about the &kde; project, contact information and how you can report bugs and whishes.

Help About Dictionary KDE Database Search Engine

  Show up an message box with information about people who made &kde; Database Search Engine.

Help About Dictionary PO Auxiliary

  Show up an message box with information about people who made searching in auxiliary file.

Help About Dictionary PO Compendium

  Show up an message box with information about people who made searching in compendium file.

## The &kbabel; toolbars

### Standard Toolbar

Open

  Load PO file in &kbabel; for editing.

Save

  Save current PO file if it's modified.

Undo

  Undo last operation.

Redo

  Redo last operation.

Cut

  Cut selected text and move it in clipboard.

Copy

  Copy selected text in clipboard.

Paste

  Paste text from clipboard at 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 others dictionary plugins if available.

Stop

  Stop current searching in progress.

Catalog Manager

  Open Catalog 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 file is read-only you cannot modify entries in editor.

Progress bar

  Usualy, this bar is hidden. It is displayed only when saving is done or you search messages in PO-file, compendium or else.

## The &catalogmanager; menu

### The File Menu

&Ctrl;Q File Quit

  Quits &catalogmanager;

### The Edit Menu

&Ctrl;F Edit Find in Files...

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

&Ctrl;R Edit Replace in Files...

  Open Replace dialog for searching 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 directory.

Edit Toggle All Markings

  Toggles marks for the selected file or directory (recursively).

Edit Remove All Markings

  Remove marks for the selected file or directory (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...

  Open configure dialog for keys bindings to actions. This will let you to customize default key bindings to suite your needs.

Settings Configure Toolbars...

  Standard toolbars configuration dialog will open. You can choose which actions will go in toolbars and what toolbar you customize.

Settings Configure KBabel - Catalog Manager...

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

### The Help Menu

&help.menu.documentation;