Defect report from : Joanna Farley , Sun Microsystems
(Please direct followup comments direct to yyyyyyyyyyyyyy@xxxxxxxxxxxxx)
@ page 503 line 19270 section iconv objection {Sun-jf-kt4}
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.
|