From e705fb5f2764446a6ae7b4ae4f51dcef8c107006 Mon Sep 17 00:00:00 2001
From: Sergei Izmailov <sergei.a.izmailov@gmail.com>
Date: Thu, 31 Aug 2023 06:20:46 +0900
Subject: [PATCH] Fix enum's `__str__` docstring (#4827)

* fix: Enum __str__ function name

* tests: Test enum.__str__.__doc__
---
 include/pybind11/pybind11.h | 2 +-
 tests/test_enum.py          | 5 +++++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/include/pybind11/pybind11.h b/include/pybind11/pybind11.h
index db91639dc0..e6c9ad0ac1 100644
--- a/include/pybind11/pybind11.h
+++ b/include/pybind11/pybind11.h
@@ -2014,7 +2014,7 @@ struct enum_base {
                 object type_name = type::handle_of(arg).attr("__name__");
                 return pybind11::str("{}.{}").format(std::move(type_name), enum_name(arg));
             },
-            name("name"),
+            name("__str__"),
             is_method(m_base));
 
         if (options::show_enum_members_docstring()) {
diff --git a/tests/test_enum.py b/tests/test_enum.py
index 4e85d29c31..b97b0fa567 100644
--- a/tests/test_enum.py
+++ b/tests/test_enum.py
@@ -264,3 +264,8 @@ def test_docstring_signatures():
         for attr in enum_type.__dict__.values():
             # Issue #2623/PR #2637: Add argument names to enum_ methods
             assert "arg0" not in (attr.__doc__ or "")
+
+
+def test_str_signature():
+    for enum_type in [m.ScopedEnum, m.UnscopedEnum]:
+        assert enum_type.__str__.__doc__.startswith("__str__")