Update Locale Kit docs.

Add \since to each method. This was pretty easy to figure out since
the whole kit exists only in Haiku.

docs/user/locale/Catalog.dox

@@ -72,6 +72,8 @@
 	Note that french(France) will failback to french, but then directly to the
 	language in the source code. This avoids mixing 3 or more languages in the
 	same application if the catalogs are incomplete and avoids confusion.
+
+	\since Haiku R1
 */
 
 
@@ -80,6 +82,8 @@
 	\brief Construct an empty BCatalog object.
 
 	Should be followed by SetTo() method to set the catalog.
+
+	\since Haiku R1
 */
 
 
@@ -105,12 +109,16 @@
 	\param fingerprint The fingerprint version-info for the catalog to load.
 	       If \c 0, the fingerprint will not be checked,and any version of the
 	       catalog will be loaded.
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn BCatalog::~BCatalog()
 	\brief Destroys the BCatalog object freeing memory used by it.
+
+	\since Haiku R1
 */
 
 
@@ -119,9 +127,9 @@
 		const char* context, const char* comment)
 	\brief Get a string from the catalog.
 
-	This method access the data of the catalog and reeturns you the translated
+	This method access the data of the catalog and returns you the translated
 	version of the string. You must pass it the context where the string is, as
-	the same string may appear somewhere else and need a differnet translation.
+	the same string may appear somewhere else and need a different translation.
 	The comment is optional. It is meant as an help to translators, when the
 	string alone is not helpful enough or there are special things to note.
 	The comment is also used as a way to uniquely identify a string, so if two
@@ -134,6 +142,8 @@
 
 	\returns The translated string, or the one passed as a parameter if no
 	         translation was found.
+
+	\since Haiku R1
 */
 
 
@@ -152,6 +162,8 @@
 	\param id The identifier of the string.
 
 	\returns The translated string if found, or an empty string.
+
+	\since Haiku R1
 */
 
 
@@ -174,6 +186,8 @@
 	\retval B_NO_INIT Catalog is \c NULL.
 	\retval B_NAME_NOT_FOUND catalog with the specified \a name could not be
 	        found.
+
+	\since Haiku R1
 */
 
 
@@ -187,6 +201,8 @@
 	Note the current catalog format doesn't allow storing custom data in
 	catalogs, so the only way to use this method is providing your own
 	catalog add-on for storing the data.
+
+	\since Haiku R1
 */
 
 
@@ -200,6 +216,8 @@
 	\param sig The string where to copy the signature.
 
 	\returns An error code.
+
+	\since Haiku R1
 */
 
 
@@ -216,6 +234,8 @@
 	\retval B_ERROR Could not get exclusive lock on catalog.
 	\retval B_BAD_VALUE \a lang is \c NULL.
 	\retval B_NO_INIT Catalog data is \c NULL.
+
+	\since Haiku R1
 */
 
 
@@ -233,6 +253,8 @@
 	\retval B_ERROR Could not get exclusive lock on catalog.
 	\retval B_BAD_VALUE \a fp is \c NULL.
 	\retval B_NO_INIT Catalog data is \c NULL.
+
+	\since Haiku R1
 */
 
 
@@ -249,6 +271,8 @@
 	\param fingerprint The fingerprint of the catalog you want to load.
 
 	\returns A status code, \c B_OK on success, \c B_ERROR on error.
+
+	\since Haiku R1
 */
 
 
@@ -260,6 +284,8 @@
 	\retval B_OK The catalog is initialized properly.
 	\retval B_ERROR Could not get exclusive lock on catalog.
 	\retval B_NO_INIT Catalog data is \c NULL.
+
+	\since Haiku R1
 */
 
 
@@ -268,4 +294,6 @@
 	\brief Gets the number of items in the catalog.
 
 	\returns the number of strings in the catalog or 0 on error.
+
+	\since Haiku R1
 */

docs/user/locale/Collator.dox

