svn commit: r352315 - head/lib/libc/locale

[Li-Wen Hsu]

Author: lwhsu
Date: Sat Sep 14 08:15:16 2019
New Revision: 352315
URL: https://svnweb.freebsd.org/changeset/base/352315

Log:
  Improve the description of big5(5)
  
  - Fix the statement that big5 is a de facto standard of Traditional Chinese
    text [1]
  - Add a BUGS section describes the problem of big5 and suggests use utf8
  
  PR:		189095
  Submitted by:	Brennan Vincent <brennan at umanwizard.com> [1]
  Reviewed by:	Ting-Wei Lan <lantw44 at gmail.com>
  MFC after:	3 days
  Sponsored by:	The FreeBSD Foundation
  Differential Revision:	https://reviews.freebsd.org/D21622

Modified:
  head/lib/libc/locale/big5.5

Modified: head/lib/libc/locale/big5.5
==============================================================================
--- head/lib/libc/locale/big5.5	Sat Sep 14 03:38:18 2019	(r352314)
+++ head/lib/libc/locale/big5.5	Sat Sep 14 08:15:16 2019	(r352315)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd August 7, 2003
+.Dd September 12, 2019
 .Dt BIG5 5
 .Os
 .Sh NAME
@@ -37,7 +37,7 @@ encoding for Traditional Chinese text
 .Qq BIG5
 .Sh DESCRIPTION
 .Dq Big Five
-is the de facto standard for encoding Traditional Chinese text.
+is a standard for encoding Traditional Chinese text.
 Each character is represented by either one or two bytes.
 Characters from the
 .Tn ASCII
@@ -49,3 +49,10 @@ the first in the range 0xA1 - 0xFE, the second in the 
 .Xr euc 5 ,
 .Xr gb18030 5 ,
 .Xr utf8 5
+.Sh BUGS
+The range of the second byte overlaps some ASCII characters, including
+0x5C (`\\') and 0x7C (`|') which may cause problems in program execution or
+display.
+Big5 is considered a legacy standard and only preserved for backward
+compatibility reason.
+New documents and systems are suggested using UTF-8 directly.