@@ -27,83 +27,83 @@ main(int argc, char *argv[]) \ { \ return of_application_main(&argc, &argv, [cls class]); \ } -/** - * \brief A protocol for delegates of OFApplication. +/*! + * @brief A protocol for delegates of OFApplication. */ #ifndef OF_APPLICATION_M @protocol OFApplicationDelegate #else @protocol OFApplicationDelegate #endif -/** - * \brief A method which is called when the application was initialized and is +/*! + * @brief A method which is called when the application was initialized and is * running now. */ - (void)applicationDidFinishLaunching; #ifdef OF_HAVE_OPTIONAL_PROTOCOLS @optional #endif -/** - * \brief A method which is called when the application will terminate. +/*! + * @brief A method which is called when the application will terminate. */ - (void)applicationWillTerminate; -/** - * \brief A method which is called when the application received a SIGINT. +/*! + * @brief A method which is called when the application received a SIGINT. * - * \warning You are not allowed to send any messages inside this method, as + * @warning You are not allowed to send any messages inside this method, as * message dispatching is not signal-safe! You are only allowed to do * signal-safe operations like setting a variable or calling a * signal-safe function! */ - (void)applicationDidReceiveSIGINT; #ifndef _WIN32 -/** - * \brief A method which is called when the application received a SIGHUP. +/*! + * @brief A method which is called when the application received a SIGHUP. * * This signal is not available on Windows. * - * \warning You are not allowed to send any messages inside this method, as + * @warning You are not allowed to send any messages inside this method, as * message dispatching is not signal-safe! You are only allowed to do * signal-safe operations like setting a variable or calling a * signal-safe function! */ - (void)applicationDidReceiveSIGHUP; -/** - * \brief A method which is called when the application received a SIGUSR1. +/*! + * @brief A method which is called when the application received a SIGUSR1. * * This signal is not available on Windows. * - * \warning You are not allowed to send any messages inside this method, as + * @warning You are not allowed to send any messages inside this method, as * message dispatching is not signal-safe! You are only allowed to do * signal-safe operations like setting a variable or calling a * signal-safe function! */ - (void)applicationDidReceiveSIGUSR1; -/** - * \brief A method which is called when the application received a SIGUSR2. +/*! + * @brief A method which is called when the application received a SIGUSR2. * * This signal is not available on Windows. * - * \warning You are not allowed to send any messages inside this method, as + * @warning You are not allowed to send any messages inside this method, as * message dispatching is not signal-safe! You are only allowed to do * signal-safe operations like setting a variable or calling a * signal-safe function! */ - (void)applicationDidReceiveSIGUSR2; #endif @end -/** - * \brief Represents the application as an object. +/*! + * @brief Represents the application as an object. */ @interface OFApplication: OFObject { OFString *programName; OFMutableArray *arguments; @@ -125,121 +125,121 @@ @property (readonly, copy, nonatomic) OFArray *arguments; @property (readonly, copy, nonatomic) OFDictionary *environment; @property (assign) id delegate; #endif -/** - * \brief Returns the only OFApplication instance in the application. +/*! + * @brief Returns the only OFApplication instance in the application. * - * \return The only OFApplication instance in the application + * @return The only OFApplication instance in the application */ + (OFApplication*)sharedApplication; -/** - * \brief Returns the name of the program (argv[0]). +/*! + * @brief Returns the name of the program (argv[0]). * - * \return The name of the program (argv[0]) + * @return The name of the program (argv[0]) */ + (OFString*)programName; -/** - * \brief Returns the arguments passed to the application. +/*! + * @brief Returns the arguments passed to the application. * - * \return The arguments passed to the application + * @return The arguments passed to the application */ + (OFArray*)arguments; -/** - * \brief Returns the environment of the application. +/*! + * @brief Returns the environment of the application. * - * \return The environment of the application + * @return The environment of the application */ + (OFDictionary*)environment; -/** - * \brief Terminates the application. +/*! + * @brief Terminates the application. */ + (void)terminate; -/** - * \brief Terminates the application with the specified status. +/*! + * @brief Terminates the application with the specified status. * - * \param status The status with which the application will terminate + * @param status The status with which the application will terminate */ + (void)terminateWithStatus: (int)status; -/** - * \brief Sets argc and argv. +/*! + * @brief Sets argc and argv. * * You should not call this directly, but use OF_APPLICATION_DELEGATE instead! * - * \param argc The number of arguments - * \param argv The argument values + * @param argc The number of arguments + * @param argv The argument values */ - (void)setArgumentCount: (int*)argc andArgumentValues: (char**[])argv; -/** - * \brief Gets args and argv. +/*! + * @brief Gets args and argv. * - * \param argc A pointer where a pointer to argc should be stored - * \param argv A pointer where a pointer to argv should be stored + * @param argc A pointer where a pointer to argc should be stored + * @param argv A pointer where a pointer to argv should be stored */ - (void)getArgumentCount: (int**)argc andArgumentValues: (char***[])argv; -/** - * \brief Returns the name of the program (argv[0]). +/*! + * @brief Returns the name of the program (argv[0]). * - * \return The name of the program (argv[0]) + * @return The name of the program (argv[0]) */ - (OFString*)programName; -/** - * \brief Returns the arguments passed to the application. +/*! + * @brief Returns the arguments passed to the application. * - * \return The arguments passed to the application + * @return The arguments passed to the application */ - (OFArray*)arguments; -/** - * \brief Returns the environment of the application. +/*! + * @brief Returns the environment of the application. * - * \return The environment of the application + * @return The environment of the application */ - (OFDictionary*)environment; -/** - * \brief Returns the delegate of the application. +/*! + * @brief Returns the delegate of the application. * - * \return The delegate of the application + * @return The delegate of the application */ - (id )delegate; -/** - * \brief Sets the delegate of the application. +/*! + * @brief Sets the delegate of the application. * - * \param delegate The delegate for the application + * @param delegate The delegate for the application */ - (void)setDelegate: (id )delegate; -/** - * \brief Starts the application after everything has been initialized. +/*! + * @brief Starts the application after everything has been initialized. * * You should not call this directly, but use OF_APPLICATION_DELEGATE instead! */ - (void)run; -/** - * \brief Terminates the application. +/*! + * @brief Terminates the application. */ - (void)terminate; -/** - * \brief Terminates the application with the specified status. +/*! + * @brief Terminates the application with the specified status. * - * \param status The status with which the application will terminate + * @param status The status with which the application will terminate */ - (void)terminateWithStatus: (int)status; @end @interface OFObject (OFApplicationDelegate)