@@ -36,8 +36,10 @@
 	sorting.
 
 	\warning This class is not multithread-safe, as Compare() change the
-		ICUCollator (the strength). So if you want to use a BCollator from
+	         ICUCollator (the strength). So if you want to use a BCollator
-		more than one thread you need to protect it with a lock.
+	         from more than one thread you need to protect it with a lock.
+
+	\since Haiku R1
 */
 
 
@@ -49,6 +51,8 @@
 	           instead since it is aware of the currently defined locale.
 
 	This constructor uses \c B_COLLATE_PRIMARY strength.
+
+	\since Haiku R1
 */
 
 
@@ -69,6 +73,8 @@
 	       \li \c B_COLLATE_QUATERNARY is very strict. Most of the time you
 	              shouldn't need to go this far.
 	\param ignorePunctuation Ignore punctuation during sorting.
+
+	\since Haiku R1
 */
 
 
@@ -77,6 +83,8 @@
 	\brief Unarchive a collator from a message.
 
 	\param archive The message to unarchive the BCollator object from.
+
+	\since Haiku R1
 */
 
 
@@ -87,6 +95,8 @@
 	Copies a BCollator object from another BCollator object.
 
 	\param other The BCollator to copy from.
+
+	\since Haiku R1
 */
 
 
@@ -95,6 +105,8 @@
 	\brief Destructor method.
 
 	Deletes the BCollator object freeing the resources it consumes.
+
+	\since Haiku R1
 */
 
 
@@ -103,6 +115,8 @@
 	\brief Assignment operator.
 
 	\param other the BCollator object to assign from.
+
+	\since Haiku R1
 */
 
 
@@ -119,6 +133,8 @@
 	       \li \c B_COLLATE_TERTIARY is case sensitive,
 	       \li \c B_COLLATE_QUATERNARY is very strict. Most of the time you
 	              shouldn't need to go this far.
+
+	\since Haiku R1
 */
 
 
@@ -127,6 +143,8 @@
 	\brief Get the current strength of this catalog.
 
 	\returns The current strength of the catalog.
+
+	\since Haiku R1
 */
 
 
@@ -136,16 +154,20 @@
 
 	This function enables or disables the handling of punctuation.
 
-	\param ignore Boolean indicating whether or not punctuation should
+	\param ignore Whether or not punctuation should be ignored.
-		be ignored.
+
+	\since Haiku R1
 */
 
+
 /*!
 	\fn bool BCollator::IgnorePunctuation() const
 	\brief Gets the behavior of the collator with regards to punctuation.
 
 	\returns \c true if the collator will take punctuation into account
 	         when sorting, \c false otherwise.
+
+	\since Haiku R1
 */
 
 
@@ -166,6 +188,8 @@
 
 	\retval B_OK if everything went well.
 	\retval B_ERROR if an error occurred generating the sortkey.
+
+	\since Haiku R1
 */
 
 
@@ -182,9 +206,15 @@
 	\param s2 The second string to compare.
 	\param strength The \a strength to use for the string comparison.
 
+	\returns An integer value representing how the strings compare to each
+	         other.
 	\retval 0 if the strings are equal.
 	\retval <0 if s1 is less than s2.
 	\retval >0 if s1 is greater than s2.
+
+	\since Haiku R1
+
+	\since Haiku R1
 */
 
 
@@ -205,6 +235,8 @@
 	\param strength The \a strength to use for the string comparison.
 
 	\returns \c true if the strings are identical, \c false otherwise.
+
+	\since Haiku R1
 */
 
 
@@ -221,6 +253,8 @@
 	\param strength The \a strength to use for the string comparison.
 
 	\returns \c true if s1 is greater than, but not equal to, s2.
+
+	\since Haiku R1
 */
 
 
@@ -236,6 +270,8 @@
 	\param strength The \a strength to use for the string comparison.
 
 	\returns \c true if s1 is greater or equal than s2.
