Tools > ExtractReworked

The ExtractReworked tool can be used to incorporate changed translation results into the already translated code without overwriting the manual changes. Using this tool only makes sense if most of the translated files are used unchanged, because only changes in these files are automatically applied.

ExtractReworked -g GeneratedFiles -w WorkingFiles -r ReworkedFiles [-m Filemask] [-c] [-c]

Parameter	Name	Meaning

-g	generated files	path to a directory where the newly translated files will be written
-w	working files	path to the directory where the translated files used in the C++ project are located
-r	reworked files	path to a directory where manually modified files are saved
-m	file mask	optional file mask like \".cpp;.h\", if not specified, all files are processed
-c	clean	first clean the existing reworked directory i.e. delete all files and folders contained therein
-d	delete	may delete files in the reworked directory, if the generated file doesn't differ from the working file any more

It is important that the files generated by Delphi2Cpp are already in the "generated" directory before using ExtractReworked. Otherwise all manual changes will be lost. ExtractReworked then should be called as the first of four steps within a batch file.

1. ExtractReworked compares all files from the "generated" directory with the files from "working". In cases where the file contents differ, the versions from the "working" directory are saved to the "reworked" directory.

2. The C++ files are recreated with Delphi2Cpp from the Delphi code in the "generated" directory.

3. The newly generated C++ files are all copied from the "generated" directory to the "working" directory. This step overrides the manual changes.

4. The files previously saved in the "reworked" directory are copied to the "working" directory, so the manual changes are restored.

The result of this process is that all changes from the new translation in files that were not manually post-processed were incorporated into the "working" code. Changes to files that were previously edited manually must now be transferred manually.

If you use a version control system, only the “reworked” files need to be saved in it.

The use of the ExtractReworked process is recommended, for example, if the identifier list needs to be optimized. Changes to the project options can also be tested in this way. The use of ExtractReworked is particularly successful when the customer collaborates with the manufacturer of Delphi2Cpp.