Issue 5813: Excessive indentation due to the blocks used to delimit the package content                                                                                                                             (hutn-ftf)
Source: France Telecom R&D (Mr. Mariano Belaunde, mariano.belaunde@orange-ftgroup.com)
Nature: Uncategorized Issue
Severity: 
Summary: Issue : Excessive indentation due to the blocks used to delimit the package contents. 
According to the current draft, the top-level definitions of a package instance need to be put inside 
a block delimited by open and close brackets. This is not very user-friendly in the sense that it 
introduces excessive indentation that could be avoided. 
Suggestion for resolution: Use a one-line delimiter convention (such as 'package "xxxxxx";') meaning 
that all the above definitions until the next delimiter are part of the package content. Note that the same 
kind of notation is found in the Java language to declare packages. 
This delimiter convention may be optional or mandatory (to be discussed).
Resolution: see below
Revised Text: In Section 6.2, change production rule [2], replace

   [2] PackageInstance   := 3:PackageHeader '{' 4:PackageBody '}'

with

   [2] PackageInstance   := 3:PackageHeader
                            ( '{' 4:PackageBody '}'
                            | ';' 4:PackageBody )

__________________________________________________________________

In Section 6.2, in the paragraph following production rule [5], replace

   "Package instances are represented as simple block objects."

with

   "Package instances are represented either by a block structure, with the package contents appearing either between braces, or following a single line introduction followed by a semicolon."

and replace

   "Between a set of braces appear the"

with

   "The package body consists of the"

[Note: This change interacts with but does not conflict with the
proposed resolution for Issue 5876.]

Actions taken:
January 13, 2003: received issue
September 24, 2004: closed issue
Discussion: 

End of Annotations:=====
Subject: Issues for the HUTN FTF 
Date: Mon, 13 Jan 2003 16:54:49 +0100 
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
Thread-Topic: Issues for the HUTN FTF 
Thread-Index: AcK7HBpU397iUQ+WTOq/6odFTDzC5g== 
From: "BELAUNDE Mariano FTRD/DTL/LAN"
<mariano.belaunde@rd.francetelecom.com> 
To: "Juergen Boldt" <juergen@omg.org> 
Cc: <hutn-ftf@omg.org> 
X-OriginalArrivalTime: 13 Jan 2003 15:54:50.0281 (UTC)
FILETIME=[1ACB6190:01C2BB1C] 


Juergen, 

You will find below 9 issues for the HUTN FTF. 

Thanks in advance, 
Mariano 

-------------------------------- 


Issue : Excessive indentation due to the blocks used to delimit the
package contents. 
According to the current draft, the top-level definitions of a package
instance need to be put inside 
a block delimited by open and close brackets. This is not very
user-friendly in the sense that it 
introduces excessive indentation that could be avoided. 
Suggestion for resolution: Use a one-line delimiter convention (such
as 'package "xxxxxx";') meaning 
that all the above definitions until the next delimiter are part of
the package content. Note that the same 
kind of notation is found in the Java language to declare packages. 
This delimiter convention may be optional or mandatory (to be

Subject: proposed resolution for 5813 
From: Jim Steel <steel@dstc.edu.au> 
To: hutn-ftf@omg.org 
X-Mailer: Ximian Evolution 1.0.8 (1.0.8-11) 
Date: 17 Dec 2003 16:57:05 +1000 
X-Scanned-By: MIMEDefang 2.38 



In Section 6.2, change production rule [2], replace
   [2] PackageInstance   := 3:PackageHeader '{' 4:PackageBody '}'
with
   [2] PackageInstance   := 3:PackageHeader
                            ( '{' 4:PackageBody '}'
                            | ';' 4:PackageBody )


---


In Section 6.2, in the paragraph following production rule [5], replace
   "Package instances are represented as simple block objects."
with
   "Package instances are represented either by a block structure, with
the package contents appearing either between braces, or following a
single line introduction followed by a semicolon."


and replace
   "Between a set of braces appear the"
by
   "The package body consists of the"


[Note: This change interacts with but does not conflict with the
proposed resolution for Issue 5876.]





Jim.




-- 
----------------------------------------------------
Jim Steel                   Research Scientist, DSTC
steel@dstc.edu.au                Ph: +61 7 3365 4310


"Why write something in five days that you can spend
five years automating?"    - Terence Parr, ANTLR guy
discussed).