diff --git a/newlib/ChangeLog b/newlib/ChangeLog index 426eb7071..aa135e05f 100644 --- a/newlib/ChangeLog +++ b/newlib/ChangeLog @@ -1,3 +1,8 @@ +2009-03-12 Craig Howland + + * libc/time/time.tex (wcsftime.def): Include. + * libc/time/wcsftime.c: Clean up documentation a little. + 2009-03-12 Craig Howland * libc/stdio/swscanf.c: Some documentation corrections. diff --git a/newlib/libc/string/wcstrings.tex b/newlib/libc/string/wcstrings.tex index 298d2bc71..5b9c22069 100644 --- a/newlib/libc/string/wcstrings.tex +++ b/newlib/libc/string/wcstrings.tex @@ -18,6 +18,7 @@ declarations are in @file{wchar.h}. * wcscpy:: Copy wide-character string * wcpcpy:: Copy a wide-character string returning a pointer to its end * wcscspn:: Count wide characters not in string +* wcsftime:: Convert date and time to a formatted wide-character string * wcslcat:: Concatenate wide-character strings to specified length * wcslcpy:: Copy wide-character string to specified length * wcslen:: Wide-character string length @@ -72,6 +73,9 @@ declarations are in @file{wchar.h}. @page @include string/wcscspn.def +@page +@include time/wcsftime.def + @page @include string/wcslcat.def diff --git a/newlib/libc/time/wcsftime.c b/newlib/libc/time/wcsftime.c index 323a6c2eb..ac71a0941 100644 --- a/newlib/libc/time/wcsftime.c +++ b/newlib/libc/time/wcsftime.c @@ -20,17 +20,21 @@ ANSI_SYNOPSIS const wchar_t *<[format]>, const struct tm *<[timp]>); DESCRIPTION -<> is equivalent to <>, except that: +<> is equivalent to <>, except that: -The argument s points to the initial element of an array of wide characters +O+ +o The argument s points to the initial element of an array of wide characters into which the generated output is to be placed. -The argument maxsize indicates the limiting number of wide characters. +o The argument maxsize indicates the limiting number of wide characters. -The argument format is a wide-character string and the conversion specifiers +o The argument format is a wide-character string and the conversion specifiers are replaced by corresponding sequences of wide characters. -The return value indicates the number of wide characters. +o The return value indicates the number of wide characters. +O- +(The difference in all of the above being wide characters versus regular +characters.) See <> for the details of the format specifiers. @@ -52,10 +56,10 @@ value beforehand to distinguish between failure and an empty string. This implementation does not support <> being NULL, nor overlapping <> and <>. +<> requires no supporting OS subroutines. + SEEALSO <> - -<> requires no supporting OS subroutines. */ #include