ALF document review meeting, Nov.28, 1:30Pm - 3:00PM
per phone

Attendees:

Kim Nguyen	Tera
Alex Zamfirescu	ASC
Wolfgang	NEC

Document under review:
	http://www.eda.org/alf/homepage/ieee.1603.draft2.pdf

Notes reported here are for the purpose to edit the
document. All the rationales for particular notes are not
reported here.
Numbers at the left are line numbers in the document.

Chapter 5
---------
reported by Alex
General comment: We should consider using a formal symbolism
in the figures explaining the relationship between objects.

p.13
title: ALF Language construction principles.
8 .. syntax rules for all object descriptions.
11 .. consists of .. object definitions.
15 .. Type of object is defined by a keyword.
15 .. Section 3.2, 3.3 reference not up to date, make sure to refer also to user defined keywords
15 .. Section xxx describe various types ... and keywords to represent them.
18 .. eliminate "also called a name"
20 .. eliminate "if an object is not referenced ... need not be named"
21 .. optional value .. is defined by literal or expression ..
24 .. an object may contain
24 .. the containing object is refered to as parent object
25 .. eliminate "the children objects are .. inside curly braces"
29 .. replace this paragraph by "A declaration of an object must be known before a reference to the object is made"

35 .. find right reference
35 .. delete 2nd sentence

36 .. put pseudo BNF, re-write paragraph
      children objects, all enclosed
      object definitions

use ARBIRARY_OBJECT_TYPE instead of MY_OBJECT_TYPE
// put children objects here

p.14
15 .. objects in ALF are divided
20 .. fig 2 and 3 present the categories
23 .. can contain annotation ... (eliminate "such as")
42 .. clarify "all above"
45 .. paragraph does not describe all relationships

p.16
40 .. "almost" is wrong
47 .. figure 6 presents

p.17
referenceable not an english word
25 .. can contain an instantiation
28 .. arithmetic models can be contained within other arithmetic models
inconsistent use of UPPERCASE words

p.18
change title of 5.1.3.2
11 .. "permitted" instead of "legal"
15 .. standalone??? - reduce this explanation
19 .. replace "since" by "as"
30 .. The following scope rules shall apply to all library objects.
33 .. Rule 1: "before" and "after" means textual order
35 .. Rule 2: inside its parent object
38 .. Rule 3: eliminate "and the underlying levels of hierarchy"

p.19
3 .. eliminate "duplicate"
make the error more evident in the example
25 .. can be set, for example, to fF ...

chapter 6
---------
reported by Kim

p.21
table 3 random_literal is missing
reference to digit should be 6.2.3.2
22 .. white space should be whitespace.

p.23
write more about escape_character and its usage

p.29
update table 7

p.30
40 .. XXX is unknown reference

Chapter 8
---------
INCLUDE - new feature is missing

8.x
An xxx statement describes an object

8.5
needs clean up

8.7
ref to syntax 38 instead of 39