docs(macro): improve name vs rename documentation

Refs: #422

Author: Xenira

guide/src/macros/classes.md

@@ -6,15 +6,13 @@ well as registering the class to be registered with the `#[php_module]` macro.
 
 ## Options
 
-The attribute takes some options to modify the output of the class:
+There are additional macros that modify the class. These macros **must** be
+placed underneath the `#[php_class]` attribute.
 
 - `name` - Changes the name of the class when exported to PHP. The Rust struct
   name is kept the same. If no name is given, the name of the struct is used.
   Useful for namespacing classes.
-
-There are also additional macros that modify the class. These macros **must** be
-placed underneath the `#[php_class]` attribute.
-
+- `rename` - Changes the case of the class name when exported to PHP.
 - `#[php(extends = ce)]` - Sets the parent class of the class. Can only be used once.
   `ce` must be a function with the signature `fn() -> &'static ClassEntry`.
 - `#[php(implements = ce)]` - Implements the given interface on the class. Can be used
@@ -97,7 +95,8 @@ use ext_php_rs::{
     zend::ce
 };
 
-#[php_class(name = "Redis\\Exception\\RedisException")]
+#[php_class]
+#[php(name = "Redis\\Exception\\RedisException")]
 #[php(extends = ce::exception)]
 #[derive(Default)]
 pub struct RedisException;

guide/src/macros/impl.md

@@ -11,6 +11,18 @@ If you do not want a function exported to PHP, you should place it in a separate
 
 If you want to use async Rust, use `#[php_async_impl]`, instead: see [here »](./async_impl.md) for more info.
 
+## Options
+
+By default all constants are renamed to UPPER_CASE and all methods are renamed to
+camelCase. This can be changed by passing the `rename_methods` and
+`rename_constants` as `#[php]` attributes on the `impl` block. The options are:
+
+- `#[php(rename_methods = "snake_case")]` - Renames the method to snake case.
+- `#[php(rename_constants = "snake_case")]` - Renames the constant to snake case.
+
+See the [`name` and `rename`](./php.md#name-and-rename) section for a list of all
+available cases.
+
 ## Methods
 
 Methods basically follow the same rules as functions, so read about the
@@ -24,17 +36,6 @@ To access the underlying Zend object, you can take a reference to a
 `ZendClassObject<T>` in place of the self parameter, where the parameter must
 be named `self_`. This can also be used to return a reference to `$this`.
 
-By default, all methods are renamed in PHP to the camel-case variant of the Rust
-method name. This can be changed on the `#[php_impl]` attribute, by passing one
-of the following as the `rename_methods` option:
-
-- `"none"` - does not rename the methods.
-- `"camelCase"` - renames all methods to camel case (default).
-- `"snake_case"` - renames all methods to snake case.
-
-For example, to disable renaming, change the `#[php_impl]` attribute to
-`#[php_impl(rename_methods = "none")]`.
-
 The rest of the options are passed as separate attributes:
 
 - `#[php(defaults(i = 5, b = "hello")]` - Sets the default value for parameter(s).

guide/src/macros/php.md

@@ -51,3 +51,20 @@ Which attributes are available depends on the element you are annotating:
 | setter           | ❌      | ❌   | ❌       | ❌             | ❌     | ❌             | ✅          |
 | constructor      | ❌      | ❌   | ❌       | ❌             | ❌     | ❌             | ✅          |
 | abstract_method  | ❌      | ❌   | ❌       | ❌             | ❌     | ❌             | ✅          |
+
+## `name` and `rename`
+
+`name` and `rename` are mutually exclusive. The `name` attribute is used to set the name of
+an item to a string literal. The `rename` attribute is used to change the case of the name.
+
+```rs
+#[php(name = "NEW_NAME")]
+#[php(rename = snake_case)]]
+```
+
+Available cases are:
+- `snake_case`
+- `PascalCase`
+- `camelCase`
+- `UPPER_CASE`
+- `none` - No change

guide/src/migration-guides/v0.14.md

@@ -196,3 +196,21 @@ the following variants are equivalent:
 ```rs
 #[php(rename = case, vis = "public")]
 ```
+
+#### `name` vs `rename`
+
+Previously the (re)name parameter was used to rename items. This has been
+unified to use `name` to set the name of an item to a string literal. The
+`rename` parameter is now used to change the case of the name.
+
+```rs
+#[php(name = "NEW_NAME")]
+#[php(rename = snake_case)]]
+```
+
+Available cases are:
+- `snake_case`
+- `PascalCase`
+- `camelCase`
+- `UPPER_CASE`
+- `none` - No change