All
Enclosed is the response to ACTION item 2002-5-05 which was an action to
complete XCU ERN 11. Thanks to Joanna for this.
This will be added to the agenda for the next teleconference
regards
Andrew
---------------------------------------------------------------
_____________________________________________________________________________
OBJECTION Enhancement Request Number 11
yyyyyyy@xxxxxxx Defect in XCU iconv (rdvk# 5)
{Sun-jf-kt4} Wed, 3 Apr 2002 14:48:30 +0100 (BST)
_____________________________________________________________________________
Accept_____ Accept as marked below_X___ Duplicate_____ Reject_____
Rationale for rejected or partial changes:
On Page: 503 Line: 19270-19305 Section: iconv
In the SYNOPSIS section
On line 19270 change from:
"iconv [-cs] -f fromcode -t tocode [file ...]"
to
"iconv [-cs] -f frommap -t tomap [file ...]
iconv -f fromcode [-cs] [-t tocode] [file ...]
iconv -t tocode [-cs] [-f fromcode] [file ...]"
In the DESCRIPTION section
On line 19283 change from:
"Omit any invalid characters from the output."
to
"Omit any characters that are invalid in the codeset of the input
file from the output."
On lines 19284-19285 in the -c option description change from:
"(either those that are not members of the fromcode or those that
have no corresponding value in tocode) shall"
to
"(either those that are not characters in the codeset of the input
file or that have no corresponding character in the codeset of the
output file) shall"
On lines 19288 to 19296 the -f fromcode option description change:
"-f fromcode
Identify the codeset of the input file. If the
option-argument contains a slash character, iconv shall
attempt to use it as the pathname of a charmap file, as
defined in the Base Definitions volume of IEEE Std
1003.1-2001, Section 6.4, Character Set Description File.
If the pathname does not represent a valid, readable
charmap file, the results are undefined. If the
option-argument does not contain a slash, it shall be
considered the name of one of the codeset descriptions
provided by the system, in an unspecified format. The
valid values of the option-argument without a slash are
implementation-defined. If this option is omitted, the
codeset of the current locale shall be used."
to
"-f fromcodeset
Identify the codeset of the input file. The implementation
shall recognize the following two forms of the fromcodeset
option-argument:
fromcode The fromcode option argument must not contain a
slash character. It shall be interpreted as
the name of one of the codeset descriptions
provided by the implementation in an
unspecified format. Valid values of fromcode
are implementation-defined.
frommap The frommap option argument must contain a
slash character. It shall be interpreted as
the pathname of a charmap file as defined in
the Base Definitions volume of IEEE Std
1003.1-2001, Section 6.4, Character Set
Description File. If the pathname does not
represent a valid, readable charmap file, the
results are undefined.
If this option is omitted, the codeset of the current locale
shall be used."
On lines 19301-19302 in the -s option description change:
"stream (either those that are not valid members of the fromcode or
those that have no corresponding value in tocode) shall be specified
in the system documentation."
to
"stream (either those that are not valid characters in the codeset
of the input file or that have no corresponding character in the
codeset of the output file) shall be specified in the system
documentation."
On lines 19304 to 19305 the -t fromcode option description change:
"-t tocode
Identify the codeset to be used for the output file. The
semantics shall be equivalent to the -f fromcode option."
to
"-t tocodeset
Identify the codeset to be used for the output file. The
implementation shall recognize the following two forms of the
tocodeset option-argument:
tocode The semantics shall be equivalent to the -f
fromcode option.
tomap The semantics shall be equivalent to the -f
tomap option.
If this option is omitted, the codeset of the current locale
shall be used."
Rationale:
Inconsistencies with the iconv() function.
_____________________________________________________________________________
Page: 503 Line: 19270 Section: iconv
Problem:
Defect code : 1. Error
Changes introduced to the iconv utility have introduced some
inconsistancies. Some are within the iconv utility description and
some are between the iconv utility and the iconv() system interface.
Inconsistancy 1:
The lines 19295, 19296, 19306, and 19307 indicate the -f or -t
options can be omitted. However, the SYNOPSIS of the iconv utility
at line 19270 does not say they are optional as follows:
iconv [-cs] -f fromcode -t tocode [file ...]
Inconsistancy 2:
There is a consistancy problem between the iconv utility's -c option
on lines 19283- 19287 and the iconv() system interface description
on page 587 of XSH lines 19306-19308. This inconsistancy is that
iconv() allows implementation-defined conversion on a valid character
that does not have an identical conversion in the target codeset while
the iconv utility description mandates that the situation of not
having an identical conversion makes the input character invalid and
so subject to be treated as an invalid character.
Action:
Inconsistancy 1:
Change the SYNOPSIS in line 19270 to
iconv [-cs] -f frommap -t tomap [file ...]
iconf [-cs] [-f fromcode] [-t tocode] [file ...]
Replace lines 19288 to 19296 with:
-f fromcode
Identify the codeset of the input file. If the option-argument
does not contain a slash, it shall be considered the name of one of
the codeset descriptions provided by thesystem, in an unspecified
format. The valid values of the option-argument without a slash are
implementation-defined. If this option is omitted, the codeset of the
current locale shall be used.
-f frommap
Identify the codeset of the input file. If the option-argument
contains a slash character, iconv shall attempt to use it as the
pathname of a charmap file, as defined in the Base Definitions
volume of IEEE Std 1003.1-2001, Section 6.4, Character Set Description
File. If the pathname does not represent a valid, readable charmap
file, the results are undefined.
After line 19305 add:
-t tomap
Identify the codeset to be used for the output file. The
semantics shall be equivalent to the -f frommap option.
Inconsistancy 2:
Change line 19285 to:
members of the fromcode/frommap or those of frommap that have no
corresponding value in tomap) shall
Add the following at the end of line 19287:
If the iconv utility encounters a character in the fromcode input
that is valid, but for which an identical character does not exist in the
tocode codeset, the iconv utility shall perform an
implementation-defined conversion on this character.
-----
Andrew Josey The Open Group
Austin Group Chair Apex Plaza,Forbury Road,
Email: yyyyyyy@xxxxxxxxxxxxx Reading,Berks.RG1 1AX,England
Tel: +44 118 9508311 ext 2250 Fax: +44 118 9500110
|