Merge pull request #78 from braboj/codex/add-comment-block-for-type-function

Clarify type example heading

Author: braboj

examples/08_classes/class_create_with_type.py

@@ -1,8 +1,14 @@
-"""
-type(object)
-type(name, bases, dict)
-
-"""
+# Using ``type`` to inspect objects and create classes
+# -----------------------------------------------------------------------------
+# ``type(object)``
+# ``type(name, bases, dict)``
+#
+# The built-in ``type`` function has two distinct behaviors in Python:
+# 1. ``type(obj)`` returns the type of ``obj``. This is useful when
+#    inspecting existing objects to see what class they belong to.
+# 2. ``type(name, bases, dict)`` dynamically creates a new class with the
+#    specified name, base classes and attributes. Using this form allows
+#    programs to build classes at runtime.
 
 ##############################################################################
 # USECASE A : Get object type
@@ -39,4 +45,4 @@ def say_hallo_b(self):
 x = Robot2("Marvin")
 print(x.name)
 print(x.func())
-print(x.say_hello_b())
+print(x.say_hello_b())