@@ -18,18 +18,44 @@
 #include <signal.h>
 
 #import "OFObject.h"
 
 OF_ASSUME_NONNULL_BEGIN
+
+/*! @file */
 
 @class OFArray OF_GENERIC(ObjectType);
 @class OFDictionary OF_GENERIC(KeyType, ObjectType);
 @class OFMutableArray OF_GENERIC(ObjectType);
 @class OFMutableDictionary OF_GENERIC(KeyType, ObjectType);
 @class OFSandbox;
 @class OFString;
 
+/*!
+ * @brief Specify the class to be used as the application delegate.
+ *
+ * An instance of this class will be created and act as the application
+ * delegate.
+ *
+ * For example, it can be used like this:
+ *
+ * @code
+ * // In MyAppDelegate.h:
+ * @interface MyAppDelegate: OFObject <OFApplicationDelegate>
+ * @end
+ *
+ * // In MyAppDelegate.m:
+ * OF_APPLICATION_DELEGATE(MyAppDelegate)
+ *
+ * @implementation MyAppDelegate
+ * - (void)applicationDidFinishLaunching
+ * {
+ *         [OFApplication terminate];
+ * }
+ * @end
+ * @endcode
+ */
 #define OF_APPLICATION_DELEGATE(class_)					\
 	int								\
 	main(int argc, char *argv[])					\
 	{								\
 		return of_application_main(&argc, &argv,		\