+
+	\since Haiku R1
 */
 
 
@@ -252,4 +288,6 @@
 
 	\returns A pointer to a BArchivable object containing the BCollator or
 	        \c NULL if an error occurred restoring the \a archive.
+
+	\since Haiku R1
 */

docs/user/locale/Country.dox

@@ -33,6 +33,8 @@
 
 	Date, time, and number formatting also depends to some extent on the
 	language used so they are found in the BLocale class instead.
+
+	\since Haiku R1
 */
 
 
@@ -41,6 +43,8 @@
 	\brief Initialize a BCountry from a country code.
 
 	\param countryCode The country code to initialize from.
+
+	\since Haiku R1
 */
 
 
@@ -49,17 +53,27 @@
 	\brief Initialize a BCountry from another BCountry object.
 
 	\param other The BCountry object to initialize from.
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn BCountry& BCountry::operator=(const BCountry& other)
+	\brief Initialize a BCountry from another BCountry object by overloading
+	       the = operator.
+
+	\param other The BCountry object to initialize from.
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn BCountry::~BCountry()
 	\brief Destructor method.
+
+	\since Haiku R1
 */
 
 
@@ -74,6 +88,8 @@
 
 	\returns A status code, B_OK if everything went fine, or an error code
 	         otherwise.
+
+	\since Haiku R1
 */
 
 
@@ -82,6 +98,8 @@
 	\brief Gets the ISO country code for the country.
 
 	\returns The ISO country code for the country.
+
+	\since Haiku R1
 */
 
 
@@ -98,4 +116,6 @@
 	\param result The BBitmap object to draw the flag into.
 
 	\returns \c B_OK if the drawing was successful.
+
+	\since Haiku R1
 */

docs/user/locale/DurationFormat.dox

@@ -29,6 +29,8 @@
 	BDurationFormat is a formatter for time intervals. A time interval is
 	defined by its start and end values, and the result is a string such as
 	"1 hour, 2 minutes, 28 seconds".
+
+	\since Haiku R1
 */
 
 
@@ -40,6 +42,8 @@
 	         time want to use the default one through the BLocale class.
 
 	\param separator String appended between the duration elements.
+
+	\since Haiku R1
 */
 
 
@@ -48,12 +52,16 @@
 	\brief Copy Constructor.
 
 	\param other The BDurationFormat object to copy from.
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn BDurationFormat::~BDurationFormat()
 	\brief Destructor.
+
+	\since Haiku R1
 */
 
 
@@ -64,6 +72,8 @@
 	\param other The BDurationFormat object to copy from.
 
 	\returns The resulting BDurationFormat object.
+
+	\since Haiku R1
 */
 
 
@@ -72,6 +82,8 @@
 	\brief Replace the separator for this formatter.
 
 	\param separator The separator string to set.
+
+	\since Haiku R1
 */
 
 
@@ -82,6 +94,8 @@
 	\param locale The BLocale object to set.
 
 	\returns A status code, \c B_OK on success or an error code on error.
+
+	\since Haiku R1
 */
 
 
@@ -95,6 +109,8 @@
 	\retval B_OK Everything went fine.
 	\retval B_NO_INIT Format object is \c NULL.
 	\retval B_ERROR Other errors.
+
+	\since Haiku R1
 */
 
 
@@ -116,4 +132,6 @@
 	\retval B_OK Everything went fine.
 	\retval B_BAD_VALUE Buffer was \c NULL.
 	\retval B_ERROR Formatting error.
+
+	\since Haiku R1
 */

docs/user/locale/Locale.dox

@@ -37,6 +37,8 @@
 	BLocale is also the class to use when you want to perform formatting
 	or parsing of dates, times, and numbers, in the natural language of
 	the user.
+
+	\since Haiku R1
 */
 
 
