From 6a127b1f0f0814a188d2c573b223db9d97b850cb Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sun, 23 Aug 2026 21:11:38 +0000
Subject: [PATCH] Clarify setV2ClassLoading() docblock to explain true/false
 behaviour

Co-authored-by: fadrian06 <109766973+fadrian06@users.noreply.github.com>
---
 flight/core/Loader.php | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/flight/core/Loader.php b/flight/core/Loader.php
index f57ac80..057e103 100644
--- a/flight/core/Loader.php
+++ b/flight/core/Loader.php
@@ -221,9 +221,13 @@ class Loader
 
 
     /**
-     * Sets whether to allow class loading with underscores in class names.
+     * Sets v2 class loading mode.
      *
-     * @param bool $value
+     * When true (default), underscores in class names are converted to directory
+     * separators (e.g. "Foo_Bar" loads "Foo/Bar.php"). Set to false to disable
+     * this conversion and treat underscores as literal characters in the filename.
+     *
+     * @param bool $value True to convert underscores to directory separators (v2 behaviour); false to disable.
      */
     public static function setV2ClassLoading(bool $value): void
     {