the <function>gettimeofday()</function> UNIX call.
</para>
-@tv_sec: seconds.
-@tv_usec: microseconds.
+@tv_sec: seconds
+@tv_usec: microseconds
<!-- ##### FUNCTION g_get_current_time ##### -->
<para>
length of the sleep.
</para>
-@microseconds: number of microseconds to pause.
+@microseconds: number of microseconds to pause
<!-- ##### FUNCTION g_time_val_add ##### -->
#G_DATE_FEBRUARY, etc. #G_DATE_BAD_MONTH is the invalid value.
</para>
-@G_DATE_BAD_MONTH: invalid value.
-@G_DATE_JANUARY: January.
-@G_DATE_FEBRUARY: February.
-@G_DATE_MARCH: March.
-@G_DATE_APRIL: April.
-@G_DATE_MAY: May.
-@G_DATE_JUNE: June.
-@G_DATE_JULY: July.
-@G_DATE_AUGUST: August.
-@G_DATE_SEPTEMBER: September.
-@G_DATE_OCTOBER: October.
-@G_DATE_NOVEMBER: November.
-@G_DATE_DECEMBER: December.
+@G_DATE_BAD_MONTH: invalid value
+@G_DATE_JANUARY: January
+@G_DATE_FEBRUARY: February
+@G_DATE_MARCH: March
+@G_DATE_APRIL: April
+@G_DATE_MAY: May
+@G_DATE_JUNE: June
+@G_DATE_JULY: July
+@G_DATE_AUGUST: August
+@G_DATE_SEPTEMBER: September
+@G_DATE_OCTOBER: October
+@G_DATE_NOVEMBER: November
+@G_DATE_DECEMBER: December
<!-- ##### TYPEDEF GDateYear ##### -->
<para>
#G_DATE_TUESDAY, etc. #G_DATE_BAD_WEEKDAY is an invalid weekday.
</para>
-@G_DATE_BAD_WEEKDAY: invalid value.
-@G_DATE_MONDAY: Monday.
-@G_DATE_TUESDAY: Tuesday.
-@G_DATE_WEDNESDAY: Wednesday.
-@G_DATE_THURSDAY: Thursday.
-@G_DATE_FRIDAY: Friday.
-@G_DATE_SATURDAY: Saturday.
-@G_DATE_SUNDAY: Sunday.
+@G_DATE_BAD_WEEKDAY: invalid value
+@G_DATE_MONDAY: Monday
+@G_DATE_TUESDAY: Tuesday
+@G_DATE_WEDNESDAY: Wednesday
+@G_DATE_THURSDAY: Thursday
+@G_DATE_FRIDAY: Friday
+@G_DATE_SATURDAY: Saturday
+@G_DATE_SUNDAY: Sunday
<!-- ##### MACRO G_DATE_BAD_DAY ##### -->
<para>
represent an existing day). Free the return value with g_date_free().
</para>
-@Returns: a newly-allocated #GDate.
+@Returns: a newly-allocated #GDate
<!-- ##### FUNCTION g_date_new_dmy ##### -->
returned date will be valid.
</para>
-@day: day of the month.
-@month: month of the year.
+@day: day of the month
+@month: month of the year
@year: year
-@Returns: a newly-allocated #GDate initialized with @day, @month, and @year.
+@Returns: a newly-allocated #GDate initialized with @day, @month, and @year
<!-- ##### FUNCTION g_date_new_julian ##### -->
unreasonably large number), the returned date will be valid.
</para>
-@julian_day: days since January 1, Year 1.
-@Returns: a newly-allocated #GDate initialized with @julian_day.
+@julian_day: days since January 1, Year 1
+@Returns: a newly-allocated #GDate initialized with @julian_day
<!-- ##### FUNCTION g_date_clear ##### -->
Validity can be tested with g_date_valid().
</para>
-@date: pointer to one or more dates to clear.
-@n_dates: number of dates to clear.
+@date: pointer to one or more dates to clear
+@n_dates: number of dates to clear
<!-- ##### FUNCTION g_date_free ##### -->
Frees a #GDate returned from g_date_new().
</para>
-@date: a #GDate.
+@date: a #GDate
<!-- ##### FUNCTION g_date_set_day ##### -->
triplet is invalid, the date will be invalid.
</para>
-@date: a #GDate.
-@day: day to set.
+@date: a #GDate
+@day: day to set
<!-- ##### FUNCTION g_date_set_month ##### -->
day-month-year triplet is invalid, the date will be invalid.
</para>
-@date: a #GDate.
-@month: month to set.
+@date: a #GDate
+@month: month to set
<!-- ##### FUNCTION g_date_set_year ##### -->
invalid, the date will be invalid.
</para>
-@date: a #GDate.
-@year: year to set.
+@date: a #GDate
+@year: year to set
<!-- ##### FUNCTION g_date_set_dmy ##### -->
check before you set it.
</para>
-@date: a #GDate.
-@day: day.
-@month: month.
-@y: year.
+@date: a #GDate
+@day: day
+@month: month
+@y: year
<!-- ##### FUNCTION g_date_set_julian ##### -->
Sets the value of a #GDate from a Julian day number.
</para>
-@date: a #GDate.
-@julian_date: Julian day number (days since January 1, Year 1).
+@date: a #GDate
+@julian_date: Julian day number (days since January 1, Year 1)
<!-- ##### FUNCTION g_date_set_time ##### -->
capacity).
</para>
-@date: a #GDate to fill in.
-@str: string to parse.
+@date: a #GDate to fill in
+@str: string to parse
<!-- ##### FUNCTION g_date_add_days ##### -->
weeks*7 days. The date must be valid.
</para>
-@date: a #GDate to increment.
-@n_days: number of days to move the date forward.
+@date: a #GDate to increment
+@n_days: number of days to move the date forward
<!-- ##### FUNCTION g_date_subtract_days ##### -->
move by weeks*7 days. The date must be valid.
</para>
-@date: a #GDate to decrement.
-@n_days: number of days to move.
+@date: a #GDate to decrement
+@n_days: number of days to move
<!-- ##### FUNCTION g_date_add_months ##### -->
must be valid.
</para>
-@date: a #GDate to increment.
-@n_months: number of months to move forward.
+@date: a #GDate to increment
+@n_months: number of months to move forward
<!-- ##### FUNCTION g_date_subtract_months ##### -->
may change. The date must be valid.
</para>
-@date: a #GDate to decrement.
-@n_months: number of months to move.
+@date: a #GDate to decrement
+@n_months: number of months to move
<!-- ##### FUNCTION g_date_add_years ##### -->
to February 28. The date must be valid.
</para>
-@date: a #GDate to increment.
-@n_years: number of years to move forward.
+@date: a #GDate to increment
+@n_years: number of years to move forward
<!-- ##### FUNCTION g_date_subtract_years ##### -->
must be valid.
</para>
-@date: a #GDate to decrement.
-@n_years: number of years to move.
+@date: a #GDate to decrement
+@n_years: number of years to move
<!-- ##### FUNCTION g_date_days_between ##### -->
Both dates must be valid.
</para>
-@date1: the first date.
-@date2: the second date.
-@Returns: the number of days between @date1 and @date2.
+@date1: the first date
+@date2: the second date
+@Returns: the number of days between @date1 and @date2
<!-- ##### FUNCTION g_date_compare ##### -->
<para>
-<function>qsort()</function>-style comparsion function for dates. Both
+qsort()-style comparsion function for dates. Both
dates must be valid.
</para>
-@lhs: first date to compare.
-@rhs: second date to compare.
+@lhs: first date to compare
+@rhs: second date to compare
@Returns: 0 for equal, less than zero if @lhs is less than @rhs,
-greater than zero if @lhs is greater than @rhs.
+ greater than zero if @lhs is greater than @rhs
<!-- ##### FUNCTION g_date_clamp ##### -->
must be valid.
</para>
-@date: a #GDate to clamp.
-@min_date: minimum accepted value for @date.
-@max_date: maximum accepted value for @date.
+@date: a #GDate to clamp
+@min_date: minimum accepted value for @date
+@max_date: maximum accepted value for @date
<!-- ##### FUNCTION g_date_order ##### -->
and swap the values if this is not the case.
</para>
-@date1: the first date.
-@date2: the second date.
+@date1: the first date
+@date2: the second date
<!-- ##### FUNCTION g_date_get_day ##### -->
Returns the day of the month. The date must be valid.
</para>
-@date: a #GDate to extract the day of the month from.
-@Returns: day of the month.
+@date: a #GDate to extract the day of the month from
+@Returns: day of the month
<!-- ##### FUNCTION g_date_get_month ##### -->
Returns the month of the year. The date must be valid.
</para>
-@date: a #GDate to get the month from.
-@Returns: month of the year as a #GDateMonth.
+@date: a #GDate to get the month from
+@Returns: month of the year as a #GDateMonth
<!-- ##### FUNCTION g_date_get_year ##### -->
Returns the year of a #GDate. The date must be valid.
</para>
-@date: a #GDate.
-@Returns: year in which the date falls.
+@date: a #GDate
+@Returns: year in which the date falls
<!-- ##### FUNCTION g_date_get_julian ##### -->
etc. The date must be valid.
</para>
-@date: a #GDate to extract the Julian day from.
-@Returns: Julian day.
+@date: a #GDate to extract the Julian day from
+@Returns: Julian day
<!-- ##### FUNCTION g_date_get_weekday ##### -->
year. The date must be valid.
</para>
-@date: a #GDate to extract day of year from.
-@Returns: day of the year.
+@date: a #GDate to extract day of year from
+@Returns: day of the year
<!-- ##### FUNCTION g_date_get_days_in_month ##### -->
Returns the number of days in a month, taking leap years into account.
</para>
-@month: month.
-@year: year.
-@Returns: number of days in @month during the @year.
+@month: month
+@year: year
+@Returns: number of days in @month during the @year
<!-- ##### FUNCTION g_date_is_first_of_month ##### -->
Returns %TRUE if the date is on the first of a month. The date must be valid.
</para>
-@date: a #GDate to check.
-@Returns: %TRUE if the date is the first of the month.
+@date: a #GDate to check
+@Returns: %TRUE if the date is the first of the month
<!-- ##### FUNCTION g_date_is_last_of_month ##### -->
Returns %TRUE if the date is the last day of the month. The date must be valid.
</para>
-@date: a #GDate to check.
-@Returns: %TRUE if the date is the last day of the month.
+@date: a #GDate to check
+@Returns: %TRUE if the date is the last day of the month
<!-- ##### FUNCTION g_date_is_leap_year ##### -->
Returns %TRUE if the year is a leap year.
</para>
-@year: year to check.
-@Returns: %TRUE if the year is a leap year.
+@year: year to check
+@Returns: %TRUE if the year is a leap year
<!-- ##### FUNCTION g_date_get_monday_week_of_year ##### -->
0. The date must be valid.
</para>
-@date: a #GDate.
-@Returns: week of the year.
+@date: a #GDate
+@Returns: week of the year
<!-- ##### FUNCTION g_date_get_monday_weeks_in_year ##### -->
to be a Monday.)
</para>
-@year: a year.
-@Returns: number of Mondays in the year.
+@year: a year
+@Returns: number of Mondays in the year
<!-- ##### FUNCTION g_date_get_sunday_week_of_year ##### -->
the day is before the first Sunday of the year.
</para>
-@date: a #GDate.
-@Returns: week number.
+@date: a #GDate
+@Returns: week number
<!-- ##### FUNCTION g_date_get_sunday_weeks_in_year ##### -->
to be a Sunday.)
</para>
-@year: year to count weeks in.
-@Returns: number of weeks.
+@year: year to count weeks in
+@Returns: number of weeks
<!-- ##### FUNCTION g_date_get_iso8601_week_of_year ##### -->
strftime() work on Windows where the C library only complies to C89.
</para>
-@s: destination buffer.
-@slen: buffer size.
-@format: format string.
-@date: valid #GDate.
-@Returns: number of characters written to the buffer, or 0 the buffer was too small.
+@s: destination buffer
+@slen: buffer size
+@format: format string
+@date: valid #GDate
+@Returns: number of characters written to the buffer, or 0 the buffer was too small
<!-- ##### FUNCTION g_date_to_struct_tm ##### -->
if it wasn't allocated by one of the g_date_new() variants.
</para>
-@date: a #GDate to check.
-@Returns: Whether the date is valid.
+@date: a #GDate to check
+@Returns: Whether the date is valid
<!-- ##### FUNCTION g_date_valid_day ##### -->
between 1 and 31 inclusive).
</para>
-@day: day to check.
-@Returns: %TRUE if the day is valid.
+@day: day to check
+@Returns: %TRUE if the day is valid
<!-- ##### FUNCTION g_date_valid_month ##### -->
enumeration values are the only valid months.
</para>
-@month: month.
-@Returns: %TRUE if the month is valid.
+@month: month
+@Returns: %TRUE if the month is valid
<!-- ##### FUNCTION g_date_valid_year ##### -->
though there is a 16-bit limit to what #GDate will understand.
</para>
-@year: year.
-@Returns: %TRUE if the year is valid.
+@year: year
+@Returns: %TRUE if the year is valid
<!-- ##### FUNCTION g_date_valid_dmy ##### -->
a few thousand years in the future).
</para>
-@day: day.
-@month: month.
-@year: year.
-@Returns: %TRUE if the date is a valid one.
+@day: day
+@month: month
+@year: year
+@Returns: %TRUE if the date is a valid one
<!-- ##### FUNCTION g_date_valid_julian ##### -->
<para>
-Returns %TRUE if the Julian day is valid. Anything greater than zero is basically a
-valid Julian, though there is a 32-bit limit.
+Returns %TRUE if the Julian day is valid. Anything greater than zero
+is basically a valid Julian, though there is a 32-bit limit.
</para>
-@julian_date: Julian day to check.
-@Returns: %TRUE if the Julian day is valid.
+@julian_date: Julian day to check
+@Returns: %TRUE if the Julian day is valid
<!-- ##### FUNCTION g_date_valid_weekday ##### -->
<para>
-Returns %TRUE if the weekday is valid. The 7 #GDateWeekday enumeration
+Returns %TRUE if the weekday is valid. The seven #GDateWeekday enumeration
values are the only valid weekdays.
</para>
-@weekday: weekday.
-@Returns: %TRUE if the weekday is valid.
+@weekday: weekday
+@Returns: %TRUE if the weekday is valid