@@ -45,12 +47,18 @@
 		const BFormattingConventions* conventions)
 	\brief Initializes a BLocale object corresponding to the passed in
 	       \a language and \a conventions.
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn BLocale::BLocale(const BLocale& other)
-	\brief Initializes a BLocale object.
+	\brief Initializes a BLocale object as a copy of \a other.
+
+	\param other The BLocale object to initialize from.
+
+	\since Haiku R1
 */
 
 
@@ -60,17 +68,27 @@
 
 	Returns the collator in use for this locale, allowing you to use it
 	to sort a set of strings.
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn BLocale& BLocale::operator=(const BLocale& other)
+	\brief Initializes a BLocale object as a copy of \a other by overloading
+	       the = operator.
+
+	\param other The BLocale object to initialize from.
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn BLocale::~BLocale()
 	\brief Destructor method.
+
+	\since Haiku R1
 */
 
 
@@ -84,6 +102,8 @@
 	\retval B_OK Everything went well.
 	\retval B_BAD_VALUE \c NULL \a collator object passed in.
 	\retval B_ERROR Unable to lock the BLocale. 
+
+	\since Haiku R1
 */
 
 
@@ -97,21 +117,26 @@
 	\retval B_OK Everything went well.
 	\retval B_BAD_VALUE \c NULL \a language object passed in.
 	\retval B_ERROR Unable to lock the BLocale. 
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn status_t BLocale::GetFormattingConventions(
 		BFormattingConventions* conventions) const
-	\brief Sets \a conventions object to the default formatting conventions
+	\brief Fills out \a conventions with the default formatting conventions
 	       for the BLocale.
 
-	\param conventions A pointer to a BFormattingConventions object to fill out.
+	\param conventions A pointer to a BFormattingConventions object to fill
+	       out.
 
 	\returns A status code.
 	\retval B_OK Everything went well.
 	\retval B_BAD_VALUE \c NULL \a conventions object passed in.
 	\retval B_ERROR Unable to lock the BLocale.
+
+	\since Haiku R1
 */
 
 
@@ -123,8 +148,10 @@
 
 	\internal Assumes a certain order of the string bases.
 
-	\returns a blank string in the case of an error or the string "UTF-8"
+	\returns A blank string in the case of an error or the string "UTF-8"
 	         if there is \a id is set to \a B_CODESET.
+
+	\since Haiku R1
 */
 
 
@@ -136,6 +163,8 @@
 	If unable to lock the BLocale \a conventions is left untouched.
 
 	\param conventions The formatting convention to set.
+
+	\since Haiku R1
 */
 
 
@@ -146,6 +175,8 @@
 	If unable to lock the BLocale \a newCollator is left untouched.
 
 	\param newCollator The collator to set.
+
+	\since Haiku R1
 */
 
 
@@ -156,6 +187,8 @@
 	If unable to lock the BLocale \a newLanguage is left untouched.
 
 	\param newLanguage The code of the language to set to locale to.
+
+	\since Haiku R1
 */
 
 
@@ -181,6 +214,8 @@
 		BTimeFormatStyle timeStyle) const
 	\sa BLocale::FormatTime(char* string, size_t maxSize, time_t time,
 		BTimeFormatStyle style) const
+
+	\since Haiku R1
 */
 
 
@@ -206,6 +241,8 @@
 		const BTimeZone* timeZone) const
 	\sa status_t BLocale::FormatTime(BString* string, time_t time,
 		BTimeFormatStyle style, const BTimeZone* timeZone) const
+
+	\since Haiku R1
 */
 
 
@@ -230,6 +267,8 @@
 
 	\sa BLocale::FormatTime(BString* string, int*& fieldPositions,
 		int& fieldCount, time_t time, BTimeFormatStyle style) const
+
+	\since Haiku R1
 */
 
 
@@ -257,6 +296,8 @@
 
 	\sa BLocale::GetTimeFields(BDateElement*& fields, int& fieldCount,
 		BTimeFormatStyle style) const
