docs: update existing description

Author: kenjis

user_guide_src/source/concepts/factories.rst

@@ -54,9 +54,18 @@ by using the magic static method of the Factories class, ``Factories::models()``
 
 The static method name is called *component*.
 
-By default, Factories first searches in the ``App`` namespace for the path corresponding to the magic static method name.
+.. _factories-passing-classname-without-namespace:
+
+Passing Classname without Namespace
+-----------------------------------
+
+If you pass a classname without a namespace, Factories first searches in the
+``App`` namespace for the path corresponding to the magic static method name.
 ``Factories::models()`` searches the **app/Models** directory.
 
+Passing Short Classname
+^^^^^^^^^^^^^^^^^^^^^^^
+
 In the following code, if you have ``App\Models\UserModel``, the instance will be returned:
 
 .. literalinclude:: factories/001.php
@@ -68,31 +77,35 @@ you get back the instance as before:
 
 .. literalinclude:: factories/003.php
 
-preferApp option
-----------------
+Passing Short Classname with Sub-directories
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-You could also request a specific class:
+If you want to load a class in sub directories, you use the ``/`` as a separator.
+The following code loads **app/Libraries/Sub/SubLib.php** if it exists:
 
-.. literalinclude:: factories/002.php
+.. literalinclude:: factories/013.php
    :lines: 2-
 
-If you have only ``Blog\Models\UserModel``, the instance will be returned.
-But if you have both ``App\Models\UserModel`` and ``Blog\Models\UserModel``,
-the instance of ``App\Models\UserModel`` will be returned.
+Passing Full Qualified Classname
+--------------------------------
 
-If you want to get ``Blog\Models\UserModel``, you need to disable the option ``preferApp``:
+You could also request a full qualified classname:
 
-.. literalinclude:: factories/010.php
+.. literalinclude:: factories/002.php
    :lines: 2-
 
-Loading a Class in Sub-directories
-==================================
+It returns the instance of ``Blog\Models\UserModel`` if it exists.
 
-If you want to load a class in sub directories, you use the ``/`` as a separator.
-The following code loads **app/Libraries/Sub/SubLib.php**:
+.. note:: Prior to v4.4.0, when you requested a full qualified classname,
+    if you had only ``Blog\Models\UserModel``, the instance would be returned.
+    But if you had both ``App\Models\UserModel`` and ``Blog\Models\UserModel``,
+    the instance of ``App\Models\UserModel`` would be returned.
 
-.. literalinclude:: factories/013.php
-   :lines: 2-
+    If you wanted to get ``Blog\Models\UserModel``, you needed to disable the
+    option ``preferApp``:
+
+    .. literalinclude:: factories/010.php
+       :lines: 2-
 
 Convenience Functions
 *********************
@@ -154,6 +167,9 @@ preferApp  boolean        Whether a class with the same basename in the App name
                           overrides other explicit class requests.
 ========== ============== ============================================================ ===================================================
 
+.. note:: Since v4.4.0, ``preferApp`` works only when you request
+    :ref:`a classname without a namespace <factories-passing-classname-without-namespace>`.
+
 Factories Behavior
 ******************