Debian Codegraph @

docs/README.timezones

raw
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