+
+	\since Haiku R1
 */
 
 
@@ -277,6 +318,8 @@
 	\retval B_OK Everything went fine.
 	\retval B_BAD_VALUE \a startOfWeek is \c NULL.
 	\retval B_ERROR Unable to lock the BLocale or another error occurred.
+
+	\since Haiku R1
 */
 
 
@@ -302,6 +345,8 @@
 		BDateFormatStyle style) const
 	\sa BLocale::FormatTime(char* string, size_t maxSize, time_t time,
 		BTimeFormatStyle style) const
+
+	\since Haiku R1
 */
 
 
@@ -327,6 +372,8 @@
 		BDateFormatStyle style, const BTimeZone* timeZone) const
 	\sa status_t BLocale::FormatTime(BString* string, time_t time,
 		BTimeFormatStyle style, const BTimeZone* timeZone) const
+
+	\since Haiku R1
 */
 
 
@@ -351,6 +398,8 @@
 	\sa BLocale::FormatDateTime(char* target, size_t maxSize,
 		time_t time, BDateFormatStyle dateStyle,
 		BTimeFormatStyle timeStyle) const
+
+	\since Haiku R1
 */
 
 
@@ -375,6 +424,8 @@
 	\sa BLocale::FormatDateTime(BString* target, time_t time,
 		BDateFormatStyle dateStyle, BTimeFormatStyle timeStyle,
 		const BTimeZone* timeZone) const
+
+	\since Haiku R1
 */
 
 
@@ -398,6 +449,8 @@
 
 	\sa BLocale::FormatDate(BString* string, int*& fieldPositions,
 		int& fieldCount, time_t time, BDateFormatStyle style) const
+
+	\since Haiku R1
 */
 
 
@@ -424,6 +477,8 @@
 
 	\sa BLocale::GetDateFields(BDateElement*& fields, int& fieldCount,
 		BDateFormatStyle style) const
+
+	\since Haiku R1
 */
 
 
@@ -447,6 +502,8 @@
 		int32 value) const
 	\sa ssize_t BLocale::FormatMonetary(char* string, size_t maxSize,
 		double value) const
+
+	\since Haiku R1
 */
 
 
@@ -467,6 +524,8 @@
 
 	\sa BLocale::FormatNumber(BString* string, int32 value) const
 	\sa BLocale::FormatMonetary(BString* string, double value) const
+
+	\since Haiku R1
 */
 
 
@@ -490,12 +549,14 @@
 		double value) const
 	\sa BLocale::FormatMonetary(char* string, size_t maxSize,
 		double value) const
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn status_t BLocale::FormatNumber(BString* string, int32 value) const
-	\brief \brief Format the \c int32 \a value as a string and put the result
+	\brief Format the \c int32 \a value as a string and put the result
 	       into \a string in the current locale.
 
 	\param string The string to put the formatted number into.
@@ -510,6 +571,8 @@
 
 	\sa BLocale::FormatNumber(BString* string, double value) const
 	\sa BLocale::FormatMonetary(BString* string, double value) const
+
+	\since Haiku R1
 */
 
 
@@ -531,12 +594,14 @@
 
 	\sa BLocale::FormatNumber(char* string, size_t maxSize, double value) const
 	\sa BLocale::FormatNumber(char* string, size_t maxSize, int32 value) const
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn status_t BLocale::FormatMonetary(BString* string, double value) const
-	\brief \brief Format the \c double \a value as a monetary string and put
+	\brief Format the \c double \a value as a monetary string and put
 	       the result into \a string in the current locale.
 
 	\param string The \a string to put the monetary formatted number into.
@@ -551,4 +616,6 @@
 
 	\sa BLocale::FormatNumber(BString* string, double value) const
 	\sa BLocale::FormatNumber(BString* string, int32 value) const
+
+	\since Haiku R1
 */

docs/user/locale/LocaleRoster.dox

