Skip to content

Commit

Permalink
Update for version 0.2.0
Browse files Browse the repository at this point in the history
  • Loading branch information
sigmdel committed Jun 2, 2021
1 parent 0e3b3b0 commit b31b0d5
Showing 1 changed file with 6 additions and 5 deletions.
11 changes: 6 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,20 @@
# Free Pascal / Lazarus Po Files Utilities

Eleven command line utilities to modify PO translation files (extentions `.po`) used by [Free Pascal](https://www.freepascal.org/) and [Lazarus](https://www.lazarus-ide.org/).
Eleven command line utilities to modify PO translation files (`.po` extension) used by [Free Pascal](https://www.freepascal.org/) and [Lazarus](https://www.lazarus-ide.org/).

These tools are similar to utilities available for [GNU/Gettext](https://www.gnu.org/software/gettext/) and it's Delphi version [dxgettext](https://sourceforge.net/projects/dxgettext/) with the difference that they are adapted to the `.po` dialect used in Free Pascal / Lazarus. More on that here: [On Translating Free Pascal/Lazarus Programs](https://sigmdel.ca/michel/program/fpl/translating_fpl_en.html).

Besides being tailored to handle Free Pacal / Lazarus generated PO files, the utilies differ from those provided by the GNU gettext project by their style. Each utility does a single task which cannot be modified by command line switches. Indeed, aside from file names, the utilities accept no command line switches or options. So when a `GNU gettext equivalent utility` is given in the list below, the equivalency is obviously partial only and it may be necessary to provide additional filters or scripts to perform the exact same action as the poxxxx utility.
Besides being tailored to handle Free Pascal / Lazarus generated PO files, the utilities differ from those provided by the GNU gettext project by their style. Each utility does a single task which cannot be modified by command line switches. Indeed, aside from file names, the utilities accept no command line switches or options. So when a `GNU gettext equivalent utility` is given in the list below, the equivalency is obviously partial only and it may be necessary to provide additional filters or scripts to perform the exact same action as the poxxxx utility.

It should be possible to compile the utilities for any of the Free Pascal supported targets. They have been used mostly in Linux, but some tests have been done in Windows.

**Version 0.2 (June 2, 2021)**

**Warnings**:
The utilities should now handle extracted and translator comments, all format flags and previous context fields which can be found in PO files generated with the GNU gettext system but which are not in PO files generated by Lazarus as far as the author knows. Translator comments added to a PO file with a translation utility such as poedit should no longer be lost if the PO file is processed with these programs. In any case, an effort has been made to avoid losing any work. In practice, this means that any file about to be overwritten is renamed and thus a backup remains available.

1. The utilities do not handle extracted and translator comments and format flags. As far a the author knows, the Lazarus generated PO files do not contain extracted comments and format flags. In practice then, translator-added comments will be removed from any output PO file created by these utilities. This is unfortunate, but the *bug*, to be fixed in the near future, will not affect translations in any way.
**Warning**:

1. The author offers no guarantee of any sort with regard to these tools. However an effort has been made to avoid losing any work. In practice, this means that any file about to be overwritten is renamed and thus a backup remains available.
The author offers no guarantee of any sort with regard to these tools.

---

Expand Down

0 comments on commit b31b0d5

Please sign in to comment.