From sacadmin Fri Jul 21 18:27:37 2006 Received: from sparc-build.SFBay.Sun.COM (sparc-build.SFBay.Sun.COM [10.5.23.87]) by sac.sfbay.sun.com (8.13.6+Sun/8.13.6) with ESMTP id k6M1RaHc021929; Fri, 21 Jul 2006 18:27:36 -0700 (PDT) Received: from sparc-build.SFBay.Sun.COM (localhost [127.0.0.1]) by sparc-build.SFBay.Sun.COM (8.13.3+Sun/8.13.3) with ESMTP id k6M15QNY026334; Fri, 21 Jul 2006 18:05:26 -0700 (PDT) Received: (from is@localhost) by sparc-build.SFBay.Sun.COM (8.13.3+Sun/8.13.3/Submit) id k6M15PeL026330; Fri, 21 Jul 2006 18:05:25 -0700 (PDT) Date: Fri, 21 Jul 2006 18:05:25 -0700 (PDT) From: Ienup Sung Message-Id: <200607220105.k6M15PeL026330@sparc-build.SFBay.Sun.COM> To: PSARC@sac.sfbay.sun.com Cc: federic.zhang@sun.com Subject: UTF8_STRING support in Solaris libX11 and XLC modules [PSARC/2006/448 Timeout: 07/28/2006] Status: RO Content-Length: 3648 Subject: PSARC FastTrack [07/28/2006]: UTF8_STRING support in Solaris libX11 and XLC modules Template Version: @(#)sac_nextcase 1.56 10/26/05 SMI This information is Copyright 2006 Sun Microsystems, Inc. All Rights Reserved. 1. Introduction 1.1. Project/Component Working Name: UTF8_STRING support in Solaris libX11 and XLC modules 1.2. Name of Document Author/Supplier: Author: Federic Zhang 1.3 Date of This Document: 21 July, 2006 4. Technical Description OVERVIEW This project adds UTF8_STRING support at our libX11. The UTF8_STRING support has been added to XFree86 several years ago and thus has been also available at X.Org libX11. Due to the availability at the XF86 and now the X.Org, it is also widely used and supported at various open source X11 applications and system libraries. Because of that, our customers are also demanding the same support in our X11 libraries. TECHNICAL OVERVIEW The will have XUTF8StringStyle at the XICCEncodingStyle as like the following: typedef enum { XStringStyle, /* STRING */ XCompoundTextStyle, /* COMPOUND_TEXT */ XTextStyle, /* text in owner's encoding (current locale)*/ XStdICCTextStyle, /* STRING, else COMPOUND_TEXT */ | XUTF8StringStyle /* UTF8_STRING */ } XICCEncodingStyle; When the XUTF8StringStyle is used as an input argument value to XmbTextListToTextProperty(3X11), XwcTextListToTextProperty(3X11), XmbTextPropertyToTextList(3X11), or XwcTextPropertyToTextList(3X11) indicating that the text property is in UTF8_STRING, the functions will appropriately convert between UTF8_STRING text property data and multibyte or wide character text list of the current locale. XLC modules of all supported locales will also have necessary internal converters added to the modules during the initialization of the XLC module. The internal converters will at least take care of encoding and possible code conversions between the current locale's multibyte or wide character text list and text data of UTF8_STRING text property. For this, XlcNUtf8String data type indicator macro will also be added at the header file for proper communication between libX11 and XLC modules: #define XlcNMultiByte "multiByte" #define XlcNWideChar "wideChar" #define XlcNCompoundText "compoundText" #define XlcNString "string" | #define XlcNUtf8String "utf8String" #define XlcNCharSet "charSet" #define XlcNCTCharSet "CTcharSet" #define XlcNChar "char" INTERFACE STABILITIES The project exports the following interfaces: Interface name Stability Note -------------- --------- ---- XUTF8StringStyle at Committed from X.Org XICEncodingStyle XlcNUtf8String Committed from X.Org XLC UTF-8 at Xlib Contracted [2] Consolidation Private UTF8_STRING support at Committed [1] from X.Org XmbTextListToTextProperty(3X11), XwcTextListToTextProperty(3X11), XmbTextPropertyToTextList(3X11), and XwcTextPropertyToTextList(3X11) There is no significant interfaces imported. RELEASE BINDING The project team asks for Micro/Patch release binding. REFERENCES [1] XmbTextListToTextProperty(3X11) man page at the case directory. [2] Contract template, contract-template.txt, at the case directory. 6. Resources and Schedule 6.4. Steering Committee requested information 6.4.1. Consolidation C-team Name: G11N 6.5. ARC review type: FastTrack From sacadmin Wed Jul 26 16:17:28 2006 Received: from sfbaymail2sca.sfbay.sun.com (sfbaymail2sca.SFBay.Sun.COM [129.145.155.42]) by sac.sfbay.sun.com (8.13.6+Sun/8.13.6) with ESMTP id k6QNHSAV003010 for ; Wed, 26 Jul 2006 16:17:28 -0700 (PDT) Received: from nwkea-pix-1.sun.com (nwkes-gis-mail-2.SFBay.Sun.COM [10.4.134.6]) by sfbaymail2sca.sfbay.sun.com (8.13.6+Sun/8.12.10/ENSMAIL,v2.2) with ESMTP id k6QNHSwu018028 for ; Wed, 26 Jul 2006 16:17:28 -0700 (PDT) Received: from d1-sfbay-05.sun.com ([192.18.39.115]) by nwkea-pix-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id k6QNHNlX020950 for ; Wed, 26 Jul 2006 16:17:23 -0700 (PDT) Received: from conversion-daemon.d1-sfbay-05.sun.com by d1-sfbay-05.sun.com (Sun Java System Messaging Server 6.2-4.02 (built Sep 9 2005)) id <0J3100K01A0CDU00@d1-sfbay-05.sun.com> (original mail from Ienup.Sung@Sun.COM) for PSARC@sac.sfbay.sun.com; Wed, 26 Jul 2006 16:17:23 -0700 (PDT) Received: from [192.168.1.93] ([129.150.23.141]) by d1-sfbay-05.sun.com (Sun Java System Messaging Server 6.2-4.02 (built Sep 9 2005)) with ESMTPSA id <0J3100CZUA0VLO20@d1-sfbay-05.sun.com> for PSARC@sac.sfbay.sun.com; Wed, 26 Jul 2006 16:17:23 -0700 (PDT) Date: Wed, 26 Jul 2006 16:15:30 -0700 From: Ienup Sung Subject: Re: UTF8_STRING support in Solaris libX11 and XLC modules [PSARC/2006/448 Timeout: 07/28/2006] In-reply-to: <200607220105.k6M15PeL026330@sparc-build.SFBay.Sun.COM> Sender: Ienup.Sung@Sun.COM To: PSARC@sac.sfbay.sun.com Cc: Federic.Zhang@Sun.COM, Gavin.Tu@Sun.COM Reply-to: Ienup.Sung@Sun.COM Message-id: <44C7F792.8060804@sun.com> Organization: Sun Microsystems, Inc. MIME-version: 1.0 Content-type: text/plain; format=flowed; charset=us-ascii Content-transfer-encoding: 7BIT X-Accept-Language: en-us, en References: <200607220105.k6M15PeL026330@sparc-build.SFBay.Sun.COM> User-Agent: Mozilla/5.0 (X11; U; SunOS sun4u; en-US; rv:1.7) Gecko/20041221 Status: RO Content-Length: 144 This case was approved in today's PSARC meeting. Approved spec and man page have been archived at the "materials" directory of the case. Ienup