@@ -32,36 +32,48 @@
 	classes from the Locale Kit can be constructed on their own, but only the
 	Locale Roster allows you to do so while taking account of the user's locale
 	settings.
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn BLocaleRoster::BLocaleRoster()
 	\brief Constructor. Does nothing.
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn BLocaleRoster::~BLocaleRoster()
 	\brief Destructor. Does nothing.
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn BLocaleRoster* BLocaleRoster::Default()
 	\brief Returns default BLocalRoster.
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn status_t BLocaleRoster::Refresh()
 	\brief Refreshes the BLocalRoster.
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn status_t BLocaleRoster::GetDefaultTimeZone(BTimeZone* timezone) const
 	\brief Get the default timezone.
+
+	\since Haiku R1
 */
 
 
@@ -69,6 +81,8 @@
 	\fn status_t BLocaleRoster::GetLanguage(const char* languagecode,
 		BLanguage** _language) const
 	\brief Instantiate a language from its code.
+
+	\since Haiku R1
 */
 
 
@@ -79,6 +93,8 @@
 	This function fills in the given message with one or more language string
 	fields. They constitute the ordered list of user-selected languages to use
 	for string translation.
+
+	\since Haiku R1
 */
 
 
@@ -86,6 +102,8 @@
 	\fn status_t BLocaleRoster::GetAvailableLanguages(BMessage* message) const
 	\brief Fills \c message with 'language'-fields containing the language
 	       ID(s) of all available languages.
+
+	\since Haiku R1
 */
 
 
@@ -93,6 +111,8 @@
 	\fn status_t BLocaleRoster::GetAvailableCountries(BMessage* message) const
 	\brief Fills in the passed in \a message with one or more 'country'
 	       string fields, containing the (ISO-639) code of each country.
+
+	\since Haiku R1
 */
 
 
@@ -106,6 +126,8 @@
 	\retval B_BAD_VALUE A \c NULL \a timeZones message was passed in.
 	\retval B_ERROR An error occurred trying to retrieve the localized time zone
 	        strings.
+
+	\since Haiku R1
 */
 
 
@@ -121,6 +143,8 @@
 	\retval B_BAD_VALUE A \c NULL \a timeZones message was passed in.
 	\retval B_ERROR An error occurred trying to retrieve the localized time
 	        zones most likely due to an invalid \a countryCode.
+
+	\since Haiku R1
 */
 
 
@@ -135,6 +159,8 @@
 	\retval B_ERROR Error locking the default RosterData.
 	\retval B_NAME_NOT_FOUND The flag could not be found for the
 	        \a countryCode.
+
+	\since Haiku R1
 */
 
 
@@ -155,6 +181,8 @@
 	\retval B_ERROR Error locking the default RosterData.
 	\retval B_NAME_NOT_FOUND The flag could not be found for the
 	        default country's flag for the \a languageCode.
+
+	\since Haiku R1
 */
 
 
@@ -175,6 +203,8 @@
 	\retval B_OK Everything went well.
 	\retval B_BAD_VALUE A \c NULL \a languageList message was passed in.
 	\retval B_ERROR Error locking the default RosterData.
+
+	\since Haiku R1
 */
 
 
@@ -183,6 +213,8 @@
 	\brief Returns whether or not filesystem translation is preferred.
 
 	\returns \c B_ERROR if there was an error locking the default RosterData.
+
+	\since Haiku R1
 */
 
 
@@ -206,6 +238,8 @@
 	\retval B_OK: success
 	\retval B_ENTRY_NOT_FOUND: failure. Attribute not found, entry not found
 	        in catalog, etc.
+
+	\since Haiku R1
 */
 
 
@@ -226,9 +260,11 @@
 
 	\returns The catalog, if it was loaded successfully.
 
