More compatibility with GNU gettext in gettext(3c) [PSARC/2007/634 FastTrack timeout 11/09/2007]

[Don Cragun]

I am sponsoring this fast track for Kenjiro Tsuji.
It times out on Friday, November 9th.
New and updated man pages are in the case's materials directory.

This case seeks a patch binding so it will be possible to port this
work back into a Solaris 10 update although there are no plans to do so
at this time.  The updates provided here are fully backwards compatible
with version 0.0, so existing applications should not be adversly
affected by this update to version 1.0.

(For those of you who have been involved in recent cases moving stuff
from /usr/sfw into /usr/bin, this case is not related to those cases.
This case merely updates the version of GNU gettext() related functions
to match current technology.  Another related case will be filed soon;
there are two cases rather than one because this case delivers changes
into the ON consolidation while the other case will deliever changes
into the SFW consolidation.)

Template Version: @(#)sac_nextcase 1.64 07/13/07 SMI
This information is Copyright 2007 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
	 More compatibility with GNU gettext in gettext(3c)
    1.2. Name of Document Author/Supplier:
	 Author:  Kenjiro Tsuji
    1.3  Date of This Document:
	02 November, 2007

2. Project Summary
   2.1. Project Description

	The current Solaris libc supports the GNU gettext feature that
	was introduced by PSARC/2001/072 [1].  The version number of
	the supported GNU MO file format is 0.0.  The GNU gettext
	package has been updated to bump the MO version number up to
	1.0.  This project makes the GNU gettext feature in libc more
	compatible with the GNU gettext package by supporting version
	1.0 of the GNU MO file format.

	Patch release binding is requested.
	
3. Technical Description

	In addition to supporting version 1.0 of the GNU MO file format
	in the gettext(3c) family of functions in libc, the following
	items will be also updated:

	- Adding  __GNU_GETTEXT_SUPPORTED_REVISION() macro into
          /usr/include/libintl.h.

	  This macro is required to tell the GNU packages that the
	  Solaris runtime supports the GNU gettext feature.

	  A new manpage for libintl.h(3HEAD) will be created for this
	  change.
	  

	- Adding the following two symbols into libc:

	  _nl_msg_cat_cntr
	  _nl_domain_bindings

	  These symbols are also required to tell the GNU packages that
	  the Solaris runtime supports the GNU gettext feature.

	  The gettext(3C) manpage will be updated for this change.
	

	Enhancements to make the utilities in the GNU gettext package
	available on Solaris systems will be handled in a separate
	PSARC case.

4. Interfaces

    Exported interface			Classification	Interface type
    ===============================	==============	==============
    __GNU_GETTEXT_SUPPORTED_REVISION()	Uncommitted	macro in <libintl.h>

    _nl_msg_cat_cntr			Uncommitted	symbol in libc
    _nl_domain_bindings			Uncommitted	symbol in libc
    
5. References

	[1] Kenjiro Tsuji, PSARC/2001/072: GNU gettext support

6. Resources and Schedule
    6.4. Steering Committee requested information
   	6.4.1. Consolidation C-team Name:
		ON
    6.5. ARC review type: FastTrack
    6.6. ARC Exposure: open