Multi-Po-Edit Files

PO File Editor v1.4 Evan Compton
All binary executibles and source code files are licensed
under the Simplified BSD License. A copy is provided on the
PO Editor project site at sourceforge and may be requested for.

=====================
INSTRUCTIONS FOR USE
=====================
	
Overview:
This file editor is used to both compare .po files and
edit/add IDs, translations, and comments to them.

Initial Setup:

You will be prompted for an initial file, this will be
the blueprint for the program. As such, this file should
be the most complete .po file you have written as only its
ID's and comments will be observed.

Viewing the PO Table:

The table is setup with the ID's in the first column,
comments in the second and translations for each corresponding
file in the proceeding columns. You can scroll through
the table and adjust column widths using the column headers.

Editing the PO Table:

To edit a value, the entry must be clciked on twice to bring
up the editing mode. For the program to rcognize an edit has
been made, you must then click of the elemnt thus exiting the
edit mode.

Searching the PO Table:

The search bar at the top provides an easy way to find the ID
you are looking for. Enter any term (not case sensitive) and
the program will search for it as you type. You can go through
each matching ID by using the back and next buttons and restart
a search by hitting the search button. PLEASE NOTE: Only one
term may be searche for at a given time.

Saving your work:

Click the Save All item under Save to record all changes made to
the file. IMPORTANT: This program saves by creating a new file and
erasing your old one. It is highly recommended to back up your
original document if you are not using a code repository in case an
error occurs resulting in data loss.

Opening a new file:

Click the open item under the File menu to add a new file to the
table.This essentially causes a program restart with the new file
now appearing in a new column. Your work is automatically saved 
prior to opening.

Closing a file:

Go to the close item under the file menu and select a file to close.
Each file is numbered by its ordered in the table. This will cause a
program restart with the file now removed from the table. If you selected
the initial file, the file added after will now be used as the blueprint.
Your work is automatically saved prior to closing.

==================

SPECIAL FUNCTIONS

==================

Font:

If you wish to change the font size select the font option from the File
menu. The size you provide will change the appearance of the table elements
while in view mode, edit mode will remain unchanged.

Find Files:

This option allows you to see what files a specified ID appears in. In order
for this to work properly you must highlight an ID prior to selecting this
option. You will then be prompted for a folder to search through. PLEASE NOTE:
This function will search all files in the folder as well as all files in every
folder under this folder. As such searching can be slow or even lock up if a large
folder is choosen. Narrowing down the search greatly improves search time.

Viewing Find Files Results:

Once a file find search has completed a new tab will open with the ID as its name.
The format is the same as the main table and lists the files name, path, and the
lines at which the ID occurs. You can close the tab by clicking the x icon.

Add IDS:

You can specify how many IDs you would like to append to the table. After specifying
a number the program will result with the new rows added to the end of the table. Your
work will automatically be saved prior to the add. IMPORTANT: If you leave any rows
unedited they will be appended regardless. There is currently no way to cancel an add
so you will have to manually delete any rows you did not edit. This is very important if
you leave more than one row blank as it will cause a msgfmt failure.

====================
CONTACT INFORMATION
====================

If you have any questions or comments regarding this application, find bugs, or want 
the source code please email Evan Compton at ecompton3@gatech.edu