From 356f6f839f4cc2c2fb4e4807e9f50932dd698111 Mon Sep 17 00:00:00 2001 From: d3xter666 Date: Wed, 7 Oct 2026 11:12:46 +0300 Subject: [PATCH] [INTERNAL] Document utf8 BOM handling for .properties files --- docs/pages/Configuration.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/pages/Configuration.md b/docs/pages/Configuration.md index 5e5e2082c3f..5416bb2999b 100644 --- a/docs/pages/Configuration.md +++ b/docs/pages/Configuration.md @@ -204,6 +204,8 @@ If your project uses a different encoding for `*.properties` files, you need to UI5 CLI will read the corresponding files of the project in the given encoding. Any non-ASCII characters will be replaced with the respective Unicode escape sequences. This allows you to deploy the resulting files to any environment, independent of how it expects `*.properties` files to be encoded. Please refer to [RFC 7](https://github.com/UI5/cli/blob/main/rfcs/0007-properties-file-encoding.md) for details. +If a `*.properties` file was accidentally saved with a leading UTF-8 Byte Order Mark (BOM), the BOM is removed during this process. Otherwise it would be escaped into a literal `\uFEFF` sequence at the start of the file, corrupting the first key. + ## Custom Configuration !!! info