docs/54391: Document that glob(3) respects LC_COLLATE

[Thomas Seck]

>Number:         54391
>Category:       docs
>Synopsis:       Document that glob(3) respects LC_COLLATE
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jul 11 10:50:14 PDT 2003
>Closed-Date:
>Last-Modified:
>Originator:     Thomas Seck
>Release:        FreeBSD HEAD as of July 11, 2003
>Organization:
>Environment:
FreeBSD 4-STABLE

	
>Description:
	glob(3)'s description of GLOB_NOSORT claims that glob(3) always
	sorts in alphabetical order as specified by ASCII.
	This is not true if LC_COLLATE (or LANG, resp.) are set.
>How-To-Repeat:
	Create the files a.test, b.test and <aumlaut>.test with <aumlaut>
	being the "a with dots" present in ISO8859-1.
	Then compare the output of
	env LC_COLLATE=en_US.US-ASCII ls *.test
	(<aumlaut>.test ist sorted last)
	with
	env LC_COLLATE=en_US.ISO8859-1 ls *.test
	(<aumlaut is sorted between a and b).
>Fix:
	Reword glob(3) like this:

	Index: glob.3
	===================================================================
	RCS file: /home/ncvs/src/lib/libc/gen/glob.3,v
	retrieving revision 1.23
	diff -u -r1.23 glob.3
	--- glob.3	4 Feb 2003 16:27:42 -0000	1.23
	+++ glob.3	11 Jul 2003 17:05:58 -0000
	@@ -197,10 +197,10 @@
	 .Dv GLOB_NOESCAPE
	 is set, backslash escaping is disabled.
	 .It Dv GLOB_NOSORT
	-By default, the pathnames are sorted in ascending
	-.Tn ASCII
	-order;
	-this flag prevents that sorting (speeding up
	+By default, the pathnames are sorted in locale specific ascending order
	+as specified by
	+.Ev LC_COLLATE .
	+This flag prevents that sorting (speeding up
	 .Fn glob ) .
	 .El
	 .Pp
	@@ -421,7 +421,8 @@
	 .Sh SEE ALSO
	 .Xr sh 1 ,
	 .Xr fnmatch 3 ,
	-.Xr regexp 3
	+.Xr regexp 3 ,
	+.Xr setlocale 3
	 .Sh STANDARDS
	 The
	 .Fn glob


>Release-Note:
>Audit-Trail:
>Unformatted: