Clauses or Sections?
OpenStrat at aol.com
OpenStrat at aol.com
Mon Nov 16 13:05:13 PST 2009
It is a style thing related to common ECMA and ISO style guides. "Clause
14" is a correct reference to major heading "14", and references to
"sub-clauses" such as "14.1" are referenced directly without mention of "clause",
"section", "paragraph" "etc".
Section, such as "Section 1" is a division of the document higher than
Clause. For example "Section 1" may have one or more "clauses" such as
"clause 14" of "Section 2". The rules are spelled out in the ISO Style Guide and
the Ecma Style Guide. If in doubt, contact Patrick at
_patrick at ecma-international.org_ (mailto:patrick at ecma-international.org) who will be able to
give you specific guidance.
In a message dated 11/16/2009 3:47:37 P.M. Eastern Standard Time,
tshinnic at io.com writes:
At 01:35 PM 11/16/2009, Brendan Eich wrote:
On Nov 16, 2009, at 11:25 AM, Garrett Smith wrote:
The ES5 Specification mentions "clauses" in many places (e.g. "Clause
10."). This seems unclear. Is a "clause" the same thing as a
"section"? Why the double terminology?
I don't know -- I should have noticed these, since ES3 lacks such
solecisms. "Clause" occurs in ES3 only as part of CatchClause(s).
It's odd to use clause, which has a specific meaning in natural
language grammars, and a different but irrelevant meaning for legal
documents, to mean something as big as an ES5 section.
Allen no doubt knows the history. I hope this isn't an Ecma thing.
I'm sure it is, and the style is consistent with 'clause' ===
'chapter-level', e.g.
"The syntactic grammar for ECMAScript is given in clauses 11, 12, 13 and
14."
This bit of strangeness was mentioned by me back in January, saying
Sometimes there will be a bare "clause 7" or "See clause 14", but
elsewhere it will be stated "See 7.2" or "See clause 14.1"
Is it just custom not to say 'chapter' or 'section'? Or is it a
carry-over from some style guide?
: <examples> :
In fact, it seems the uses of 'section' outnumber those of 'clause'...
It does conflict a bit with needed terminology "case clause"
and by others since.
Gotta be a style thing, as in 'irritating' but thus not actionable?
--
I'm a pessimist about probabilities; I'm an optimist about possibilities.
Lewis Mumford (1895-1990)
_______________________________________________
es-discuss mailing list
es-discuss at mozilla.org
https://mail.mozilla.org/listinfo/es-discuss
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.mozilla.org/pipermail/es-discuss/attachments/20091116/b2dfed8d/attachment.html>
More information about the es-discuss
mailing list