docs(win): freeze the IDE bar height — DO-NOT-CHANGE banner + ChangeLog

Per the project owner: nBarH stays at Max(200, Int(200*nUIScale)). The
per-screen -60/-70 trim is gone and must not come back. Added a loud
DO-NOT-CHANGE banner above the line in hbbuilder_win.prg and a ChangeLog
entry recording the decision and its rationale (visible palette over the
trim; coexists with the documented ~6-9s self-exit on >=1920px screens).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: FiveTechSoft

ChangeLog.txt

@@ -3,7 +3,18 @@ HarbourBuilder - Cross-platform visual IDE for Harbour
 
 2026-05-11
 
-  - KNOWN ISSUE / why the IDE bar height is trimmed on >=1920px screens.
+  - DECISION (locked): the main IDE bar height (nBarH in Main()) is now
+    FROZEN at its full computed value, Max(200, Int(200*nUIScale)). The
+    per-screen "nBarH -= 60/70" trim has been removed and must NOT be
+    re-added under any circumstances — there is a matching DO-NOT-CHANGE
+    banner above the line in source/hbbuilder_win.prg. Rationale: the
+    project owner chose a visible component-palette button row over the
+    bar-trim, in full knowledge that the full-height bar coexists with
+    the self-exit issue described in the previous note. If someone
+    genuinely fixes that self-exit, fix it on the C++/layout side, not
+    by touching this line, and ask first.
+
+  - KNOWN ISSUE / why the IDE bar height was trimmed on >=1920px screens.
     If the main IDE bar (oIDE, the APPBAR form) is left at its full
     computed height (~200px, enough for: title + menu + 2 stacked
     toolbars + the component-palette tab strip + the palette button

source/hbbuilder_win.prg

@@ -103,15 +103,21 @@ function Main()
    nUIScale := Max( 0.85, Min( 1.20, nScreenW / 1920.0 ) )
    nUIFont  := Max( 9, Int( 11 * nUIScale ) )
 
-   // C++Builder classic proportions scaled to current screen.
-   // Bar must fit: title (~30) + menu (~25) + 2 stacked toolbars (~80) + palette
-   // tabs+buttons (~75) ≈ 210. Windows can swallow ~25px of menu height during
-   // SW_SHOWMAXIMIZED, so we ask for a bit more than we strictly need.
-   // Full height so the component-palette button row is visible.
-   // WARNING: this re-introduces the "IDE self-exits ~6-9s after startup on
-   // >=1920px screens" issue (see ChangeLog). Kept at the owner's request —
-   // do not re-add the -70 trim without asking.
-   nBarH    := Max( 200, Int( 200 * nUIScale ) )   // title + menu + 2 toolbars + palette
+   // ===================================================================
+   // !!! DO NOT CHANGE THE nBarH LINE BELOW UNDER ANY CIRCUMSTANCES !!!
+   // ===================================================================
+   // Locked by the project owner (2026-05-11). The main IDE bar stays at
+   // its full computed height (~200px) so the component-palette button row
+   // is visible. This is a DELIBERATE choice and known to coexist with the
+   // "IDE self-exits cleanly ~6-9s after startup on >=1920px screens" issue
+   // (fully documented in ChangeLog.txt). Do NOT re-introduce the per-screen
+   // "nBarH -= 60/70" trim, do NOT shrink the floor, do NOT "fix" this — the
+   // trade-off was made on purpose. If you think you have a real fix for the
+   // self-exit, change the C++ side, not this line, and ask first.
+   // C++Builder classic proportions scaled to current screen:
+   // title (~30) + menu (~25) + 2 stacked toolbars (~80) + palette
+   // tabs+buttons (~75) ≈ 210.  ↓↓↓ FROZEN — see comment above ↓↓↓
+   nBarH    := Max( 200, Int( 200 * nUIScale ) )   // FROZEN — do not change
    // Inspector: wide enough for the 230-px property/event name column plus a
    // usable value column. Grows with screen size.
    nInsW    := Max( 330, Max( Int( 360 * nUIScale ), Int( nScreenW * 0.21 ) ) )