Issue 3904: ptc/00-01-08: Conflict 1.15.1 paragraph 2 - 1.19.2 paragraph 2 (java-rtf)
Source: Oracle (Dr. Harold Carr, Ph.D., nobody)
Nature: Uncategorized Issue
Severity: 
Summary: This is a IDL to Java issue.

ptc/00-01-08

	1.15.1 paragraph 2 states that the "string reason parameter
	... is concatenated to the id before calling the base
	UserException constructor."

	However, 1.19.2 paragraph 2 states that "no holder and helper
	classes are define for these exceptions," (i.e., Bounds, BadKind,
	InvalidName) ... they are mapped as normal user exceptions."

	Since a helper class is not generated it is impossible to to
	concatenate an id before calling the base UserException constructor in
	these cases.

	Therefore they are not mapped as normal user exceptions.  They
	are mapped as normal user exceptions EXCEPT that the additional "full"
	constructor does not concatenate an id before calling the base
	UserException constructor.
	
	The text and non-normative examples should be updated to make 
	this clear.

Resolution: see below
Revised Text: Rewrite the second paragraph of Section 19.2, to say
"No holder classes are defined for these exceptions, nor are they in the interface repository. However, so that users can treat
them as "normal exceptions" for programming purposes, they are otherwise mapped as normal user exceptions, including the
generation of helper classes."
Actions taken:
September 20, 2000: received issue
February 27, 2001: closed issue
Discussion: 
The Source Zip Files actually have Helpers for the exceptions in Section 19.2, and these Helpers are used in the
Source for the exceptions themselves, to do the concatenation as described in Section 15.1.
Resolution:
End of Annotations:=====
Date: Wed, 20 Sep 2000 08:53:09 -0700 (PDT)
Message-Id: <200009201553.IAA25884@shorter.eng.sun.com>
From: Harold Carr <harold.carr@eng.sun.com>
To: issues@omg.org, java-rtf@omg.org
Subject: ptc/00-01-08: Conflict 1.15.1 paragraph 2 - 1.19.2 paragraph
2
Content-Type: text
X-UIDL: Km~!!J9]!!#iEe9^L=!!

This is a IDL to Java issue.

ptc/00-01-08

	1.15.1 paragraph 2 states that the "string reason parameter
	... is concatenated to the id before calling the base
	UserException constructor."

	However, 1.19.2 paragraph 2 states that "no holder and helper
	classes are define for these exceptions," (i.e., Bounds,
	BadKind,
	InvalidName) ... they are mapped as normal user exceptions."

	Since a helper class is not generated it is impossible to to
	concatenate an id before calling the base UserException
	constructor in
	these cases.

	Therefore they are not mapped as normal user exceptions.  They
	are mapped as normal user exceptions EXCEPT that the
	additional "full"
	constructor does not concatenate an id before calling the base
	UserException constructor.
	
	The text and non-normative examples should be updated to make 
	this clear.


Date: Thu, 12 Oct 2000 12:48:37 -0400
From: Mary Leland <mleland@fpk.hp.com>
X-Mailer: Mozilla 4.75 [en] (Windows NT 5.0; U)
X-Accept-Language: en
MIME-Version: 1.0
To: harold.carr@sun.com, Java RTF <java-rtf@omg.org>
Subject: Issue 3904: ptc/00-01-08: Conflict 1.15.1 paragraph 2 -
1.19.2 paragraph 
 2
Content-Transfer-Encoding: 8bit
Content-Type: text/plain; charset=iso-8859-1
X-UIDL: A-p!!E]1e9I^Je9h7&!!

Harold & RTF Members,

Harold submitted this issue, which is:
        1.15.1 paragraph 2 states that the "string reason parameter
        ... is concatenated to the id before calling the base
        UserException constructor."

        However, 1.19.2 paragraph 2 states that "no holder and helper
        classes are define for these exceptions," (i.e., Bounds,
BadKind,
        InvalidName) ... they are mapped as normal user exceptions."

        Since a helper class is not generated it is impossible to
        concatenate an id before calling the base UserException
        constructor in these cases.

        Therefore they are not mapped as normal user exceptions.  They
        are mapped as normal user exceptions EXCEPT that the
        additional
        "full" constructor does not concatenate an id before calling
        the base UserException constructor.
        
        The text and non-normative examples should be updated to make 
        this clear.

However, the Source Zip Files actually have Helpers for the
exceptions in Section 19.2, and these Helpers are used in the
Source for the exceptions themselves, to do the concatenation
as described in Section 15.1.

So there are 2 possible ways to resolve this issue:

1. Keep the Helpers, and rewrite the second paragraph of Section 19.2,
   to say
     "No holder classes are defined for these exceptions, nor are they
     in the interface repository. However, so that users can treat
   them
     a s for programming purposes, they are otherwise
     mapped  as normal user exceptions, including the generation of
     helper classes."

2. Not have the Helper classes, and to take them out of the Source Zip
   and adjust the implementations of the exceptions themselves in the
   Source Zip, and to change the ending of the second paragraph of
   Section 19.2 to say
     "they are mapped as normal user exceptions EXCEPT that the
     additional "full" constructor does not concatenate an id
     before calling the base UserException constructor."

Thanks,
-- Mary