From b31b0d5b52ee195bc46d12c28825fe2ca3459235 Mon Sep 17 00:00:00 2001 From: sigmdel Date: Wed, 2 Jun 2021 15:38:49 -0300 Subject: [PATCH] Update for version 0.2.0 --- README.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 8a075ca..bb7aa5d 100644 --- a/README.md +++ b/README.md @@ -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. ---