Mon Mar 18 02:15:21 2019 UTC ()
restore the removed "function does something horrible" description,
but leave the real description as well.


(mrg)
diff -r1.11 -r1.12 src/lib/libc/string/strxfrm.3
cvs diff -r1.11 -r1.12 src/lib/libc/string/strxfrm.3 (expand / switch to unified diff)

--- src/lib/libc/string/strxfrm.3 2007/02/18 00:46:47 1.11
+++ src/lib/libc/string/strxfrm.3 2019/03/18 02:15:21 1.12
@@ -20,44 +20,45 @@ @@ -20,44 +20,45 @@
20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 20.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 23.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE. 30.\" SUCH DAMAGE.
31.\" 31.\"
32.\" from: @(#)strxfrm.3 8.1 (Berkeley) 6/4/93 32.\" from: @(#)strxfrm.3 8.1 (Berkeley) 6/4/93
33.\" $NetBSD: strxfrm.3,v 1.11 2007/02/18 00:46:47 wiz Exp $ 33.\" $NetBSD: strxfrm.3,v 1.12 2019/03/18 02:15:21 mrg Exp $
34.\" 34.\"
35.Dd February 18, 2007 35.Dd March 6, 2019
36.Dt STRXFRM 3 36.Dt STRXFRM 3
37.Os 37.Os
38.Sh NAME 38.Sh NAME
39.Nm strxfrm 39.Nm strxfrm
40.Nd transform a string under locale 40.Nd transform a string under locale
41.Sh LIBRARY 41.Sh LIBRARY
42.Lb libc 42.Lb libc
43.Sh SYNOPSIS 43.Sh SYNOPSIS
44.In string.h 44.In string.h
45.Ft size_t 45.Ft size_t
46.Fn strxfrm "char * restrict dst" "const char * restrict src" "size_t n" 46.Fn strxfrm "char * restrict dst" "const char * restrict src" "size_t n"
47.Sh DESCRIPTION 47.Sh DESCRIPTION
48The idea of 48The
49.Fn strxfrm 49.Fn strxfrm
50is to 50function does something horrible.
 51The idea is to
51.Dq un-localize 52.Dq un-localize
52a string: the function transforms 53a string: the function transforms
53.Ar src , 54.Ar src ,
54storing the result in 55storing the result in
55.Ar dst , 56.Ar dst ,
56such that 57such that
57.Xr strcmp 3 58.Xr strcmp 3
58on transformed strings returns what 59on transformed strings returns what
59.Xr strcoll 3 60.Xr strcoll 3
60on the original untransformed strings would return. 61on the original untransformed strings would return.
61.Sh SEE ALSO 62.Sh SEE ALSO
62.Xr bcmp 3 , 63.Xr bcmp 3 ,
63.Xr memcmp 3 , 64.Xr memcmp 3 ,