-	\param catalog The catalog to load. The pointer location is used to identify
+	\param catalog The catalog to load. The pointer location is used to
-		the image for which to load the catalog.
+	       identify the image for which to load the catalog.
-	\param catalogInitStatus the state of the catalog. This will be set to true
+	\param catalogInitStatus the state of the catalog. This will be set to
-		on the first call for a given catalog, and if already true the function
+	       true on the first call for a given catalog, and if already true
-		will do nothing on subsequent calls.
+	       the function will do nothing on subsequent calls.
+
+	\since Haiku R1
 */

docs/user/locale/TimeZone.dox

@@ -26,6 +26,8 @@
 	\ingroup locale
 	\ingroup libbe
 	\brief Provides information about time zones.
+
+	\since Haiku R1
 */
 
 
@@ -37,22 +39,30 @@
 	know its code. If you don't know the code, you can instead go through the
 	BCountry class which can enumerate all timezones in a country, or use the
 	BLocaleRoster, which knows the timezone selected by the user.
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn BTimeZone::BTimeZone(const BTimeZone& other)
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn BTimeZone& BTimeZone::operator=(const BTimeZone& source)
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn const BString& BTimeZone::ID() const
 	\brief Returns the ID of the time zone.
+
+	\since Haiku R1
 */
 
 
@@ -61,18 +71,24 @@
 	\brief Returns the localized name of the time zone.
 
 	Use this method to display the time zone's name to the user.
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn const BString& BTimeZone::DaylightSavingName() const
 	\brief Returns the name of the daylight savings rules used in this timezone.
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn const BString& BTimeZone::ShortName() const
 	\brief Returns the short name of the timezone, in the user's locale.
+
+	\since Haiku R1
 */
 
 
@@ -80,6 +96,8 @@
 	\fn const BString& BTimeZone::ShortDaylightSavingName() const
 	\brief Returns the short name of the daylight savings rules used in this
 	       timezone.
+
+	\since Haiku R1
 */
 
 
@@ -88,20 +106,26 @@
 	\brief Return the offset from GMT.
 
 	The offset is a number of seconds, positive or negative.
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn bool BTimeZone::SupportsDaylightSaving() const
 	\brief Return true if the time zone has daylight saving rules
+
+	\since Haiku R1
 */
 
 
 /*!
 	\fn status_t BTimeZone::InitCheck() const
 	\brief Return \c false if there was an error creating the timezone
-		for instance if you called the constructor or SetTo() with an invalid
+	       for instance if you called the constructor or SetTo() with an
-		timezone code.)
+	       invalid timezone code.
+
+	\since Haiku R1
 */
 
 
@@ -112,4 +136,6 @@
 
 	\returns \c false if there was an error (likely due to an invalid
 	         timezone code.)
+
+	\since Haiku R1
 */

docs/user/locale/UnicodeChar.dox

@@ -39,6 +39,8 @@
 	Note all the function work with chars encoded in UTF-32. This is not the
 	most usual way to handle characters, but it is the fastest. To convert an
 	UTF-8 string to an UTF-32 character use the FromUTF8() method.
+
+	\since Haiku R1
 */
 
 
@@ -48,6 +50,8 @@
 
 	\returns \c true if the specified unicode character is an
 	         alphabetic character.
+
+	\since Haiku R1
 */
 
 
@@ -57,6 +61,8 @@
 
 	\returns \c true if the specified unicode character is a
 	         alphabetic or numeric character.
+
+	\since Haiku R1
 */
 
 
@@ -66,6 +72,8 @@
 
 	\returns \c true if the specified unicode character is a
 	         number character.
+
+	\since Haiku R1
 */
 
 
@@ -75,6 +83,8 @@
 
 	\returns \c true if the specified unicode character is a
 	         hexadecimal number character.
+
+	\since Haiku R1
 */
 
 
@@ -84,6 +94,8 @@
 
 	\returns \c true if the specified unicode character is an
 	         uppercase character.
+
+	\since Haiku R1
 */
 
 
