| 1 |
## Timezone related options |
| 2 |
|
| 3 |
* WITH_TIMEZONE_COMPILED Use compiled in mapping extracted with tzextract (default ON) |
| 4 |
* WITH_TIMEZONE_FROM_FILE Use JSON file mapping generated with tzextract (default OFF) |
| 5 |
* WITH_TIMEZONE_ICU Use ICU to map IANA to windows timezones (default OFF) |
| 6 |
* WITH_TIMEZONE_UPDATER Build the tzextract utility (default OFF) |
| 7 |
|
| 8 |
### Suggested usage |
| 9 |
|
| 10 |
* WITH_TIMEZONE_COMPILED is suggested for single binary builds (aka fully static) binaries that |
| 11 |
can not rely on external files to exist. |
| 12 |
* WITH_TIMEZONE_FROM_FILE is suggested for distribution packages as this allows updating timezone |
| 13 |
mappings without a necessary recompile of the FreeRDP binaries. Set WITH_TIMEZONE_COMPILED=OFF |
| 14 |
in such cases as both options can be used in combination. (entries from file taking preference |
| 15 |
over compiled in versions) |
| 16 |
* WITH_TIMEZONE_ICU is suggested if the target is already linked against ICU. This eliminates a |
| 17 |
required mapping table generated from WindowsZones.xml. This option is only a fallback if the |
| 18 |
compiled in or loaded from file mappings do not match any. |
| 19 |
|
| 20 |
## Keeping timezone mappings up to date |
| 21 |
|
| 22 |
On an up to date windows machine run the following binary after a build with -DWITH_TIMEZONE_UPDATER=ON (from build directory): |
| 23 |
|
| 24 |
tzextract <path to source>\winpr\libwinpr\timezone |
| 25 |
|
| 26 |
After running the scripts check |
| 27 |
* git clang-format -f to eliminate formatting changes |
| 28 |
* winpr/libwinpr/timezone/WindowsZones.c |
| 29 |
for changes. |
| 30 |
|
| 31 |
on any machine run the following script from checkout root: |
| 32 |
|
| 33 |
./scripts/update-windows-zones.py |
| 34 |
|
| 35 |
After running the scripts check |
| 36 |
* git clang-format -f to eliminate formatting changes |
| 37 |
* winpr/libwinpr/timezone/WindowsZones.c |
| 38 |
for changes. |
| 39 |
|
| 40 |
Commit if the definitions changed: |
| 41 |
1. run `git clang-format -f` on these changed files |
| 42 |
2. commit these changes |
| 43 |
3. create a pull request at https://github.com/FreeRDP/FreeRDP |