Skip to content

Commit 5a52aab

Browse files
derek73claude
andcommitted
State the script_orders precedence rule instead of gesturing at it
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent 0724e8d commit 5a52aab

1 file changed

Lines changed: 5 additions & 3 deletions

File tree

docs/modules.rst

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -109,9 +109,11 @@ because only these three orders have defined assignment semantics.
109109
:value: ((Script.HAN, FAMILY_FIRST), (Script.HANGUL, FAMILY_FIRST))
110110

111111
The default :attr:`~nameparser.Policy.script_orders` table: a name
112-
written wholly in Han or Hangul reads family-first, whatever
113-
``name_order`` says. The values are drawn from the same three
114-
constants above, and the same restriction applies. Build on it for
112+
written wholly in Han or Hangul reads family-first. A matching
113+
entry in this table takes precedence over ``name_order``, including
114+
a ``name_order`` you set explicitly — ``name_order`` governs only
115+
the names no entry matches. The values are drawn from the same
116+
three constants above, and the same restriction applies. Build on it for
115117
additive customization —
116118
``script_orders=dict(DEFAULT_SCRIPT_ORDERS) | {Script.HAN:
117119
GIVEN_FIRST}`` — and pass ``script_orders={}`` to opt out entirely

0 commit comments

Comments
 (0)