RE: [relax-ng] Re: Compact syntax div/a:documentation

[Michael Fitzgerald <mike@wyeast.net>]

I like

## annotation
div { ... }

a lot.

Mike
-----Original Message-----
From: James Clark [mailto:jjc@jclark.com]
Sent: Saturday, April 13, 2002 10:53 PM
To: RELAX NG Mailing List
Subject: Re: [relax-ng] Re: Compact syntax div/a:documentation


OK, so nobody seems to like the "#*" idea.

If we put ## in the grammar, then we don't need the empty [], so my example
would become:

## Inline elements
{

  ## Emphasis
  {
    em = ...
    strong = ...

  }

  ## Technical
  {
    code =...
    ...
  }

}

## Block elements
{

  p = ...

}

This looks much better, but nonetheless I think it's surprising that
removal of a ## line would make it not parse, so I think an explicit div
keyword would be better:

## Inline elements
div {

  ## Emphasis
  div {
    em = ...
    strong = ...

  }

  ## Technical
  div {
    code =...
    ...
  }

}

## Block elements
div {

  p = ...

}

I experimented with the div1/div2/... idea, but it didn't seem to me to
work very well: the div markers were too visually inconspicuous.

So at the moment I think the best solution is to use

  div { ... }

to represent a div.  This will be unsurprising to users, works OK with ##,
and doesn't require any strange hacks.

James


----------------------------------------------------------------
To subscribe or unsubscribe from this elist use the subscription
manager: <http://lists.oasis-open.org/ob/adm.pl>