Re: P1788 Clauses 1 and 2
Michel
also Christian as this is your concern
P1788:
On 1 Dec 2012, at 22:51, Michel Hack wrote:
> 1.6: Wouldn't "Clause 7" be a little late to use "forward references"
> for details? Or am I misunderstanding the overall layout?
I see your point. The overall layout is that Chapter 1 gives material that applies to all flavors (unless said otherwise), and following chapters are for specific flavors. Chapter 2 is the set-based flavor. (Section numbers increase all through, ignoring chapters.)
See Table of Contents extract below. I put "7. Conformance requirements" as the last item of Ch 1. There is indeed normative material in Ch 1, and the amount will increase a little, as I see stuff in the set-based chapter that really applies to all flavors, either necessarily or with the agreement of the Kaucher group. So if this clause stays there, it will have both back and forward references.
Having all Conformance Requirements gathered in one place (or at least, pointers to them) is strongly recommended by OASIS (The Organization for the Advancement of Structured Information Standards). For readability I felt the end of Ch 1 is a good place to put it:
- Read Chapter 1 to get an overall view of the standard.
- Then be told "To conform, this is what you must do".
But if any standards veterans have reasons for it to be elsewhere, say so.
Meantime I've just deleted "forward" from the text Michel comments on.
John
> Chapter 1. Introduction
> 1. Overview
> 1.1. Scope
> 1.2. Purpose
> 1.3. Inclusions
> 1.4. Exclusions
> 1.5. Word usage
> 1.6. The meaning of conformance
> 1.7. Programming environment considerations
> 1.8. Language considerations
> 2. Ideas underlying the standard (informative)
> 2.1. Mathematical context
> 2.2. Specification Levels
> 2.3. The Fundamental Theorem
> 2.4. Operations
> 2.5. Decorations
> 3. Notation, abbreviations, definitions
> 3.1. Frequently used notation and abbreviations
> 3.2. Definitions
> 4. Structure of the standard in levels
> 4.1. Specification levels overview
> 5. Flavors
> 5.1. Flavors overview
> 5.2. Definition of common intervals and common evaluations
> 5.3. Relation of common evaluations to flavors
> 5.4. Flavors and the Fundamental Theorem
> 6. Decoration system
> 6.1. Decorations overview
> 6.2. Decoration definition and propagation
> 6.3. Recognizing common evaluation
> 7. Conformance requirements
>
> Chapter 2. Set-based Intervals
> ...