@@ -93,6 +105,8 @@
 
 	\returns \c true if the specified unicode character is a
 	         lowercase character.
+
+	\since Haiku R1
 */
 
 
@@ -108,6 +122,8 @@
 	         kind of a space character.
 
 	\sa IsWhitespace()
+
+	\since Haiku R1
 */
 
 
@@ -122,6 +138,8 @@
 	         character.
 
 	\sa IsSpace()
+
+	\since Haiku R1
 */
 
 
@@ -136,6 +154,8 @@
 	         character.
 
 	\sa IsPrintable()
+
+	\since Haiku R1
 */
 
 
@@ -145,6 +165,8 @@
 
 	\returns \c true if the specified unicode character is a
 	         punctuation character.
+
+	\since Haiku R1
 */
 
 
@@ -158,6 +180,8 @@
 	         character.
 
 	\sa IsControl()
+
+	\since Haiku R1
 */
 
 
@@ -169,6 +193,8 @@
 
 	\returns \c true if the specified unicode character is a title case
 	         character.
+
+	\since Haiku R1
 */
 
 
@@ -180,6 +206,8 @@
 	For these codes this method will return \c false.
 
 	\returns \c true if the specified unicode character is defined.
+
+	\since Haiku R1
 */
 
 
@@ -191,6 +219,8 @@
 
 	\returns \c true if the specified unicode character is a base
 	         form character that can be used with a diacritic.
+
+	\since Haiku R1
 */
 
 
@@ -199,6 +229,8 @@
 	\brief Gets the type of a character.
 
 	\returns A member of the \c unicode_char_category enum.
+
+	\since Haiku R1
 */
 
 
@@ -207,6 +239,8 @@
 	\brief Transforms \a c to lowercase.
 
 	\returns The lowercase version of the specified unicode character.
+
+	\since Haiku R1
 */
 
 
@@ -215,6 +249,8 @@
 	\brief Transforms \a c to uppercase.
 
 	\returns The uppercase version of the specified unicode character.
+
+	\since Haiku R1
 */
 
 
@@ -223,6 +259,8 @@
 	\brief Transforms \a c to title case.
 
 	\returns The title case version of the specified unicode character.
+
+	\since Haiku R1
 */
 
 
@@ -231,6 +269,8 @@
 	\brief Gets the numeric value \a c.
 
 	\returns The numeric version of the specified unicode character.
+
+	\since Haiku R1
 */
 
 
@@ -239,6 +279,8 @@
 	\brief Transform a character to UTF-8 encoding.
 
 	\returns The UTF-8 encoding of the specified unicode character.
+
+	\since Haiku R1
 */
 
 
@@ -251,27 +293,35 @@
 	character for the following call.
 
 	\returns The UTF-32 encoded version of \a in.
+
+	\since Haiku R1
 */
 
 
 /*!
-	\fn size_t BUnicodeChar::UTF8StringLength(const char *str)
+	\fn size_t BUnicodeChar::UTF8StringLength(const char* string)
 	\brief Counts the characters in the given \c NUL terminated string.
 
 	\returns the number of UTF-8 characters in the \c NUL terminated string.
 
 	\sa BString::CountChars()
+
+	\since Haiku R1
 */
 
 
 /*!
-	\fn size_t BUnicodeChar::UTF8StringLength(const char *str, size_t maxLength)
+	\fn size_t BUnicodeChar::UTF8StringLength(const char* string,
+		size_t maxLength)
 	\brief Counts the characters in the given string up to \a maxLength
 		characters.
 
-	The string does not need to be \c NUL terminated if you specify a
+	\param string does not need to be \c NUL terminated if you specify a
 	       \a maxLength that is shorter than the maximum length of the string.
+	\param maxLength The maximum length of the string in bytes.
 
 	\returns the number of UTF-8 characters in the \c NUL terminated string
 	         up to \a maxLength characters.
+
+	\since Haiku R1
 */