Document configurable name transforms

Author: virtuald

docs/config/autowrap.rst

@@ -61,6 +61,45 @@ generated by semiwrap. In your ``meson.build`` after you include the generated
    )
 
 
+Name transforms
+---------------
+
+Generated Python names for functions, methods, and attributes can be configured
+with ``name_transform``. Explicit ``rename`` entries still take precedence, and
+YAML ``strip_prefixes`` is applied before the transform.
+
+Configuration precedence is:
+
+#. YAML ``name_transform``
+#. ``[tool.semiwrap.extension_modules."pkg.name"].name_transform``
+#. ``[tool.semiwrap].name_transform``
+#. ``default``
+
+Built-ins are:
+
+* ``default``: preserves existing semiwrap behavior; function and method names
+  lowercase the first character unless the first two characters are uppercase,
+  while attribute names are unchanged.
+* ``camelCase``: converts names to lower camel case, such as ``GetFoo`` or
+  ``get_foo`` becoming ``getFoo``.
+* ``snake_case``: converts names to lowercase words separated by underscores,
+  such as ``GetFoo`` or ``getFoo`` becoming ``get_foo``.
+* ``PascalCase``: converts names to upper camel case, such as ``getFoo`` or
+  ``get_foo`` becoming ``GetFoo``.
+
+Custom transforms use ``custom: package.name:function`` and receive
+``(name: str, kind: str)`` where kind is ``function``, ``method``, or
+``attribute``.
+
+Example::
+
+   name_transform: snake_case
+   strip_prefixes:
+   - SW_
+
+Name transforms do not apply to classes, enums, enum values, template instance
+names, or parameter names.
+
 Reference
 ---------