Is that really accurate to say that elements are stored in a pointer?
On Thu, Mar 19, 2015 at 12:41:48PM +0001, Jason McIntyre wrote: > On Wed, Mar 18, 2015 at 03:32:40PM -0400, Andre Smagin wrote: > > Hello. > > > > mbstowcs(3), wcrtomb(3) and wcstombs(3) use a bit awkward wording - > > "the first at most", and repeat "array pointed to by blah" from the > > previous sentence. > > > > Perhaps something similar to this diff would make them easier to read? > > > > fixed, thanks. > jmc > > > > > Index: mbstowcs.3 > > =================================================================== > > RCS file: /cvs/src/lib/libc/locale/mbstowcs.3,v > > retrieving revision 1.5 > > diff -u -p -u -r1.5 mbstowcs.3 > > --- mbstowcs.3 5 Jun 2013 03:39:22 -0000 1.5 > > +++ mbstowcs.3 18 Mar 2015 19:05:39 -0000 > > @@ -46,9 +46,9 @@ converts a null-terminated multibyte cha > > to the corresponding wide-character string and stores it in the array > > pointed to by > > .Fa pwcs . > > -This function may modify the first at most > > +Up to > > .Fa n > > -elements of the array pointed to by > > +elements are stored in > > .Fa pwcs . > > Each character will be converted as if > > .Xr mbtowc 3 > > Index: wcrtomb.3 > > =================================================================== > > RCS file: /cvs/src/lib/libc/locale/wcrtomb.3,v > > retrieving revision 1.7 > > diff -u -p -u -r1.7 wcrtomb.3 > > --- wcrtomb.3 28 Aug 2013 16:24:07 -0000 1.7 > > +++ wcrtomb.3 18 Mar 2015 19:05:39 -0000 > > @@ -48,9 +48,9 @@ pointed to by > > unless > > .Fa s > > is a null pointer. > > -This function will modify the first at most > > +Up to > > .Dv MB_CUR_MAX > > -bytes of the array pointed by > > +bytes are stored in > > .Fa s . > > .Pp > > The behaviour of > > Index: wcstombs.3 > > =================================================================== > > RCS file: /cvs/src/lib/libc/locale/wcstombs.3,v > > retrieving revision 1.5 > > diff -u -p -u -r1.5 wcstombs.3 > > --- wcstombs.3 5 Jun 2013 03:39:22 -0000 1.5 > > +++ wcstombs.3 18 Mar 2015 19:05:39 -0000 > > @@ -45,9 +45,9 @@ converts the null-terminated wide-charac > > to the corresponding multibyte character string, > > and stores it in the array pointed to by > > .Fa s . > > -This function may modify the first at most > > +Up to > > .Fa n > > -bytes of the array pointed to by > > +bytes are stored in > > .Fa s . > > Each character will be converted as if > > .Xr wctomb 3 > > >