@@ -20,11 +20,11 @@ OF_ASSUME_NONNULL_BEGIN @class OFString; @class OFArray OF_GENERIC(ObjectType); -/*! +/** * @class OFSettings OFSettings.h ObjFW/OFSettings.h * * Paths are delimited by dots, for example `category.subcategory.key`. * * @note The behaviour when accessing a path with a different type than it has @@ -37,17 +37,17 @@ { OFString *_applicationName; OF_RESERVE_IVARS(OFSettings, 4) } -/*! +/** * @brief The name of the application whose settings are accessed by the * instance. */ @property (readonly, nonatomic) OFString *applicationName; -/*! +/** * @brief Create a new OFSettings instance for the application with the * specified name. * * @param applicationName The name of the application whose settings should be * accessed @@ -55,11 +55,11 @@ */ + (instancetype)settingsWithApplicationName: (OFString *)applicationName; - (instancetype)init OF_UNAVAILABLE; -/*! +/** * @brief Initializes an already allocated OFSettings instance with the * specified application name. * * @param applicationName The name of the application whose settings should be * accessed @@ -66,74 +66,74 @@ * @return An initialized OFSettings instance */ - (instancetype)initWithApplicationName: (OFString *)applicationName OF_DESIGNATED_INITIALIZER; -/*! +/** * @brief Sets the specified path to the specified string. * * @param string The string to set * @param path The path to store the string at */ - (void)setString: (OFString *)string forPath: (OFString *)path; -/*! +/** * @brief Sets the specified path to the specified integer. * * @param integer The integer to set * @param path The path to store the integer at */ - (void)setInteger: (long long)integer forPath: (OFString *)path; -/*! +/** * @brief Sets the specified path to the specified bool. * * @param bool_ The bool to set * @param path The path to store the bool at */ - (void)setBool: (bool)bool_ forPath: (OFString *)path; -/*! +/** * @brief Sets the specified path to the specified float. * * @param float_ The float to set * @param path The path to store the float at */ - (void)setFloat: (float)float_ forPath: (OFString *)path; -/*! +/** * @brief Sets the specified path to the specified double. * * @param double_ The double to set * @param path The path to store the double at */ - (void)setDouble: (double)double_ forPath: (OFString *)path; -/*! +/** * @brief Sets the specified path to the specified array of strings. * * @param array The array of strings to set * @param path The path to store the array of strings at */ - (void)setArray: (OFArray OF_GENERIC(OFString *) *)array forPath: (OFString *)path; -/*! +/** * @brief Returns the string for the specified path, or `nil` if the path does * not exist. * * @param path The path for which the string value should be returned * @return The string value of the specified path */ - (nullable OFString *)stringForPath: (OFString *)path; -/*! +/** * @brief Returns the string for the specified path, or the default value if * the path does not exist. * * @param path The path for which the string value should be returned * @param defaultValue The default value to return if the path does not exist @@ -140,11 +140,11 @@ * @return The string value of the specified path */ - (nullable OFString *)stringForPath: (OFString *)path defaultValue: (nullable OFString *)defaultValue; -/*! +/** * @brief Returns the integer for the specified path, or the default value if * the path does not exist. * * @param path The path for which the integer value should be returned * @param defaultValue The default value to return if the path does not exist @@ -151,11 +151,11 @@ * @return The integer value of the specified path */ - (long long)integerForPath: (OFString *)path defaultValue: (long long)defaultValue; -/*! +/** * @brief Returns the bool for the specified path, or the default value if the * path does not exist. * * @param path The path for which the bool value should be returned * @param defaultValue The default value to return if the path does not exist @@ -162,11 +162,11 @@ * @return The bool value of the specified path */ - (bool)boolForPath: (OFString *)path defaultValue: (bool)defaultValue; -/*! +/** * @brief Returns the float for the specified path, or the default value if the * path does not exist. * * @param path The path for which the float value should be returned * @param defaultValue The default value to return if the path does not exist @@ -173,11 +173,11 @@ * @return The float value of the specified path */ - (float)floatForPath: (OFString *)path defaultValue: (float)defaultValue; -/*! +/** * @brief Returns the double for the specified path, or the default value if * the path does not exist. * * @param path The path for which the double value should be returned * @param defaultValue The default value to return if the path does not exist @@ -184,27 +184,27 @@ * @return The double value of the specified path */ - (double)doubleForPath: (OFString *)path defaultValue: (double)defaultValue; -/*! +/** * @brief Returns the array of strings for the specified path, or an empty * array if the path does not exist. * * @param path The path for which the array of strings should be returned * @return The array of strings of the specified path */ - (OFArray OF_GENERIC(OFString *) *)arrayForPath: (OFString *)path; -/*! +/** * @brief Removes the value for the specified path. * * @param path The path for which the value should be removed */ - (void)removeValueForPath: (OFString *)path; -/*! +/** * @brief Saves the settings to disk. * * @warning Some backends might save the settings instantly, others might not * save them before calling this method for performance reasons. You * should always call this method after doing a bunch of changes, no