(j3.2006) 007 formatting

Malcolm Cohen malcolm
Fri Mar 2 04:22:49 EST 2007

Van Snyder said:
> 1.  Do you want this, at least in the drafts?

Let's try it at least once.

> 2.  If you want it, do you want it centered in the footer, or on the
> interior edge (the page number goes on the outer edge)?

Interior edge, no question.

> 3.  Do you want (part of) the subclause title too?  This might be handy
> in Clause 13.  I could do it only for the intrinsic procedure names and
> not for anything else if that would be helpful.

Clause title would be ok.  Centred.
Some of our clause titles could be snappier.
(And some clauses could be split, e.g. c07.)

> 4.  What font do you want?  The same as the page number, or something
> smaller?  The same (sans serif) typeface, or something different?
> Roman?  Italic?

Same typeface as the text.

> 5.  How many levels do you want?  I think at least 3 in Clause 13.  How
> about in other clauses?

Consistent.  How about all the way?

> 6.  Do you want it in the Intro and/or Annexes A-D?

In the intro there are no subclauses, so that reduces to putting the
word "Introduction" or "Foreword" into the footer.
I've no objection to that.

> Although this might make it faster to find subclause references, it
> wouldn't help for constraint and note references.  Would you like to
> have those references of the form "See Note 4.37 on page 68?"  This

Not particularly.  People should use the PDF hotlinks.

I don't particularly like page number references within the body of
the standard.  Someone is sure to tell the editor to change the page
number of those for a start (when it's not even under the editor's control).

> would be easy to do for notes, because we have a macro that generates
> note references.  It would be a bit more work for constraint references
> because we don't have a macro that generates them (perhaps we should),
> but there are very few.

Maybe that's why we don't have a macro.

> Syntax terms are in the index, so I don't think we want to clutter the
> text with page number references for them, nor do I think we want to
> clutter constraints with page number references for syntax rule numbers,
> since most constraints appear near the rules to which they apply.


> Do you want a line under the page heading (it's trivial to add)?

No.  I don't think ISO do either.

........................Malcolm Cohen (malcolm at nag-j.co.jp), Nihon NAG, Tokyo.

More information about the J3 mailing list